google-ads

curl + jq

• $GOOGLE_ADS_TOKEN

  — the user's OAuth bearer (

  adwords

  scope) →

  Authorization: Bearer $GOOGLE_ADS_TOKEN

• $GOOGLE_ADS_DEVELOPER_TOKEN

  — the platform's developer token (injected server-side) → header

  developer-token: $GOOGLE_ADS_DEVELOPER_TOKEN

• login-customer-id

  — the manager (MCC) id under which calls are made; use the target customer id, or

  $GOOGLE_ADS_LOGIN_CUSTOMER_ID

  if set (digits only, no dashes).

API version: the base is

https://googleads.googleapis.com/<vNN>

. Google ships a new

vNN

every ~4 months and retires old ones — set

VER

to the current supported version (check developers.google.com/google-ads/api release notes); the example uses

v18

.

$GOOGLE_ADS_DEVELOPER_TOKEN

VER="v18"; BASE="https://googleads.googleapis.com/$VER"
AUTH="Authorization: Bearer $GOOGLE_ADS_TOKEN"; DEV="developer-token: $GOOGLE_ADS_DEVELOPER_TOKEN"
# Customers the OAuth user can access (ids are returned as customers/<id>)
curl -sS -H "$AUTH" -H "$DEV" "$BASE/customers:listAccessibleCustomers" | jq '.resourceNames'

Report with GAQL (searchStream)

CID="1234567890"   # target customer id, digits only
curl -sS -H "$AUTH" -H "$DEV" -H "login-customer-id: ${GOOGLE_ADS_LOGIN_CUSTOMER_ID:-$CID}" \
  -H "Content-Type: application/json" -d '{
  "query":"SELECT campaign.name, metrics.cost_micros, metrics.clicks, metrics.conversions FROM campaign WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.cost_micros DESC"
}' "$BASE/customers/$CID/googleAds:searchStream" \
  | jq '.[].results[]? | {campaign: .campaign.name, cost_usd: (.metrics.costMicros|tonumber/1e6), clicks: .metrics.clicks, conv: .metrics.conversions}'

campaign

ad_group

ad_group_criterion

customer

metrics.cost_micros

Gotchas

• Three headers, not one. Missing

  developer-token

  or

  login-customer-id

  is the #1 cause of 401/403 here.
• Customer ids are digits only in URLs/headers (strip the dashes from

  123-456-7890

  ).

• searchStream

  returns an array of chunks each with

  .results[]

  — flatten with

  .[].results[]?

  .
• Cost is in micros of the account currency; divide by 1e6.