late-sdk 0.0.860 → 0.0.862

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3bf724f0fb5ead7645ebf831326501354294abca15d4d4ec427e097c7682192
-  data.tar.gz: 46131c7c18dbcf4fda2e8128ffc8d2f1b2b8838531defe3d3a37ffebb71db250
+  metadata.gz: b90390dfb2a2cc7e6292ffb51014efc226ee983d0114067bbaa2fbb05313667f
+  data.tar.gz: 86b643311ebbb222f14e1e6671f9554cff1ad65877c1b33cf7f42b694610fd95
 SHA512:
-  metadata.gz: a9c651c1200d471ccf9cda0ca058d95a7e4e049fba9ca77d1fffdf7e4ec730b3cd03e65c4aca8758541602274189ae3bc3bfb1d398c20638a28de608e00330c2
-  data.tar.gz: a879dd6aa7f838fca9f0ae169d4d84f07332b4e530e1b943eec1dcbcbc7a903433b3fcd84fa7b1b739febb5d3c8d4b96d6f510e02f70585b0d79cec9d1719aad
+  metadata.gz: ff84101e591476cee89c04279eaf6189a1d19ecc6f66b9a17c4fd2c95fd95b859a1d881f742fba694ffeedfdee7018c482db365f63a767f4face12cfabd3cd72
+  data.tar.gz: 59b03ea9ace6a929747ad7733896071c7542d6b999f2a2df97221ae963573ddfe68400ce4c34dd34d30e86ffadcdda680b8bc2d1b6fa30d3898d5b5b0646d9ba

data/README.md

@@ -2214,6 +2214,8 @@ Class | Method | HTTP request | Description
  - [Zernio::UpdateBroadcastRequestTemplate](docs/UpdateBroadcastRequestTemplate.md)
  - [Zernio::UpdateBroadcastRequestTemplateVariableMappingValue](docs/UpdateBroadcastRequestTemplateVariableMappingValue.md)
  - [Zernio::UpdateCampaignTargeting200Response](docs/UpdateCampaignTargeting200Response.md)
+ - [Zernio::UpdateCampaignTargeting200ResponseDevicesInner](docs/UpdateCampaignTargeting200ResponseDevicesInner.md)
+ - [Zernio::UpdateCampaignTargeting200ResponseLanguagesInner](docs/UpdateCampaignTargeting200ResponseLanguagesInner.md)
  - [Zernio::UpdateCampaignTargetingRequest](docs/UpdateCampaignTargetingRequest.md)
  - [Zernio::UpdateCampaignTargetingRequestTargeting](docs/UpdateCampaignTargetingRequestTargeting.md)
  - [Zernio::UpdateCampaignTargetingRequestTargetingDevicesInner](docs/UpdateCampaignTargetingRequestTargetingDevicesInner.md)

data/docs/AdAccountsApi.md

@@ -828,7 +828,7 @@ end
 
 List account-level callout extensions
 
-Google Ads compliance row C.75: callout assets linked at the CUSTOMER level via `customer_asset` (not a campaign or ad group), so they serve fleet-wide across the account. Google only; every other platform returns 501. Draws on the shared Google Ads operations budget.
+Google Ads compliance row C.75: callout assets linked at the CUSTOMER level via `customer_asset` (not a campaign or ad group), so they serve fleet-wide across the account. Google only; every other platform returns 501. Cached for the quota window (10 minutes fresh, up to 7 days last-good), and gated by the shared Google Ads operations budget on a cache miss. 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
 

data/docs/AdCampaignsApi.md

@@ -1379,7 +1379,7 @@ end
 
 Read a campaign's current bidding
 
-Live read of the campaign's bidding strategy on Google, for pre-filling the bid strategy block before a PUT to /v1/ads/campaigns/{campaignId}. Google Ads only; `platform` is required and rejected when it is anything else, since a `campaignId` is not globally unique.  Maps Google's bidding strategy onto the same triplet PUT accepts: `LOWEST_COST_WITHOUT_CAP` (Maximize Conversions, no target), `COST_CAP` + `bidAmount` (Target CPA), `LOWEST_COST_WITH_MIN_ROAS` + `roasAverageFloor` (Target ROAS), `LOWEST_COST_WITH_BID_CAP` + `bidAmount` (Maximize Clicks with a CPC ceiling). A campaign on a portfolio strategy returns `portfolio` (id + name) and `bidSpec.portfolioBidStrategyId` instead of the triplet. Anything else (Manual CPC, Target Impression Share, ...) returns `bidSpec: null`; show `biddingStrategyType` as-is. 
+Read of the campaign's bidding strategy on Google, cached for the quota window, for pre-filling the bid strategy block before a PUT to /v1/ads/campaigns/{campaignId}. Google Ads only; `platform` is required and rejected when it is anything else, since a `campaignId` is not globally unique. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.  Maps Google's bidding strategy onto the same triplet PUT accepts: `LOWEST_COST_WITHOUT_CAP` (Maximize Conversions, no target), `COST_CAP` + `bidAmount` (Target CPA), `LOWEST_COST_WITH_MIN_ROAS` + `roasAverageFloor` (Target ROAS), `LOWEST_COST_WITH_BID_CAP` + `bidAmount` (Maximize Clicks with a CPC ceiling). A campaign on a portfolio strategy returns `portfolio` (id + name) and `bidSpec.portfolioBidStrategyId` instead of the triplet. Anything else (Manual CPC, Target Impression Share, ...) returns `bidSpec: null`; show `biddingStrategyType` as-is. 
 
 ### Examples
 
@@ -1456,7 +1456,7 @@ end
 
 Read a Google campaign's device, location, and language targeting
 
-Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the live campaign state so an integrator can build an editor around it. Google only; every other platform returns 501.  `devices` always lists all four device types with `included` reflecting Google's negative device criteria (a device absent from any negative criterion is included by default). This read has no bid-modifier source, so `bidModifier` is always `null` even for a device with one configured. 
+Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.  `devices` always lists all four device types with `included` reflecting Google's negative device criteria (a device absent from any negative criterion is included by default). This read has no bid-modifier source, so `bidModifier` is always `null` even for a device with one configured. 
 
 ### Examples
 
@@ -1893,7 +1893,7 @@ end
 
 List Google Ads portfolio bid strategies
 
-Bidding strategy report: type, status, campaign count, clicks, cost, cost per conversion, impressions, average CPC and conversions over the date range (default last 30 days). Reads Google's `bidding_strategy` resource live. Draws on the shared Google Ads operations budget.
+Bidding strategy report: type, status, campaign count, clicks, cost, cost per conversion, impressions, average CPC and conversions over the date range (default last 30 days). Reads Google's `bidding_strategy` resource, cached for the quota window. Draws on the shared Google Ads operations budget. 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
 
@@ -1970,7 +1970,7 @@ end
 
 List campaign-level negative keywords
 
-Returns the campaign-level negative keywords (`campaign_criterion.negative`), distinct from the ad-group-level negatives under `GET /v1/ads/keywords`. Read live from Google on every call (not synced to Postgres), and gated by the shared Google Ads operations budget like every other on-demand Google surface.  The platform is always discovered from the campaign itself; a non-Google campaign returns 501 rather than 404, whether or not `platform` was passed. 
+Returns the campaign-level negative keywords (`campaign_criterion.negative`), distinct from the ad-group-level negatives under `GET /v1/ads/keywords`. Cached for the quota window (not synced to Postgres), and gated by the shared Google Ads operations budget like every other on-demand Google surface. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.  The platform is always discovered from the campaign itself; a non-Google campaign returns 501 rather than 404, whether or not `platform` was passed. 
 
 ### Examples
 
@@ -2751,7 +2751,7 @@ end
 
 Edit a Google campaign's device, location, or language targeting
 
-Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400. 
+Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  The response includes the refreshed `devices`/`locations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving. 
 
 ### Examples
 

data/docs/AdInsightsApi.md

@@ -383,7 +383,7 @@ end
 
 Google Ads search terms report
 
-The actual search queries that triggered your ads, with matched-keyword status and spend metrics — the raw material for wasted-spend analysis and negative-keyword lists. Reads Google's `search_term_view` live; defaults to the last 30 days. Rows are ordered by cost, descending. Draws on the shared Google Ads operations budget.
+The actual search queries that triggered your ads, with matched-keyword status and spend metrics — the raw material for wasted-spend analysis and negative-keyword lists. Reads Google's `search_term_view`, cached for the quota window; defaults to the last 30 days. Rows are ordered by cost, descending. Draws on the shared Google Ads operations budget. 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
 

data/docs/AdLibraryApi.md

@@ -9,11 +9,11 @@ All URIs are relative to *https://zernio.com/api*
 
 ## search_ad_library
 
-> <SearchAdLibrary200Response> search_ad_library(account_id, opts)
+> <SearchAdLibrary200Response> search_ad_library(opts)
 
 Search the public Ad Library
 
-Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
+Competitor and market research over the public ad archives. Meta's Ad Library (`GET /ads_archive`) is searched with Zernio's own developer access, so `platform=meta` needs no connected account at all. LinkedIn's Ad Library (`GET /rest/adLibrary`) runs on a connected `linkedin` / `linkedinads` account, passed as `accountId`. Passing a Meta account as `accountId` also selects Meta. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. All customers share Zernio's Meta quota, so a `429` means back off for a minute.  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
 
 ### Examples
 
@@ -27,8 +27,9 @@ Zernio.configure do |config|
 end
 
 api_instance = Zernio::AdLibraryApi.new
-account_id = 'account_id_example' # String | Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
 opts = {
+  platform: 'meta', # String | Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+  account_id: 'account_id_example', # String | Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
   q: 'q_example', # String | Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
   page_ids: 'page_ids_example', # String | Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
   advertiser: 'advertiser_example', # String | LinkedIn only. Advertiser (Page) name to search.
@@ -48,7 +49,7 @@ opts = {
 
 begin
   # Search the public Ad Library
-  result = api_instance.search_ad_library(account_id, opts)
+  result = api_instance.search_ad_library(opts)
   p result
 rescue Zernio::ApiError => e
   puts "Error when calling AdLibraryApi->search_ad_library: #{e}"
@@ -59,12 +60,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SearchAdLibrary200Response>, Integer, Hash)> search_ad_library_with_http_info(account_id, opts)
+> <Array(<SearchAdLibrary200Response>, Integer, Hash)> search_ad_library_with_http_info(opts)
 
 ```ruby
 begin
   # Search the public Ad Library
-  data, status_code, headers = api_instance.search_ad_library_with_http_info(account_id, opts)
+  data, status_code, headers = api_instance.search_ad_library_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <SearchAdLibrary200Response>
@@ -77,7 +78,8 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches. |  |
+| **platform** | **String** | Which archive to search. &#x60;meta&#x60; needs no accountId. Required unless accountId is given. | [optional] |
+| **account_id** | **String** | Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform. | [optional] |
 | **q** | **String** | Keyword search. Meta does not translate it, so write it in the ads&#39; language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given. | [optional] |
 | **page_ids** | **String** | Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list. | [optional] |
 | **advertiser** | **String** | LinkedIn only. Advertiser (Page) name to search. | [optional] |

data/docs/CampaignBidding.md

@@ -8,6 +8,8 @@
 | **bidding_strategy_type** | **String** | Google's raw enum: MAXIMIZE_CONVERSIONS, TARGET_CPA, MAXIMIZE_CONVERSION_VALUE, TARGET_ROAS, TARGET_SPEND, MANUAL_CPC, TARGET_IMPRESSION_SHARE, or another Google adds later. | [optional] |
 | **bid_spec** | [**CampaignBiddingBidSpec**](CampaignBiddingBidSpec.md) |  | [optional] |
 | **portfolio** | [**CampaignBiddingPortfolio**](CampaignBiddingPortfolio.md) |  | [optional] |
+| **cached_at** | **Time** | When this data was fetched from Google. Null when it was never served from cache. | [optional] |
+| **stale** | **Boolean** | True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. | [optional] |
 
 ## Example
 
@@ -18,7 +20,9 @@ instance = Zernio::CampaignBidding.new(
   channel: null,
   bidding_strategy_type: null,
   bid_spec: null,
-  portfolio: null
+  portfolio: null,
+  cached_at: null,
+  stale: null
 )
 ```
 

data/docs/ConversionsApi.md

@@ -168,7 +168,7 @@ end
 
 Create a website conversion action
 
-Creates a `WEBPAGE` conversion action (category `DEFAULT`) and returns it with its tag snippets, read back after creation since Google never returns them on the create response itself. Google-only; other platforms return `501`. Requires the Ads add-on. 
+Creates a `WEBPAGE` conversion action (category `DEFAULT`) and returns it with its tag snippets, read back after creation since Google never returns them on the create response itself. Invalidates the cached list `GET` on this resource would otherwise keep serving. Google-only; other platforms return `501`. Requires the Ads add-on. 
 
 ### Examples
 
@@ -607,7 +607,7 @@ end
 
 List conversion actions and their tag snippets
 
-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). 
+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. 
 
 ### Examples
 

data/docs/GetAdsSearchTerms200Response.md

@@ -7,6 +7,8 @@
 | **customer_id** | **String** |  | [optional] |
 | **data** | [**Array<GetAdsSearchTerms200ResponseDataInner>**](GetAdsSearchTerms200ResponseDataInner.md) |  | [optional] |
 | **paging** | [**GetAdsSearchTerms200ResponsePaging**](GetAdsSearchTerms200ResponsePaging.md) |  | [optional] |
+| **cached_at** | **Time** | When this data was fetched from Google. Null when it was never served from cache. | [optional] |
+| **stale** | **Boolean** | True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. | [optional] |
 
 ## Example
 
@@ -16,7 +18,9 @@ require 'zernio-sdk'
 instance = Zernio::GetAdsSearchTerms200Response.new(
   customer_id: null,
   data: null,
-  paging: null
+  paging: null,
+  cached_at: null,
+  stale: null
 )
 ```
 

data/docs/GetCampaignBidding200Response.md

@@ -8,6 +8,8 @@
 | **bidding_strategy_type** | **String** | Google's raw enum: MAXIMIZE_CONVERSIONS, TARGET_CPA, MAXIMIZE_CONVERSION_VALUE, TARGET_ROAS, TARGET_SPEND, MANUAL_CPC, TARGET_IMPRESSION_SHARE, or another Google adds later. | [optional] |
 | **bid_spec** | [**CampaignBiddingBidSpec**](CampaignBiddingBidSpec.md) |  | [optional] |
 | **portfolio** | [**CampaignBiddingPortfolio**](CampaignBiddingPortfolio.md) |  | [optional] |
+| **cached_at** | **Time** | When this data was fetched from Google. Null when it was never served from cache. | [optional] |
+| **stale** | **Boolean** | True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. | [optional] |
 | **campaign_id** | **String** |  | [optional] |
 
 ## Example
@@ -20,6 +22,8 @@ instance = Zernio::GetCampaignBidding200Response.new(
   bidding_strategy_type: null,
   bid_spec: null,
   portfolio: null,
+  cached_at: null,
+  stale: null,
   campaign_id: null
 )
 ```

data/docs/GetCampaignTargeting200Response.md

@@ -7,6 +7,8 @@
 | **devices** | [**Array<GetCampaignTargeting200ResponseDevicesInner>**](GetCampaignTargeting200ResponseDevicesInner.md) |  | [optional] |
 | **locations** | [**Array<GetCampaignTargeting200ResponseLocationsInner>**](GetCampaignTargeting200ResponseLocationsInner.md) |  | [optional] |
 | **languages** | [**Array<GetCampaignTargeting200ResponseLanguagesInner>**](GetCampaignTargeting200ResponseLanguagesInner.md) |  | [optional] |
+| **cached_at** | **Time** | When this targeting was fetched from Google. Null when it was never served from cache. | [optional] |
+| **stale** | **Boolean** | True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. | [optional] |
 
 ## Example
 
@@ -16,7 +18,9 @@ require 'zernio-sdk'
 instance = Zernio::GetCampaignTargeting200Response.new(
   devices: null,
   locations: null,
-  languages: null
+  languages: null,
+  cached_at: null,
+  stale: null
 )
 ```
 

data/docs/ListAccountCallouts200Response.md

@@ -6,6 +6,8 @@
 | ---- | ---- | ----------- | ----- |
 | **customer_id** | **String** |  | [optional] |
 | **callouts** | [**Array<ListAccountCallouts200ResponseCalloutsInner>**](ListAccountCallouts200ResponseCalloutsInner.md) |  | [optional] |
+| **cached_at** | **Time** | When this list was fetched from Google. Null when it was never served from cache. | [optional] |
+| **stale** | **Boolean** | True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. | [optional] |
 
 ## Example
 
@@ -14,7 +16,9 @@ require 'zernio-sdk'
 
 instance = Zernio::ListAccountCallouts200Response.new(
   customer_id: null,
-  callouts: null
+  callouts: null,
+  cached_at: null,
+  stale: null
 )
 ```
 

data/docs/ListAdAccounts200Response.md

@@ -5,6 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **accounts** | [**Array<ListAdAccounts200ResponseAccountsInner>**](ListAdAccounts200ResponseAccountsInner.md) |  | [optional] |
+| **cached_at** | **Time** | Google only. When this list was fetched from Google. Null when it was never served from cache, or on other platforms. | [optional] |
+| **stale** | **Boolean** | Google only. True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. Absent on other platforms. | [optional] |
 
 ## Example
 
@@ -12,7 +14,9 @@
 require 'zernio-sdk'
 
 instance = Zernio::ListAdAccounts200Response.new(
-  accounts: null
+  accounts: null,
+  cached_at: null,
+  stale: null
 )
 ```
 

data/docs/ListBidStrategies200Response.md

