zernio-sdk 0.0.1044 → 0.0.1045

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca1956b3c133457b6f7c520937f1c43cf46677a61babab69cbcaffcc1548e15f
-  data.tar.gz: e2001a1184434405d6669bfa193b8b69d5d207910725ad0f9e23f8a4e5012da2
+  metadata.gz: dd477e0ce78430cff3367469f718aeec96f478749effa80b8e6cdc11a7ae5629
+  data.tar.gz: a97755a9718a9bfe161462a5c4981806bdb610cf194d6b93fb1c57712a41e47d
 SHA512:
-  metadata.gz: 1f50e1fb1d751ae55a78df92842410874e39cf88314ad748470f5efb5b00cd20a64abaa6551be79c76d493c4e582fc6f8217a87432b2513c38e90fe10f6eb924
-  data.tar.gz: 6c76dde290d4c24b6886d651aaf3449a4e6f39ce2f22be7e4a5ded3b0543968031af1b9bcc6753ad03493978041fc0ef10269637ead518fe1b74a4c534823037
+  metadata.gz: aa191a9d7ca380c415098b34c6059f2682db9cdb806ca2f54cf8bd0ab5dcfc636ec3dd116e55c4caa192c41ff7b8eca6dd20c41a993fe38b8432695fc9e5fc08
+  data.tar.gz: 8000bd8dfa24c3b31ca3e4761e7f29faaec5d93fc56525b270b42be1f164cd4259e5ba4419d19ee4a511009c58f486e194c75b0982ce943596f4014cbb71a9de

data/docs/AdAccountsApi.md

@@ -707,6 +707,7 @@ api_instance = Zernio::AdAccountsApi.new
 list_id = 'list_id_example' # String | 
 account_id = 'account_id_example' # String | 
 opts = {
+  ad_account_id: 'ad_account_id_example', # String | 
   customer_id: 'customer_id_example', # String | 
   platform: 'facebook' # String | 
 }
@@ -744,6 +745,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **list_id** | **String** |  |  |
 | **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  | [optional] |
 | **customer_id** | **String** |  | [optional] |
 | **platform** | **String** |  | [optional] |
 
@@ -1007,6 +1009,7 @@ api_instance = Zernio::AdAccountsApi.new
 list_id = 'list_id_example' # String | 
 account_id = 'account_id_example' # String | 
 opts = {
+  ad_account_id: 'ad_account_id_example', # String | 
   customer_id: 'customer_id_example', # String | 
   platform: 'facebook' # String | 
 }
@@ -1044,6 +1047,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **list_id** | **String** |  |  |
 | **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  | [optional] |
 | **customer_id** | **String** |  | [optional] |
 | **platform** | **String** |  | [optional] |
 
@@ -1531,6 +1535,7 @@ end
 api_instance = Zernio::AdAccountsApi.new
 account_id = 'account_id_example' # String | 
 opts = {
+  ad_account_id: 'ad_account_id_example', # String | 
   customer_id: 'customer_id_example' # String | 
 }
 
@@ -1566,6 +1571,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  | [optional] |
 | **customer_id** | **String** |  | [optional] |
 
 ### Return type
@@ -1604,6 +1610,7 @@ end
 api_instance = Zernio::AdAccountsApi.new
 account_id = 'account_id_example' # String | 
 opts = {
+  ad_account_id: 'ad_account_id_example', # String | 
   customer_id: 'customer_id_example' # String | 
 }
 
@@ -1639,6 +1646,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  | [optional] |
 | **customer_id** | **String** |  | [optional] |
 
 ### Return type
@@ -1677,6 +1685,7 @@ end
 api_instance = Zernio::AdAccountsApi.new
 account_id = 'account_id_example' # String | 
 opts = {
+  ad_account_id: 'ad_account_id_example', # String | 
   customer_id: 'customer_id_example' # String | 
 }
 
@@ -1712,6 +1721,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  | [optional] |
 | **customer_id** | **String** |  | [optional] |
 
 ### Return type
@@ -1902,6 +1912,7 @@ end
 api_instance = Zernio::AdAccountsApi.new
 account_id = 'account_id_example' # String | 
 opts = {
+  ad_account_id: 'ad_account_id_example', # String | 
   customer_id: 'customer_id_example', # String | 
   platform: 'facebook' # String | 
 }
@@ -1938,6 +1949,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  | [optional] |
 | **customer_id** | **String** |  | [optional] |
 | **platform** | **String** |  | [optional] |
 
@@ -2571,7 +2583,8 @@ end
 api_instance = Zernio::AdAccountsApi.new
 account_id = 'account_id_example' # String | Zernio SocialAccount ID.
 opts = {
-  advertiser_id: 'advertiser_id_example', # String | Advertiser belonging to this connection.
+  ad_account_id: 'ad_account_id_example', # String | Platform ad account ID (TikTok advertiser id, digits only). Defaults to the first advertiser on the connection.
+  advertiser_id: 'advertiser_id_example', # String | Alias of adAccountId, kept for existing callers
   code: 'code_example' # String | Filter by a Pixel Code.
 }
 
@@ -2607,7 +2620,8 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio SocialAccount ID. |  |
-| **advertiser_id** | **String** | Advertiser belonging to this connection. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (TikTok advertiser id, digits only). Defaults to the first advertiser on the connection. | [optional] |
+| **advertiser_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **code** | **String** | Filter by a Pixel Code. | [optional] |
 
 ### Return type

data/docs/AdCampaignsApi.md

@@ -1637,7 +1637,8 @@ campaign_id = 'campaign_id_example' # String | Numeric Google platform campaign
 account_id = 'account_id_example' # String | Zernio Google Ads SocialAccount id: resolves the customer id + refresh token.
 platform = 'google' # String | Required: campaign IDs are not globally unique. Only \"google\" is supported today.
 opts = {
-  customer_id: 'customer_id_example' # String | Numeric Google Ads customer id (no dashes). Required when the connection has multiple Google Ads accounts; optional (and inferred) when it has only one.
+  ad_account_id: 'ad_account_id_example', # String | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple Google Ads accounts; optional (and inferred) when it has only one.
+  customer_id: 'customer_id_example' # String | Alias of adAccountId, kept for existing callers
 }
 
 begin
@@ -1674,7 +1675,8 @@ end
 | **campaign_id** | **String** | Numeric Google platform campaign id. |  |
 | **account_id** | **String** | Zernio Google Ads SocialAccount id: resolves the customer id + refresh token. |  |
 | **platform** | **String** | Required: campaign IDs are not globally unique. Only \"google\" is supported today. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Required when the connection has multiple Google Ads accounts; optional (and inferred) when it has only one. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple Google Ads accounts; optional (and inferred) when it has only one. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 
 ### Return type
 
@@ -1883,6 +1885,7 @@ api_instance = Zernio::AdCampaignsApi.new
 ad_set_id = 'ad_set_id_example' # String | Numeric Google platform id.
 account_id = 'account_id_example' # String | 
 opts = {
+  ad_account_id: 'ad_account_id_example', # String | 
   customer_id: 'customer_id_example' # String | 
 }
 
@@ -1919,6 +1922,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **ad_set_id** | **String** | Numeric Google platform id. |  |
 | **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  | [optional] |
 | **customer_id** | **String** |  | [optional] |
 
 ### Return type
@@ -2224,7 +2228,8 @@ end
 api_instance = Zernio::AdCampaignsApi.new
 account_id = 'account_id_example' # String | Google ads SocialAccount id.
 opts = {
-  customer_id: 'customer_id_example', # String | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+  ad_account_id: 'ad_account_id_example', # String | Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer.
+  customer_id: 'customer_id_example', # String | Alias of adAccountId, kept for existing callers
   from_date: Date.parse('2013-10-20'), # Date | Defaults to 30 days ago.
   to_date: Date.parse('2013-10-20') # Date | Defaults to today.
 }
@@ -2261,7 +2266,8 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Google ads SocialAccount id. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **from_date** | **Date** | Defaults to 30 days ago. | [optional] |
 | **to_date** | **Date** | Defaults to today. | [optional] |
 
@@ -2302,6 +2308,7 @@ api_instance = Zernio::AdCampaignsApi.new
 campaign_id = 'campaign_id_example' # String | Numeric Google platform id.
 account_id = 'account_id_example' # String | 
 opts = {
+  ad_account_id: 'ad_account_id_example', # String | 
   customer_id: 'customer_id_example' # String | 
 }
 
@@ -2338,6 +2345,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **campaign_id** | **String** | Numeric Google platform id. |  |
 | **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  | [optional] |
 | **customer_id** | **String** |  | [optional] |
 
 ### Return type

data/docs/AdInsightsApi.md

@@ -399,7 +399,8 @@ end
 api_instance = Zernio::AdInsightsApi.new
 account_id = 'account_id_example' # String | Google ads SocialAccount id.
 opts = {
-  customer_id: 'customer_id_example', # String | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+  ad_account_id: 'ad_account_id_example', # String | Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer.
+  customer_id: 'customer_id_example', # String | Alias of adAccountId, kept for existing callers
   from_date: Date.parse('2013-10-20'), # Date | Defaults to 30 days ago.
   to_date: Date.parse('2013-10-20'), # Date | Defaults to today.
   campaign_id: 'campaign_id_example', # String | Numeric Google campaign id filter.
@@ -440,7 +441,8 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Google ads SocialAccount id. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **from_date** | **Date** | Defaults to 30 days ago. | [optional] |
 | **to_date** | **Date** | Defaults to today. | [optional] |
 | **campaign_id** | **String** | Numeric Google campaign id filter. | [optional] |
@@ -564,7 +566,8 @@ api_instance = Zernio::AdInsightsApi.new
 lead_id = 'lead_id_example' # String | Numeric lead id from /v1/ads/local-services/leads.
 account_id = 'account_id_example' # String | Google ads SocialAccount id.
 opts = {
-  customer_id: 'customer_id_example', # String | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+  ad_account_id: 'ad_account_id_example', # String | Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer.
+  customer_id: 'customer_id_example', # String | Alias of adAccountId, kept for existing callers
   page_token: 'page_token_example' # String | Cursor from paging.nextPageToken of the previous page.
 }
 
@@ -601,7 +604,8 @@ end
 | ---- | ---- | ----------- | ----- |
 | **lead_id** | **String** | Numeric lead id from /v1/ads/local-services/leads. |  |
 | **account_id** | **String** | Google ads SocialAccount id. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **page_token** | **String** | Cursor from paging.nextPageToken of the previous page. | [optional] |
 
 ### Return type
@@ -640,7 +644,8 @@ end
 api_instance = Zernio::AdInsightsApi.new
 account_id = 'account_id_example' # String | Google ads SocialAccount id.
 opts = {
-  customer_id: 'customer_id_example', # String | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+  ad_account_id: 'ad_account_id_example', # String | Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer.
+  customer_id: 'customer_id_example', # String | Alias of adAccountId, kept for existing callers
   from_date: Date.parse('2013-10-20'), # Date | Leads created at/after this day.
   to_date: Date.parse('2013-10-20'), # Date | Leads created at/before this day.
   lead_type: 'PHONE_CALL', # String | 
@@ -681,7 +686,8 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Google ads SocialAccount id. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **from_date** | **Date** | Leads created at/after this day. | [optional] |
 | **to_date** | **Date** | Leads created at/before this day. | [optional] |
 | **lead_type** | **String** |  | [optional] |
@@ -709,7 +715,7 @@ end
 
 Flexible live insights query
 
-Live, flexible insights query. The account's platform picks the contract:  **Meta (facebook/instagram)**: forwards caller-chosen `fields`, `breakdowns` and `filtering` to any Meta insights node and returns Meta's rows verbatim. `objectId` (required) selects the node; `level` sets row granularity. Semantic validation is Meta's: an unknown field or invalid breakdown combination returns a 400 carrying Meta's message. For long ranges or agency-scale accounts prefer the async variant (POST /v1/ads/insights/reports).  **Google Ads (googleads)**: raw GAQL passthrough. Send any read-only GAQL SELECT via `query` (campaign/keyword/search-term/geo/demographic/asset/shopping resources, `change_event`, any `segments.*`) and rows come back verbatim (camelCase, counters as strings). Results are paged at a fixed 10,000 rows; follow `paging.nextPageToken` with `pageToken`. `customerId` is only needed when the connection has several Google Ads accounts. Semantic validation is Google's: an invalid query returns a 400 carrying Google's message (note: selecting `segments.date` requires a finite date filter). 
+Live, flexible insights query. The account's platform picks the contract:  **Meta (facebook/instagram)**: forwards caller-chosen `fields`, `breakdowns` and `filtering` to any Meta insights node and returns Meta's rows verbatim. `objectId` (required) selects the node; `level` sets row granularity. Semantic validation is Meta's: an unknown field or invalid breakdown combination returns a 400 carrying Meta's message. For long ranges or agency-scale accounts prefer the async variant (POST /v1/ads/insights/reports).  **Google Ads (googleads)**: raw GAQL passthrough. Send any read-only GAQL SELECT via `query` (campaign/keyword/search-term/geo/demographic/asset/shopping resources, `change_event`, any `segments.*`) and rows come back verbatim (camelCase, counters as strings). Results are paged at a fixed 10,000 rows; follow `paging.nextPageToken` with `pageToken`. `adAccountId` (alias `customerId`) is only needed when the connection has several Google Ads accounts. Semantic validation is Google's: an invalid query returns a 400 carrying Google's message (note: selecting `segments.date` requires a finite date filter). 
 
 ### Examples
 
@@ -727,7 +733,8 @@ account_id = 'account_id_example' # String | Zernio SocialAccount id (posting or
 opts = {
   object_id: 'object_id_example', # String | Meta only (required there): insights node (act_<n>, campaign id, ad set id or ad id).
   query: 'query_example', # String | Google only (required there): the GAQL SELECT statement to run.
-  customer_id: 'customer_id_example', # String | Google only: numeric customer id (no dashes) when the connection has several Google Ads accounts.
+  ad_account_id: 'ad_account_id_example', # String | Google only: platform ad account ID (Google customer ID, digits only) when the connection has several Google Ads accounts.
+  customer_id: 'customer_id_example', # String | Alias of adAccountId, kept for existing callers
   page_token: 'page_token_example', # String | Google only: cursor from paging.nextPageToken of the previous page.
   level: 'ad', # String | Row granularity
   fields: 'fields_example', # String | Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
@@ -779,7 +786,8 @@ end
 | **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform selects the Meta or Google contract. |  |
 | **object_id** | **String** | Meta only (required there): insights node (act_&lt;n&gt;, campaign id, ad set id or ad id). | [optional] |
 | **query** | **String** | Google only (required there): the GAQL SELECT statement to run. | [optional] |
-| **customer_id** | **String** | Google only: numeric customer id (no dashes) when the connection has several Google Ads accounts. | [optional] |
+| **ad_account_id** | **String** | Google only: platform ad account ID (Google customer ID, digits only) when the connection has several Google Ads accounts. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **page_token** | **String** | Google only: cursor from paging.nextPageToken of the previous page. | [optional] |
 | **level** | **String** | Row granularity | [optional] |
 | **fields** | **String** | Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted &#x3D; Meta&#39;s default set. | [optional] |

data/docs/AddAccountCalloutsRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio Google Ads connection id. |  |
-| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **callouts** | **Array<String>** |  |  |
 
 ## Example
@@ -15,6 +16,7 @@ require 'zernio-sdk'
 
 instance = Zernio::AddAccountCalloutsRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   callouts: null
 )

data/docs/AddAccountSitelinksRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio Google Ads connection id. |  |
-| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **sitelinks** | [**Array<GoogleSitelink>**](GoogleSitelink.md) |  |  |
 
 ## Example
@@ -15,6 +16,7 @@ require 'zernio-sdk'
 
 instance = Zernio::AddAccountSitelinksRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   sitelinks: null
 )

data/docs/AddAccountStructuredSnippetsRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio Google Ads connection id. |  |
-| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **structured_snippets** | [**Array<GoogleStructuredSnippet>**](GoogleStructuredSnippet.md) |  |  |
 
 ## Example
@@ -15,6 +16,7 @@ require 'zernio-sdk'
 
 instance = Zernio::AddAccountStructuredSnippetsRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   structured_snippets: null
 )

