Limits and errors

Live Google Ads calls pass a per-user burst limit. Anything Google rejects comes back carrying Google's own error.

API version

Zernio calls Google Ads API v25, so GAQL resource and field names resolve against that version.

Zernio moves the version itself, and a migration needs no change on your side. The one field Google removed that older queries still use is translated for you, see legacy date fields.

Quotas and the ops budget

Every Google Ads API call across all Zernio customers runs on one developer token.

The token holds Standard access, so there is no daily operations cap to budget for. Two limits remain:

Both return 429 with code rate_limited and platform: "google".

On a Google quota 429, retrying before resetsAt cannot succeed. Keep calling other platforms, which are unaffected.

Cached reads. These reads are cached for 10 minutes:

• labels
• asset groups
• conversion goals
• recommendations
• the manager hierarchy
• negative keyword lists
• search terms

When Google's quota runs out, they fall back to the last successful copy with stale: true. Check cachedAt and stale before treating a read as live.

Rate limits covers Zernio's own request limits.

What you cannot do

Google's API, or Zernio's Google integration, does not expose:

• Shopping or Video campaigns through /v1/ads/create (Search, Display, Performance Max and Demand Gen only). Discovered campaigns of every type still sync into /ads/tree with metrics. A discovered Video campaign ad carries its YouTube video ids in creative.youtubeVideoIds, with the first video's YouTube thumbnail as creative.thumbnailUrl.
• Editing the cards of an existing Demand Gen carousel ad (create a new carousel ad instead).
• Deleting a Google asset: unlinking or removing detaches it, and the asset stays in the account library.
• A Responsive Display Ad with one image (Google requires landscape and square).
• GAQL writes: the passthrough is read-only SELECT.
• segments.date without a finite date filter (Google rejects it).
• Campaign-level negative keywords on GET /v1/ads/keywords (ad-group level only; read them from GET /v1/ads/campaigns/{campaignId}/negative-keywords or GAQL).
• Same-day keyword sync: the synced keyword list refreshes about once a day per customer.
• Phone-number matching on Customer Match (email only; phone is ignored).
• Instant conversions: Data Manager conversions take up to 3 hours to appear in reports.

Common errors

Google's own error is forwarded inside Zernio's platform_error envelope (error handling):

{
  "error": "Google rejected the ad: NOT_ENOUGH_SQUARE_MARKETING_IMAGE_ASSET",
  "type": "platform_error",
  "code": "platform_api_error",
  "platform": "google",
  "platformError": {
    "code": 3,
    "message": "Request contains an invalid argument.",
    "details": [ { "errors": [ { "errorCode": { "assetError": "NOT_ENOUGH_SQUARE_MARKETING_IMAGE_ASSET" }, "message": "Too few." } ] } ]
  }
}

Related

• Create ads: the media requirements and the create call each limit applies to.
• Insights and GAQL: the live reads the burst limit applies to.
• Error handling: the envelope every error uses.