@@ -7,6 +7,8 @@
 | **customer_id** | **String** |  | [optional] |
 | **currency** | **String** | Account currency code; money fields are in this currency's units. | [optional] |
 | **strategies** | [**Array<PortfolioBidStrategy>**](PortfolioBidStrategy.md) |  | [optional] |
+| **cached_at** | **Time** | When this data was fetched from Google. Null when it was never served from cache. | [optional] |
+| **stale** | **Boolean** | True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. | [optional] |
 
 ## Example
 
@@ -16,7 +18,9 @@ require 'zernio-sdk'
 instance = Zernio::ListBidStrategies200Response.new(
   customer_id: null,
   currency: null,
-  strategies: null
+  strategies: null,
+  cached_at: null,
+  stale: null
 )
 ```
 

data/docs/ListCampaignNegativeKeywords200Response.md

@@ -5,6 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **keywords** | [**Array<ListCampaignNegativeKeywords200ResponseKeywordsInner>**](ListCampaignNegativeKeywords200ResponseKeywordsInner.md) |  | [optional] |
+| **cached_at** | **Time** | When this list was fetched from Google. Null when it was never served from cache. | [optional] |
+| **stale** | **Boolean** | True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. | [optional] |
 
 ## Example
 
@@ -12,7 +14,9 @@
 require 'zernio-sdk'
 
 instance = Zernio::ListCampaignNegativeKeywords200Response.new(
-  keywords: null
+  keywords: null,
+  cached_at: null,
+  stale: null
 )
 ```
 

data/docs/ListConversionActions200Response.md

@@ -6,6 +6,8 @@
 | ---- | ---- | ----------- | ----- |
 | **customer_id** | **String** | The Google Ads customer id the actions were read from. | [optional] |
 | **actions** | [**Array<ConversionAction>**](ConversionAction.md) |  | [optional] |
+| **cached_at** | **Time** | When this list was fetched from Google. Null when it was never served from cache. | [optional] |
+| **stale** | **Boolean** | True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. | [optional] |
 
 ## Example
 
@@ -14,7 +16,9 @@ require 'zernio-sdk'
 
 instance = Zernio::ListConversionActions200Response.new(
   customer_id: null,
-  actions: null
+  actions: null,
+  cached_at: null,
+  stale: null
 )
 ```
 

data/docs/UpdateCampaignTargeting200Response.md

@@ -6,6 +6,9 @@
 | ---- | ---- | ----------- | ----- |
 | **campaign_id** | **String** |  | [optional] |
 | **updated** | **Array<String>** | Which targeting fields were applied. | [optional] |
+| **devices** | [**Array<UpdateCampaignTargeting200ResponseDevicesInner>**](UpdateCampaignTargeting200ResponseDevicesInner.md) |  | [optional] |
+| **locations** | [**Array<GetCampaignTargeting200ResponseLocationsInner>**](GetCampaignTargeting200ResponseLocationsInner.md) |  | [optional] |
+| **languages** | [**Array<UpdateCampaignTargeting200ResponseLanguagesInner>**](UpdateCampaignTargeting200ResponseLanguagesInner.md) |  | [optional] |
 
 ## Example
 
@@ -14,7 +17,10 @@ require 'zernio-sdk'
 
 instance = Zernio::UpdateCampaignTargeting200Response.new(
   campaign_id: null,
-  updated: null
+  updated: null,
+  devices: null,
+  locations: null,
+  languages: null
 )
 ```
 

data/docs/UpdateCampaignTargeting200ResponseDevicesInner.md

@@ -0,0 +1,22 @@
+# Zernio::UpdateCampaignTargeting200ResponseDevicesInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **device** | **String** |  | [optional] |
+| **included** | **Boolean** |  | [optional] |
+| **bid_modifier** | **Float** | Always null on this read; see GET's description. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UpdateCampaignTargeting200ResponseDevicesInner.new(
+  device: null,
+  included: null,
+  bid_modifier: null
+)
+```
+

data/docs/UpdateCampaignTargeting200ResponseLanguagesInner.md

@@ -0,0 +1,22 @@
+# Zernio::UpdateCampaignTargeting200ResponseLanguagesInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **code** | **String** |  | [optional] |
+| **id** | **String** |  | [optional] |
+| **name** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UpdateCampaignTargeting200ResponseLanguagesInner.new(
+  code: null,
+  id: null,
+  name: null
+)
+```
+

data/lib/zernio-sdk/api/ad_accounts_api.rb

@@ -829,7 +829,7 @@ module Zernio
     end
 
     # List account-level callout extensions
