google-ads

Prerequisites

1. Connect Google Ads in Zero at Settings → Connectors → Google Ads.
2. Requests require both GOOGLE_ADS_TOKEN (OAuth access token) and GOOGLE_ADS_DEVELOPER_TOKEN (API developer token).
3. If using a manager (MCC) account, set GOOGLE_ADS_LOGIN_CUSTOMER_ID to the manager account ID.
4. All customer IDs should be in the format 1234567890 (no hyphens).
5. Google Data Manager requests require the Google Ads connector to have the https://www.googleapis.com/auth/datamanager OAuth scope.

Troubleshooting

If requests fail, run zero doctor check-connector --env-name GOOGLE_ADS_TOKEN or zero doctor check-connector --url https://googleads.googleapis.com/v24/customers/1234567890/googleAds:search --method POST

For Data Manager calls, use zero doctor check-connector --url https://datamanager.googleapis.com/v1/requestStatus:retrieve --method GET --env-name GOOGLE_ADS_TOKEN.

Authentication

Every request requires these headers: