late-sdk 0.0.860 → 0.0.862

data/openapi.yaml

@@ -8588,6 +8588,8 @@ components:
           properties:
             id: { type: string }
             name: { type: string }
+        cachedAt: { type: [string, "null"], format: date-time, description: "When this data was fetched from Google. Null when it was never served from cache." }
+        stale: { type: boolean, description: "True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read." }
     AdBudget:
       type: object
       description: Budget amount in the ad account's native currency (see the campaign's `currency` field for the code).
@@ -41328,9 +41330,11 @@ paths:
       description: |-
         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.
+        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.
       security:
         - bearerAuth: []
       parameters:
@@ -41371,6 +41375,8 @@ paths:
                     type: object
                     properties:
                       nextPageToken: { type: [string, "null"], description: "Null when the last page was returned." }
+                  cachedAt: { type: [string, "null"], format: date-time, description: "When this data was fetched from Google. Null when it was never served from cache." }
+                  stale: { type: boolean, description: "True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read." }
         '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '429': { description: "Google Ads operations budget exhausted; retry later." }
@@ -41386,8 +41392,10 @@ paths:
       description: >-
         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.
+        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.
       security:
         - bearerAuth: []
       parameters:
@@ -41408,6 +41416,8 @@ paths:
                   strategies:
                     type: array
                     items: { $ref: '#/components/schemas/PortfolioBidStrategy' }
+                  cachedAt: { type: [string, "null"], format: date-time, description: "When this data was fetched from Google. Null when it was never served from cache." }
+                  stale: { type: boolean, description: "True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read." }
         '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { $ref: '#/components/responses/NotFound' }
@@ -41996,9 +42006,12 @@ paths:
       x-platforms: ["google"]
       summary: Read a campaign's current bidding
       description: |
-        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.
+        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`
@@ -42179,9 +42192,11 @@ paths:
       summary: List campaign-level negative keywords
       description: |
         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.
+        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.
@@ -42206,6 +42221,8 @@ paths:
                         criterionId: { type: string }
                         text: { type: string }
                         matchType: { type: string, enum: [exact, phrase, broad] }
+                  cachedAt: { type: [string, "null"], format: date-time, description: "When this list was fetched from Google. Null when it was never served from cache." }
+                  stale: { type: boolean, description: "True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read." }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: Campaign not found }
         '429': { description: Google Ads operations budget exhausted; retry later }
@@ -42435,9 +42452,10 @@ paths:
       summary: Read a Google campaign's device, location, and language targeting
       description: |
         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.
+        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
@@ -42479,6 +42497,8 @@ paths:
                         code: { type: string, description: "Google's language code (ISO 639-1, plus variants such as `zh_CN`). Empty when the campaign's language_constant id is not in Zernio's checked-in table." }
                         id: { type: string, description: "Google's languageConstants/{id} numeric id." }
                         name: { type: string }
+                  cachedAt: { type: [string, "null"], format: date-time, description: "When this targeting was fetched from Google. Null when it was never served from cache." }
+                  stale: { type: boolean, description: "True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read." }
         '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
@@ -42506,6 +42526,10 @@ paths:
 
         `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.
       security:
         - bearerAuth: []
       parameters:
@@ -42566,6 +42590,29 @@ paths:
                 properties:
                   campaignId: { type: string }
                   updated: { type: array, items: { type: string, enum: [devices, locations, languages] }, description: "Which targeting fields were applied." }
+                  devices:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        device: { type: string, enum: [MOBILE, DESKTOP, TABLET, CONNECTED_TV] }
+                        included: { type: boolean }
+                        bidModifier: { type: [number, "null"], description: "Always null on this read; see GET's description." }
+                  locations:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        geoTargetId: { type: string, description: "Numeric id from Google's geoTargetConstants/{id}." }
+                        negative: { type: boolean, description: "true = excluded location." }
+                  languages:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        code: { type: string }
+                        id: { type: string }
+                        name: { type: string }
         '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
@@ -45194,7 +45241,11 @@ paths:
         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.
+        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.
       security:
         - bearerAuth: []
       parameters:
@@ -45217,11 +45268,14 @@ paths:
                         assetId: { type: string }
                         text: { type: string }
                         status: { type: string, description: "customer_asset.status, e.g. ENABLED, REMOVED, PAUSED." }
