@zernio/node 0.2.719 → 0.2.720

package/dist/index.d.mts

@@ -3236,6 +3236,14 @@ type CampaignBidding = {
         id?: string;
         name?: string;
     } | null;
+    /**
+     * When this data was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 };
 /**
  * campaign.advertising_channel_type. COST_CAP's underlying Google field differs by channel; see bidStrategy on PUT.
@@ -30138,6 +30146,14 @@ type GetAdsSearchTermsResponse = ({
          */
         nextPageToken?: (string) | null;
     };
+    /**
+     * When this data was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type GetAdsSearchTermsError = (ErrorResponse | {
     error?: string;
@@ -30169,6 +30185,14 @@ type ListBidStrategiesResponse = ({
      */
     currency?: string;
     strategies?: Array<PortfolioBidStrategy>;
+    /**
+     * When this data was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type ListBidStrategiesError = (ErrorResponse | {
     error?: string;
@@ -30788,6 +30812,14 @@ type ListCampaignNegativeKeywordsResponse = ({
         text?: string;
         matchType?: 'exact' | 'phrase' | 'broad';
     }>;
+    /**
+     * When this list was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type ListCampaignNegativeKeywordsError = ({
     error?: string;
@@ -30953,6 +30985,14 @@ type GetCampaignTargetingResponse = ({
         id?: string;
         name?: string;
     }>;
+    /**
+     * When this targeting was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type GetCampaignTargetingError = (ErrorResponse | {
     error?: string;
@@ -31012,6 +31052,29 @@ type UpdateCampaignTargetingResponse = ({
      * Which targeting fields were applied.
      */
     updated?: Array<('devices' | 'locations' | 'languages')>;