data/docs/AttachCampaignAssetsRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio Google Ads connection id. |  |
-| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **sitelinks** | [**Array<GoogleSitelink>**](GoogleSitelink.md) |  | [optional] |
 | **callouts** | **Array<String>** |  | [optional] |
 | **structured_snippets** | [**Array<GoogleStructuredSnippet>**](GoogleStructuredSnippet.md) |  | [optional] |
@@ -17,6 +18,7 @@ require 'zernio-sdk'
 
 instance = Zernio::AttachCampaignAssetsRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   sitelinks: null,
   callouts: null,

data/docs/ConversionsApi.md

@@ -607,7 +607,7 @@ end
 
 List conversion actions
 
-Lists Google Ads conversion actions on the resolved customer, all types by default. Each action's `tagSnippets` (global site tag + event snippet) is included when Google has them for that action's type, e.g. `WEBPAGE`. Google-only; other platforms return `501`. Requires the Ads add-on.  `customerId` is optional: when omitted, it is resolved from the connection's accessible Google Ads customers, and the call fails with `400` when more than one is accessible (pass `customerId` to disambiguate).  The list itself is cached for the quota window (1 hour fresh, up to 7 days last-good; the cache key does not vary on `type`). The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read. 
+Lists Google Ads conversion actions on the resolved customer, all types by default. Each action's `tagSnippets` (global site tag + event snippet) is included when Google has them for that action's type, e.g. `WEBPAGE`. Google-only; other platforms return `501`. Requires the Ads add-on.  `adAccountId` (alias `customerId`) is optional: when omitted, it is resolved from the connection's accessible Google Ads customers, and the call fails with `400` when more than one is accessible (pass `adAccountId` to disambiguate).  The list itself is cached for the quota window (1 hour fresh, up to 7 days last-good; the cache key does not vary on `type`). The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read. 
 
 ### Examples
 