-    # Google Ads compliance row C.75: callout assets linked at the CUSTOMER level via `customer_asset` (not a campaign or ad group), so they serve fleet-wide across the account. Google only; every other platform returns 501. Draws on the shared Google Ads operations budget.
+    # Google Ads compliance row C.75: callout assets linked at the CUSTOMER level via `customer_asset` (not a campaign or ad group), so they serve fleet-wide across the account. Google only; every other platform returns 501. Cached for the quota window (10 minutes fresh, up to 7 days last-good), and gated by the shared Google Ads operations budget on a cache miss. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.
     # @param account_id [String] Google ads SocialAccount id.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :customer_id Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
@@ -840,7 +840,7 @@ module Zernio
     end
 
     # List account-level callout extensions
-    # Google Ads compliance row C.75: callout assets linked at the CUSTOMER level via `customer_asset` (not a campaign or ad group), so they serve fleet-wide across the account. Google only; every other platform returns 501. Draws on the shared Google Ads operations budget.
+    # Google Ads compliance row C.75: callout assets linked at the CUSTOMER level via `customer_asset` (not a campaign or ad group), so they serve fleet-wide across the account. Google only; every other platform returns 501. Cached for the quota window (10 minutes fresh, up to 7 days last-good), and gated by the shared Google Ads operations budget on a cache miss. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.
     # @param account_id [String] Google ads SocialAccount id.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :customer_id Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.

data/lib/zernio-sdk/api/ad_campaigns_api.rb

@@ -1397,7 +1397,7 @@ module Zernio
     end
 
     # Read a campaign's current bidding
-    # Live read of the campaign's bidding strategy on Google, for pre-filling the bid strategy block before a PUT to /v1/ads/campaigns/{campaignId}. Google Ads only; `platform` is required and rejected when it is anything else, since a `campaignId` is not globally unique.  Maps Google's bidding strategy onto the same triplet PUT accepts: `LOWEST_COST_WITHOUT_CAP` (Maximize Conversions, no target), `COST_CAP` + `bidAmount` (Target CPA), `LOWEST_COST_WITH_MIN_ROAS` + `roasAverageFloor` (Target ROAS), `LOWEST_COST_WITH_BID_CAP` + `bidAmount` (Maximize Clicks with a CPC ceiling). A campaign on a portfolio strategy returns `portfolio` (id + name) and `bidSpec.portfolioBidStrategyId` instead of the triplet. Anything else (Manual CPC, Target Impression Share, ...) returns `bidSpec: null`; show `biddingStrategyType` as-is. 
+    # Read of the campaign's bidding strategy on Google, cached for the quota window, for pre-filling the bid strategy block before a PUT to /v1/ads/campaigns/{campaignId}. Google Ads only; `platform` is required and rejected when it is anything else, since a `campaignId` is not globally unique. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.  Maps Google's bidding strategy onto the same triplet PUT accepts: `LOWEST_COST_WITHOUT_CAP` (Maximize Conversions, no target), `COST_CAP` + `bidAmount` (Target CPA), `LOWEST_COST_WITH_MIN_ROAS` + `roasAverageFloor` (Target ROAS), `LOWEST_COST_WITH_BID_CAP` + `bidAmount` (Maximize Clicks with a CPC ceiling). A campaign on a portfolio strategy returns `portfolio` (id + name) and `bidSpec.portfolioBidStrategyId` instead of the triplet. Anything else (Manual CPC, Target Impression Share, ...) returns `bidSpec: null`; show `biddingStrategyType` as-is. 
     # @param campaign_id [String] Numeric Google platform campaign id.
     # @param account_id [String] Zernio Google Ads SocialAccount id: resolves the customer id + refresh token.
     # @param platform [String] Required: campaign IDs are not globally unique. Only \"google\" is supported today.
@@ -1410,7 +1410,7 @@ module Zernio
     end
 
     # Read a campaign's current bidding