+    devices?: Array<{
+        device?: 'MOBILE' | 'DESKTOP' | 'TABLET' | 'CONNECTED_TV';
+        included?: boolean;
+        /**
+         * Always null on this read; see GET's description.
+         */
+        bidModifier?: (number) | null;
+    }>;
+    locations?: Array<{
+        /**
+         * Numeric id from Google's geoTargetConstants/{id}.
+         */
+        geoTargetId?: string;
+        /**
+         * true = excluded location.
+         */
+        negative?: boolean;
+    }>;
+    languages?: Array<{
+        code?: string;
+        id?: string;
+        name?: string;
+    }>;
 });
 type UpdateCampaignTargetingError = (ErrorResponse | {
     error?: string;
@@ -33097,6 +33160,14 @@ type ListAccountCalloutsResponse = ({
          */
         status?: string;
     }>;
+    /**
+     * When this list was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type ListAccountCalloutsError = (ErrorResponse | {
     error?: string;
@@ -33276,6 +33347,14 @@ type ListAdAccountsResponse = ({
          */
         unusableReason?: (string) | null;
     }>;
+    /**
+     * Google only. When this list was fetched from Google. Null when it was never served from cache, or on other platforms.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * 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.
+     */
+    stale?: boolean;
 });
 type ListAdAccountsError = ({
     error?: string;
@@ -36316,6 +36395,14 @@ type ListConversionActionsResponse = ({
      */
     customerId?: string;
     actions?: Array<ConversionAction>;
+    /**
+     * When this list was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type ListConversionActionsError = (ErrorResponse | {
     error?: string;

package/dist/index.d.ts

@@ -3236,6 +3236,14 @@ type CampaignBidding = {
         id?: string;
         name?: string;
     } | null;
+    /**
+     * When this data was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 };
 /**
  * campaign.advertising_channel_type. COST_CAP's underlying Google field differs by channel; see bidStrategy on PUT.
@@ -30138,6 +30146,14 @@ type GetAdsSearchTermsResponse = ({
          */
         nextPageToken?: (string) | null;
     };
+    /**
+     * When this data was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type GetAdsSearchTermsError = (ErrorResponse | {
     error?: string;
@@ -30169,6 +30185,14 @@ type ListBidStrategiesResponse = ({
      */
     currency?: string;
     strategies?: Array<PortfolioBidStrategy>;
+    /**
+     * When this data was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type ListBidStrategiesError = (ErrorResponse | {
     error?: string;
@@ -30788,6 +30812,14 @@ type ListCampaignNegativeKeywordsResponse = ({
         text?: string;
         matchType?: 'exact' | 'phrase' | 'broad';
     }>;
+    /**
+     * When this list was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type ListCampaignNegativeKeywordsError = ({
     error?: string;
@@ -30953,6 +30985,14 @@ type GetCampaignTargetingResponse = ({
         id?: string;
         name?: string;
     }>;
+    /**
+     * When this targeting was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type GetCampaignTargetingError = (ErrorResponse | {
     error?: string;
@@ -31012,6 +31052,29 @@ type UpdateCampaignTargetingResponse = ({
      * Which targeting fields were applied.
      */
     updated?: Array<('devices' | 'locations' | 'languages')>;
+    devices?: Array<{
+        device?: 'MOBILE' | 'DESKTOP' | 'TABLET' | 'CONNECTED_TV';
+        included?: boolean;
+        /**
+         * Always null on this read; see GET's description.
+         */
+        bidModifier?: (number) | null;
+    }>;
+    locations?: Array<{
+        /**
+         * Numeric id from Google's geoTargetConstants/{id}.
+         */
+        geoTargetId?: string;
+        /**
+         * true = excluded location.
+         */
+        negative?: boolean;
+    }>;
+    languages?: Array<{
+        code?: string;
+        id?: string;
+        name?: string;
+    }>;
 });
 type UpdateCampaignTargetingError = (ErrorResponse | {
     error?: string;
@@ -33097,6 +33160,14 @@ type ListAccountCalloutsResponse = ({
          */
         status?: string;
     }>;
+    /**
+     * When this list was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type ListAccountCalloutsError = (ErrorResponse | {
     error?: string;
@@ -33276,6 +33347,14 @@ type ListAdAccountsResponse = ({
          */
         unusableReason?: (string) | null;
     }>;
+    /**
+     * Google only. When this list was fetched from Google. Null when it was never served from cache, or on other platforms.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * 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.
+     */
+    stale?: boolean;
 });
 type ListAdAccountsError = ({
     error?: string;
@@ -36316,6 +36395,14 @@ type ListConversionActionsResponse = ({
      */
     customerId?: string;
     actions?: Array<ConversionAction>;
+    /**
+     * When this list was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 type ListConversionActionsError = (ErrorResponse | {
     error?: string;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.719",
+  version: "0.2.720",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.719",
+  version: "0.2.720",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.719",
+  "version": "0.2.720",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -7765,9 +7765,11 @@ export const listAds = <ThrowOnError extends boolean = false>(options?: OptionsL
  * 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.
+ * 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.
  */
 export const getAdsSearchTerms = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdsSearchTermsData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetAdsSearchTermsResponse, GetAdsSearchTermsError, ThrowOnError>({
@@ -7778,7 +7780,7 @@ export const getAdsSearchTerms = <ThrowOnError extends boolean = false>(options:
 
 /**
  * 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.
  */
 export const listBidStrategies = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListBidStrategiesData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListBidStrategiesResponse, ListBidStrategiesError, ThrowOnError>({
@@ -7966,9 +7968,12 @@ export const updateAdCampaignStatus = <ThrowOnError extends boolean = false>(opt
 
 /**
  * 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.
+ * 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`
@@ -8045,9 +8050,11 @@ export const deleteAdCampaign = <ThrowOnError extends boolean = false>(options:
 /**
  * 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.
+ * 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.
@@ -8135,9 +8142,10 @@ export const duplicateAdCampaign = <ThrowOnError extends boolean = false>(option
 /**
  * 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.
+ * 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
@@ -8169,6 +8177,10 @@ export const getCampaignTargeting = <ThrowOnError extends boolean = false>(optio
  * `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.
+ *
  */
 export const updateCampaignTargeting = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateCampaignTargetingData, ThrowOnError>) => {
     return (options?.client ?? client).put<UpdateCampaignTargetingResponse, UpdateCampaignTargetingError, ThrowOnError>({
@@ -9111,7 +9123,11 @@ export const deleteValueRuleSet = <ThrowOnError extends boolean = false>(options
  * 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.
  */
 export const listAccountCallouts = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListAccountCalloutsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListAccountCalloutsResponse, ListAccountCalloutsError, ThrowOnError>({
@@ -9907,6 +9923,11 @@ export const adjustConversions = <ThrowOnError extends boolean = false>(options:
  * 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.
+ *
  */
 export const listConversionActions = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListConversionActionsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListConversionActionsResponse, ListConversionActionsError, ThrowOnError>({
@@ -9919,8 +9940,9 @@ export const listConversionActions = <ThrowOnError extends boolean = false>(opti
  * 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.
+ * 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.
  *
  */
 export const createConversionAction = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateConversionActionData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -1895,6 +1895,14 @@ export type CampaignBidding = {
         id?: string;
         name?: string;
     } | null;
+    /**
+     * When this data was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 };
 
 /**
@@ -30511,6 +30519,14 @@ export type GetAdsSearchTermsResponse = ({
          */
         nextPageToken?: (string) | null;
     };
+    /**
+     * When this data was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 
 export type GetAdsSearchTermsError = (ErrorResponse | {
@@ -30545,6 +30561,14 @@ export type ListBidStrategiesResponse = ({
      */
     currency?: string;
     strategies?: Array<PortfolioBidStrategy>;
+    /**
+     * When this data was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 
 export type ListBidStrategiesError = (ErrorResponse | {
@@ -31209,6 +31233,14 @@ export type ListCampaignNegativeKeywordsResponse = ({
         text?: string;
         matchType?: 'exact' | 'phrase' | 'broad';
     }>;
+    /**
+     * When this list was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 
 export type ListCampaignNegativeKeywordsError = ({
@@ -31386,6 +31418,14 @@ export type GetCampaignTargetingResponse = ({
         id?: string;
         name?: string;
     }>;
+    /**
+     * When this targeting was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 
 export type GetCampaignTargetingError = (ErrorResponse | {
@@ -31448,6 +31488,29 @@ export type UpdateCampaignTargetingResponse = ({
      * Which targeting fields were applied.
      */
     updated?: Array<('devices' | 'locations' | 'languages')>;
+    devices?: Array<{
+        device?: 'MOBILE' | 'DESKTOP' | 'TABLET' | 'CONNECTED_TV';
+        included?: boolean;
+        /**
+         * Always null on this read; see GET's description.
+         */
+        bidModifier?: (number) | null;
+    }>;
+    locations?: Array<{
+        /**
+         * Numeric id from Google's geoTargetConstants/{id}.
+         */
+        geoTargetId?: string;
+        /**
+         * true = excluded location.
+         */
+        negative?: boolean;
+    }>;
+    languages?: Array<{
+        code?: string;
+        id?: string;
+        name?: string;
+    }>;
 });
 
 export type UpdateCampaignTargetingError = (ErrorResponse | {
@@ -33683,6 +33746,14 @@ export type ListAccountCalloutsResponse = ({
          */
         status?: string;
     }>;
+    /**
+     * When this list was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 
 export type ListAccountCalloutsError = (ErrorResponse | {
@@ -33874,6 +33945,14 @@ export type ListAdAccountsResponse = ({
          */
         unusableReason?: (string) | null;
     }>;
+    /**
+     * Google only. When this list was fetched from Google. Null when it was never served from cache, or on other platforms.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * 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.
+     */
+    stale?: boolean;
 });
 
 export type ListAdAccountsError = ({
@@ -37022,6 +37101,14 @@ export type ListConversionActionsResponse = ({
      */
     customerId?: string;
     actions?: Array<ConversionAction>;
+    /**
+     * When this list was fetched from Google. Null when it was never served from cache.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.
+     */
+    stale?: boolean;
 });
 
 export type ListConversionActionsError = (ErrorResponse | {