+                  cachedAt: { type: [string, "null"], format: date-time, description: "When this list was fetched from Google. Null when it was never served from cache." }
+                  stale: { type: boolean, description: "True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read." }
         '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Ads access required (Ads add-on on legacy plans, included on usage-based plans).
         '404': { $ref: '#/components/responses/NotFound' }
+        '429': { description: Google Ads operations budget exhausted; retry later }
         '501': { description: Only available on Google Ads accounts }
 
     post:
@@ -45424,6 +45478,8 @@ paths:
                         minimumDailyBudget: { type: number, description: "Meta only. Minimum daily budget for the account, in the account currency's major units. This is the impressions-billed minimum; other billing events have higher minimums. Absent when the connected token cannot read it." }
                         selectable: { type: boolean, description: "Meta and X only. Whether the account can create/run ads now. Absent (treat as true) on other platforms." }
                         unusableReason: { type: [string, "null"], description: "Meta and X only. Human-readable reason when selectable is false; null when selectable." }
+                  cachedAt: { type: [string, "null"], format: date-time, description: "Google only. When this list was fetched from Google. Null when it was never served from cache, or on other platforms." }
+                  stale: { type: boolean, description: "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." }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '422':
           description: Platform ads connection required (TikTok Ads, X Ads) or Instagram missing linked Facebook account
@@ -47737,19 +47793,18 @@ paths:
       x-platforms: ["meta", "linkedin"]
       summary: Search the public Ad Library
       description: |-
-        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).
+        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`. 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).
+        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.
@@ -47762,7 +47817,8 @@ paths:
       security:
         - bearerAuth: []
       parameters:
-        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches." }
+        - { name: platform, in: query, schema: { type: string, enum: [meta, linkedin] }, description: "Which archive to search. `meta` needs no accountId. Required unless accountId is given." }
+        - { name: accountId, in: query, schema: { type: string }, description: "Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform." }
         - { name: q, in: query, schema: { type: string, maxLength: 100 }, description: "Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given." }
         - { name: pageIds, in: query, schema: { type: string }, description: "Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list." }
         - { name: advertiser, in: query, schema: { type: string, maxLength: 100 }, description: "LinkedIn only. Advertiser (Page) name to search." }
@@ -47836,9 +47892,10 @@ paths:
         '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
-          description: "Ads access required (legacy plans need the Ads add-on), or, on Meta, `meta_identity_confirmation_required`: the Facebook user behind the connection has not confirmed identity and location at facebook.com/ID."
+          description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
         '404': { description: Account not found }
         '501': { description: Only supported on Meta and LinkedIn accounts }
+        '503': { description: "Meta's Ad Library is unavailable on Zernio's side (`PLATFORM_DISABLED`); LinkedIn searches are unaffected." }
 
   /v1/ads/targeting/reach-estimate:
     post:
@@ -48913,6 +48970,11 @@ paths:
         `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.
       security:
         - bearerAuth: []
       parameters:
@@ -48931,6 +48993,8 @@ paths:
                   actions:
                     type: array
                     items: { $ref: '#/components/schemas/ConversionAction' }
+                  cachedAt: { type: [string, "null"], format: date-time, description: "When this list was fetched from Google. Null when it was never served from cache." }
+                  stale: { type: boolean, description: "True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read." }
         '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
@@ -48947,8 +49011,9 @@ paths:
       description: |
         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.
+        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.
       security:
         - bearerAuth: []
       requestBody:

data/spec/api/ad_accounts_api_spec.rb

@@ -181,7 +181,7 @@ describe 'AdAccountsApi' do
 
   # unit tests for list_account_callouts
   # 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 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/spec/api/ad_campaigns_api_spec.rb

@@ -284,7 +284,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for get_campaign_bidding
   # 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 Numeric Google platform campaign id.
   # @param account_id Zernio Google Ads SocialAccount id: resolves the customer id + refresh token.
   # @param platform Required: campaign IDs are not globally unique. Only \"google\" is supported today.
@@ -299,7 +299,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for get_campaign_targeting
   # 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 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.
@@ -400,7 +400,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for list_bid_strategies
   # 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 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.
@@ -415,7 +415,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for list_campaign_negative_keywords
   # 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 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.