@@ -623,7 +623,8 @@ end
 api_instance = Zernio::ConversionsApi.new
 account_id = 'account_id_example' # String | SocialAccount _id (must be a googleads account).
 opts = {
-  customer_id: 'customer_id_example', # String | Google Ads customer id (digits only). Resolved automatically when the connection has exactly one accessible customer.
+  ad_account_id: 'ad_account_id_example', # String | Platform ad account ID (Google customer ID, digits only). Resolved automatically when the connection has exactly one accessible customer.
+  customer_id: 'customer_id_example', # String | Alias of adAccountId, kept for existing callers
   type: 'type_example' # String | Filter by Google's ConversionActionType enum (e.g. WEBPAGE, UPLOAD_CLICKS).
 }
 
@@ -659,7 +660,8 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | SocialAccount _id (must be a googleads account). |  |
-| **customer_id** | **String** | Google Ads customer id (digits only). Resolved automatically when the connection has exactly one accessible customer. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Resolved automatically when the connection has exactly one accessible customer. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **type** | **String** | Filter by Google's ConversionActionType enum (e.g. WEBPAGE, UPLOAD_CLICKS). | [optional] |
 
 ### Return type

data/docs/CreateAdNegativeKeywordListRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio SocialAccount id. |  |
-| **customer_id** | **String** | Connected Google Ads customer id, without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **platform** | **String** | Optional courtesy field. The resolved account or campaign determines support; other platforms return 501. | [optional] |
 | **name** | **String** | Nonempty list name, trimmed before use. |  |
 | **keywords** | [**Array<KeywordEntry>**](KeywordEntry.md) | Full desired keyword set. Bare strings use broad match. Send [] to clear the list. | [optional] |
@@ -17,6 +18,7 @@ require 'zernio-sdk'
 
 instance = Zernio::CreateAdNegativeKeywordListRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   platform: null,
   name: null,

data/docs/CreateAdSetRequest.md

@@ -9,7 +9,8 @@
 | **campaign_id** | **String** | Google platform campaign ID (numeric) the ad group is created under. |  |
 | **name** | **String** |  |  |
 | **status** | **String** |  | [optional][default to 'PAUSED'] |
-| **customer_id** | **String** | Numeric Google Ads customer id. Only required when the connection has more than one. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Only required when the connection has more than one. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 
 ## Example
 