-    # Live read of the campaign's bidding strategy on Google, for pre-filling the bid strategy block before a PUT to /v1/ads/campaigns/{campaignId}. Google Ads only; `platform` is required and rejected when it is anything else, since a `campaignId` is not globally unique.  Maps Google's bidding strategy onto the same triplet PUT accepts: `LOWEST_COST_WITHOUT_CAP` (Maximize Conversions, no target), `COST_CAP` + `bidAmount` (Target CPA), `LOWEST_COST_WITH_MIN_ROAS` + `roasAverageFloor` (Target ROAS), `LOWEST_COST_WITH_BID_CAP` + `bidAmount` (Maximize Clicks with a CPC ceiling). A campaign on a portfolio strategy returns `portfolio` (id + name) and `bidSpec.portfolioBidStrategyId` instead of the triplet. Anything else (Manual CPC, Target Impression Share, ...) returns `bidSpec: null`; show `biddingStrategyType` as-is. 
+    # Read of the campaign's bidding strategy on Google, cached for the quota window, for pre-filling the bid strategy block before a PUT to /v1/ads/campaigns/{campaignId}. Google Ads only; `platform` is required and rejected when it is anything else, since a `campaignId` is not globally unique. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.  Maps Google's bidding strategy onto the same triplet PUT accepts: `LOWEST_COST_WITHOUT_CAP` (Maximize Conversions, no target), `COST_CAP` + `bidAmount` (Target CPA), `LOWEST_COST_WITH_MIN_ROAS` + `roasAverageFloor` (Target ROAS), `LOWEST_COST_WITH_BID_CAP` + `bidAmount` (Maximize Clicks with a CPC ceiling). A campaign on a portfolio strategy returns `portfolio` (id + name) and `bidSpec.portfolioBidStrategyId` instead of the triplet. Anything else (Manual CPC, Target Impression Share, ...) returns `bidSpec: null`; show `biddingStrategyType` as-is. 
     # @param campaign_id [String] Numeric Google platform campaign id.
     # @param account_id [String] Zernio Google Ads SocialAccount id: resolves the customer id + refresh token.
     # @param platform [String] Required: campaign IDs are not globally unique. Only \"google\" is supported today.
@@ -1482,7 +1482,7 @@ module Zernio
     end
 
     # Read a Google campaign's device, location, and language targeting
-    # Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the live campaign state so an integrator can build an editor around it. Google only; every other platform returns 501.  `devices` always lists all four device types with `included` reflecting Google's negative device criteria (a device absent from any negative criterion is included by default). This read has no bid-modifier source, so `bidModifier` is always `null` even for a device with one configured. 
+    # Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.  `devices` always lists all four device types with `included` reflecting Google's negative device criteria (a device absent from any negative criterion is included by default). This read has no bid-modifier source, so `bidModifier` is always `null` even for a device with one configured. 
     # @param campaign_id [String] Google platform campaign ID
     # @param [Hash] opts the optional parameters
     # @option opts [String] :platform Disambiguates when the same campaignId string exists on more than one connected platform.
@@ -1493,7 +1493,7 @@ module Zernio
     end
 
     # Read a Google campaign's device, location, and language targeting
-    # Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the live campaign state so an integrator can build an editor around it. Google only; every other platform returns 501.  `devices` always lists all four device types with `included` reflecting Google's negative device criteria (a device absent from any negative criterion is included by default). This read has no bid-modifier source, so `bidModifier` is always `null` even for a device with one configured. 
+    # Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.  `devices` always lists all four device types with `included` reflecting Google's negative device criteria (a device absent from any negative criterion is included by default). This read has no bid-modifier source, so `bidModifier` is always `null` even for a device with one configured. 
     # @param campaign_id [String] Google platform campaign ID
     # @param [Hash] opts the optional parameters
     # @option opts [String] :platform Disambiguates when the same campaignId string exists on more than one connected platform.
@@ -1984,7 +1984,7 @@ module Zernio
     end
 
     # List Google Ads portfolio bid strategies
-    # Bidding strategy report: type, status, campaign count, clicks, cost, cost per conversion, impressions, average CPC and conversions over the date range (default last 30 days). Reads Google's `bidding_strategy` resource live. Draws on the shared Google Ads operations budget.
+    # Bidding strategy report: type, status, campaign count, clicks, cost, cost per conversion, impressions, average CPC and conversions over the date range (default last 30 days). Reads Google's `bidding_strategy` resource, cached for the quota window. Draws on the shared Google Ads operations budget. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.
     # @param account_id [String] Google ads SocialAccount id.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :customer_id Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
@@ -1997,7 +1997,7 @@ module Zernio
     end
 
     # List Google Ads portfolio bid strategies
-    # Bidding strategy report: type, status, campaign count, clicks, cost, cost per conversion, impressions, average CPC and conversions over the date range (default last 30 days). Reads Google's `bidding_strategy` resource live. Draws on the shared Google Ads operations budget.
+    # Bidding strategy report: type, status, campaign count, clicks, cost, cost per conversion, impressions, average CPC and conversions over the date range (default last 30 days). Reads Google's `bidding_strategy` resource, cached for the quota window. Draws on the shared Google Ads operations budget. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.
     # @param account_id [String] Google ads SocialAccount id.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :customer_id Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
@@ -2057,7 +2057,7 @@ module Zernio
     end
 
     # List campaign-level negative keywords