@@ -557,7 +557,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for update_campaign_targeting
   # 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 Google platform campaign ID
   # @param update_campaign_targeting_request 
   # @param [Hash] opts the optional parameters

data/spec/api/ad_insights_api_spec.rb

@@ -100,7 +100,7 @@ describe 'AdInsightsApi' do
 
   # unit tests for get_ads_search_terms
   # 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 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/spec/api/ad_library_api_spec.rb

@@ -34,9 +34,10 @@ describe 'AdLibraryApi' do
 
   # unit tests for search_ad_library
   # 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.
-  # @param account_id Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+  # 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.
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :platform Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+  # @option opts [String] :account_id Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
   # @option opts [String] :q Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
   # @option opts [String] :page_ids Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
   # @option opts [String] :advertiser LinkedIn only. Advertiser (Page) name to search.

data/spec/api/conversions_api_spec.rb

@@ -60,7 +60,7 @@ describe 'ConversionsApi' do
 
   # unit tests for create_conversion_action
   # 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. 
   # @param create_conversion_action_request 
   # @param [Hash] opts the optional parameters
   # @return [CreateConversionAction201Response]
@@ -143,7 +143,7 @@ describe 'ConversionsApi' do
 
   # unit tests for list_conversion_actions
   # 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. 
   # @param account_id SocialAccount _id (must be a googleads account).
   # @param [Hash] opts the optional parameters
   # @option opts [String] :customer_id Google Ads customer id (digits only). Resolved automatically when the connection has exactly one accessible customer.

data/spec/models/campaign_bidding_spec.rb

@@ -55,4 +55,16 @@ describe Zernio::CampaignBidding do
     end
   end
 
+  describe 'test attribute "cached_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "stale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/get_ads_search_terms200_response_spec.rb

@@ -45,4 +45,16 @@ describe Zernio::GetAdsSearchTerms200Response do
     end
   end
 
+  describe 'test attribute "cached_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "stale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/get_campaign_bidding200_response_spec.rb

@@ -55,6 +55,18 @@ describe Zernio::GetCampaignBidding200Response do
     end
   end
 
+  describe 'test attribute "cached_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "stale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "campaign_id"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/get_campaign_targeting200_response_spec.rb

@@ -45,4 +45,16 @@ describe Zernio::GetCampaignTargeting200Response do
     end
   end
 
+  describe 'test attribute "cached_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "stale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/list_account_callouts200_response_spec.rb

@@ -39,4 +39,16 @@ describe Zernio::ListAccountCallouts200Response do
     end
   end
 
+  describe 'test attribute "cached_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "stale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/list_ad_accounts200_response_spec.rb

@@ -33,4 +33,16 @@ describe Zernio::ListAdAccounts200Response do
     end
   end
 
+  describe 'test attribute "cached_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "stale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/list_bid_strategies200_response_spec.rb

@@ -45,4 +45,16 @@ describe Zernio::ListBidStrategies200Response do
     end
   end
 
+  describe 'test attribute "cached_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "stale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/list_campaign_negative_keywords200_response_spec.rb

@@ -33,4 +33,16 @@ describe Zernio::ListCampaignNegativeKeywords200Response do
     end
   end
 
+  describe 'test attribute "cached_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "stale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/list_conversion_actions200_response_spec.rb

@@ -39,4 +39,16 @@ describe Zernio::ListConversionActions200Response do
     end
   end
 
+  describe 'test attribute "cached_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "stale"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/update_campaign_targeting200_response_devices_inner_spec.rb

@@ -0,0 +1,52 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::UpdateCampaignTargeting200ResponseDevicesInner
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::UpdateCampaignTargeting200ResponseDevicesInner do
+  #let(:instance) { Zernio::UpdateCampaignTargeting200ResponseDevicesInner.new }
+
+  describe 'test an instance of UpdateCampaignTargeting200ResponseDevicesInner' do
+    it 'should create an instance of UpdateCampaignTargeting200ResponseDevicesInner' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::UpdateCampaignTargeting200ResponseDevicesInner)
+    end
+  end
+
+  describe 'test attribute "device"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["MOBILE", "DESKTOP", "TABLET", "CONNECTED_TV"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.device = value }.not_to raise_error
+      # end
+    end
+  end
+
+  describe 'test attribute "included"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "bid_modifier"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end