@@ -22,6 +23,7 @@ instance = Zernio::CreateAdSetRequest.new(
   campaign_id: null,
   name: null,
   status: null,
+  ad_account_id: null,
   customer_id: null
 )
 ```

data/docs/CreateBidStrategyRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Google ads SocialAccount id. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **name** | **String** |  |  |
 | **type** | **String** |  |  |
 | **target_cpa** | **Float** | Required when type is TARGET_CPA, in the account's currency units. | [optional] |
@@ -18,6 +19,7 @@ require 'zernio-sdk'
 
 instance = Zernio::CreateBidStrategyRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   name: null,
   type: null,

data/docs/CreateConversionActionRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | SocialAccount ID. Must be a `googleads` account. |  |
-| **customer_id** | **String** | Google Ads customer id (digits only). Resolved automatically when the connection has exactly one accessible customer. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Resolved automatically when the connection has exactly one accessible customer. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **name** | **String** |  |  |
 | **type** | **String** | Only WEBPAGE is supported for creation today. |  |
 | **default_value** | **Float** | Default conversion value used when an event doesn't carry its own value. | [optional] |
@@ -18,6 +19,7 @@ require 'zernio-sdk'
 
 instance = Zernio::CreateConversionActionRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   name: null,
   type: null,

data/docs/GenerateKeywordHistoricalMetricsRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio googleads SocialAccount id. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id (no dashes); only needed when the connection has several accounts. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **keywords** | **Array<String>** |  |  |
 | **countries** | **Array<String>** | ISO 3166-1 alpha-2 country codes. Omitted = worldwide. | [optional] |
 | **language_constant_id** | **String** | Google languageConstant id (1000 = English). | [optional][default to '1000'] |
@@ -20,6 +21,7 @@ require 'zernio-sdk'
 
 instance = Zernio::GenerateKeywordHistoricalMetricsRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   keywords: null,
   countries: null,

data/docs/GenerateKeywordIdeasRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio googleads SocialAccount id. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id (no dashes); only needed when the connection has several accounts. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **seed_keywords** | **Array<String>** | Seed terms. Provide these, seedUrl, or both. | [optional] |
 | **seed_url** | **String** | Landing page to mine for ideas. Provide this, seedKeywords, or both. | [optional] |
 | **countries** | **Array<String>** | ISO 3166-1 alpha-2 country codes. Omitted = worldwide. | [optional] |
@@ -22,6 +23,7 @@ require 'zernio-sdk'
 
 instance = Zernio::GenerateKeywordIdeasRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   seed_keywords: null,
   seed_url: null,

data/docs/RemoveAccountCalloutRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio Google Ads connection id. |  |
-| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **asset_id** | **String** |  |  |
 
 ## Example
@@ -15,6 +16,7 @@ require 'zernio-sdk'
 
 instance = Zernio::RemoveAccountCalloutRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   asset_id: null
 )

data/docs/RemoveAdGroupAssetsRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio Google Ads connection id. |  |
-| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **asset_resource_names** | **Array<String>** |  |  |
 | **ad_group_asset_resource_names** | **Array<String>** |  |  |
 
@@ -16,6 +17,7 @@ require 'zernio-sdk'
 
 instance = Zernio::RemoveAdGroupAssetsRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   asset_resource_names: null,
   ad_group_asset_resource_names: null

data/docs/RemoveCampaignAssetsRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio Google Ads connection id. |  |
-| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **asset_resource_names** | **Array<String>** |  |  |
 | **campaign_asset_resource_names** | **Array<String>** |  |  |
 
@@ -16,6 +17,7 @@ require 'zernio-sdk'
 
 instance = Zernio::RemoveCampaignAssetsRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   asset_resource_names: null,
   campaign_asset_resource_names: null

data/docs/ReplaceAdNegativeKeywordListKeywordsRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio SocialAccount id. |  |
-| **customer_id** | **String** | Connected Google Ads customer id, without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **platform** | **String** | Optional courtesy field. The resolved account or campaign determines support; other platforms return 501. | [optional] |
 | **keywords** | [**Array<KeywordEntry>**](KeywordEntry.md) | Full desired keyword set. Bare strings use broad match. Send [] to clear the list. |  |
 
@@ -16,6 +17,7 @@ require 'zernio-sdk'
 
 instance = Zernio::ReplaceAdNegativeKeywordListKeywordsRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   platform: null,
   keywords: null

data/docs/UpdateAccountCalloutsRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio Google Ads connection id. |  |
-| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **updates** | [**Array<UpdateAccountCalloutsRequestUpdatesInner>**](UpdateAccountCalloutsRequestUpdatesInner.md) |  |  |
 
 ## Example
@@ -15,6 +16,7 @@ require 'zernio-sdk'
 
 instance = Zernio::UpdateAccountCalloutsRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   updates: null
 )

data/docs/UpdateAccountSitelinksRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio Google Ads connection id. |  |
-| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **ad_account_id** | **String** | Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers. | [optional] |
+| **customer_id** | **String** | Alias of adAccountId, kept for existing callers | [optional] |
 | **updates** | [**Array<UpdateAccountSitelinksRequestUpdatesInner>**](UpdateAccountSitelinksRequestUpdatesInner.md) |  |  |
 
 ## Example
@@ -15,6 +16,7 @@ require 'zernio-sdk'
 
 instance = Zernio::UpdateAccountSitelinksRequest.new(
   account_id: null,
+  ad_account_id: null,
   customer_id: null,
   updates: null
 )