-    # Returns the campaign-level negative keywords (`campaign_criterion.negative`), distinct from the ad-group-level negatives under `GET /v1/ads/keywords`. Read live from Google on every call (not synced to Postgres), and gated by the shared Google Ads operations budget like every other on-demand Google surface.  The platform is always discovered from the campaign itself; a non-Google campaign returns 501 rather than 404, whether or not `platform` was passed. 
+    # Returns the campaign-level negative keywords (`campaign_criterion.negative`), distinct from the ad-group-level negatives under `GET /v1/ads/keywords`. Cached for the quota window (not synced to Postgres), and gated by the shared Google Ads operations budget like every other on-demand Google surface. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.  The platform is always discovered from the campaign itself; a non-Google campaign returns 501 rather than 404, whether or not `platform` was passed. 
     # @param campaign_id [String] Platform campaign ID
     # @param [Hash] opts the optional parameters
     # @option opts [String] :platform Optional and NOT authoritative: the resolved campaign's own platform decides 200 vs 501, never this hint.
@@ -2068,7 +2068,7 @@ module Zernio
     end
 
     # List campaign-level negative keywords
-    # Returns the campaign-level negative keywords (`campaign_criterion.negative`), distinct from the ad-group-level negatives under `GET /v1/ads/keywords`. Read live from Google on every call (not synced to Postgres), and gated by the shared Google Ads operations budget like every other on-demand Google surface.  The platform is always discovered from the campaign itself; a non-Google campaign returns 501 rather than 404, whether or not `platform` was passed. 
+    # Returns the campaign-level negative keywords (`campaign_criterion.negative`), distinct from the ad-group-level negatives under `GET /v1/ads/keywords`. Cached for the quota window (not synced to Postgres), and gated by the shared Google Ads operations budget like every other on-demand Google surface. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.  The platform is always discovered from the campaign itself; a non-Google campaign returns 501 rather than 404, whether or not `platform` was passed. 
     # @param campaign_id [String] Platform campaign ID
     # @param [Hash] opts the optional parameters
     # @option opts [String] :platform Optional and NOT authoritative: the resolved campaign's own platform decides 200 vs 501, never this hint.
@@ -2856,7 +2856,7 @@ module Zernio
     end
 
     # Edit a Google campaign's device, location, or language targeting
-    # Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400. 
+    # Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  The response includes the refreshed `devices`/`locations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving. 
     # @param campaign_id [String] Google platform campaign ID
     # @param update_campaign_targeting_request [UpdateCampaignTargetingRequest] 
     # @param [Hash] opts the optional parameters
@@ -2867,7 +2867,7 @@ module Zernio
     end
 
     # Edit a Google campaign's device, location, or language targeting
-    # Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400. 
+    # Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  The response includes the refreshed `devices`/`locations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving. 
     # @param campaign_id [String] Google platform campaign ID
     # @param update_campaign_targeting_request [UpdateCampaignTargetingRequest] 
     # @param [Hash] opts the optional parameters

data/lib/zernio-sdk/api/ad_insights_api.rb

@@ -380,7 +380,7 @@ module Zernio
     end
 
     # Google Ads search terms report
-    # The actual search queries that triggered your ads, with matched-keyword status and spend metrics — the raw material for wasted-spend analysis and negative-keyword lists. Reads Google's `search_term_view` live; defaults to the last 30 days. Rows are ordered by cost, descending. Draws on the shared Google Ads operations budget.
+    # The actual search queries that triggered your ads, with matched-keyword status and spend metrics — the raw material for wasted-spend analysis and negative-keyword lists. Reads Google's `search_term_view`, cached for the quota window; defaults to the last 30 days. Rows are ordered by cost, descending. Draws on the shared Google Ads operations budget. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.
     # @param account_id [String] Google ads SocialAccount id.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :customer_id Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
@@ -396,7 +396,7 @@ module Zernio
     end
 
     # Google Ads search terms report
-    # The actual search queries that triggered your ads, with matched-keyword status and spend metrics — the raw material for wasted-spend analysis and negative-keyword lists. Reads Google's `search_term_view` live; defaults to the last 30 days. Rows are ordered by cost, descending. Draws on the shared Google Ads operations budget.
+    # The actual search queries that triggered your ads, with matched-keyword status and spend metrics — the raw material for wasted-spend analysis and negative-keyword lists. Reads Google's `search_term_view`, cached for the quota window; defaults to the last 30 days. Rows are ordered by cost, descending. Draws on the shared Google Ads operations budget. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.
     # @param account_id [String] Google ads SocialAccount id.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :customer_id Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.