@zernio/node 0.2.545 → 0.2.547

package/dist/index.d.mts

@@ -1926,43 +1926,43 @@ type AdMetrics = {
      */
     roas?: number;
     /**
-     * Meta video ads only (0 for non-video ads and other platforms), like all video* fields below. Number of times the video started playing (Meta `video_play_actions`), summed over the date range and across children at ad-set/campaign level.
+     * Number of times the video started playing, summed over the date range and across children at ad-set/campaign level. 0 for non-video ads. Sources: Meta `video_play_actions`, TikTok `video_play_actions`.
      */
     videoPlayActions?: number;
     /**
-     * Views of at least 30 seconds (or to the end, for shorter videos). Meta `video_30_sec_watched_actions`.
+     * Views of at least 30 seconds (or to the end, for shorter videos). Sources: Meta `video_30_sec_watched_actions` (Meta only).
      */
     video30SecWatchedActions?: number;
     /**
-     * ThruPlays (watched to completion, or at least 15 seconds). Meta `video_thruplay_watched_actions`.
+     * ThruPlays (watched to completion, or at least 15 seconds). Sources: Meta `video_thruplay_watched_actions` (Meta only).
      */
     videoThruplayWatchedActions?: number;
     /**
-     * Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Meta `video_p25_watched_actions`.
+     * Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Sources: Meta `video_p25_watched_actions`, TikTok `video_views_p25`.
      */
     videoP25WatchedActions?: number;
     /**
-     * Views reaching 50% of the video's length. Meta `video_p50_watched_actions`.
+     * Views reaching 50% of the video's length. Sources: Meta `video_p50_watched_actions`, TikTok `video_views_p50`.
      */
     videoP50WatchedActions?: number;
     /**
-     * Views reaching 75% of the video's length. Meta `video_p75_watched_actions`.
+     * Views reaching 75% of the video's length. Sources: Meta `video_p75_watched_actions`, TikTok `video_views_p75`.
      */
     videoP75WatchedActions?: number;
     /**
-     * Views reaching 95% of the video's length. Meta `video_p95_watched_actions`.
+     * Views reaching 95% of the video's length. Sources: Meta `video_p95_watched_actions` (Meta only).
      */
     videoP95WatchedActions?: number;
     /**
-     * Views reaching 100% of the video's length. Meta `video_p100_watched_actions`.
+     * Views reaching 100% of the video's length. Sources: Meta `video_p100_watched_actions`, TikTok `video_views_p100`.
      */
     videoP100WatchedActions?: number;
     /**
-     * Average seconds watched per play (Meta `video_avg_time_watched_actions`). Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages.
+     * Average seconds watched per play. Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages. Sources: Meta `video_avg_time_watched_actions`, TikTok `average_video_play`.
      */
     videoAvgTimeWatchedActions?: number;
     /**
-     * Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays.
+     * Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays (ThruPlay is Meta-only).
      */
     costPerThruplay?: number;
     funnel?: AdFunnelCounts;
@@ -27234,10 +27234,25 @@ type UpdateAdData = {
             type?: 'daily' | 'lifetime';
         };
         /**
-         * Meta + TikTok only. Pinterest / X / LinkedIn / Google return 501.
+         * Meta + TikTok (demographics/interests) and Google (keyword edits only).
+         * Pinterest / X / LinkedIn return 501.
          *
          */
         targeting?: {
+            /**
+             * Google only. The FULL new set of positive keywords for the ad group; live keywords not listed are removed. Entries are strings (BROAD) or { text, matchType } with matchType exact | phrase | broad. Mirrored to GET /v1/ads/keywords immediately.
+             */
+            keywords?: Array<(string | {
+                text: string;
+                matchType?: 'exact' | 'phrase' | 'broad';
+            })>;
+            /**
+             * Google only. Same declarative contract as keywords, for the ad group's negative keywords.
+             */
+            negativeKeywords?: Array<(string | {
+                text: string;
+                matchType?: 'exact' | 'phrase' | 'broad';
+            })>;
             ageMin?: number;
             ageMax?: number;
             countries?: Array<(string)>;
@@ -29843,9 +29858,13 @@ type CreateStandaloneAdData = {
          */
         campaignType?: 'display' | 'search';
         /**
-         * Google Search only
+         * Google Search only. BROAD-match keywords on the new ad group (first 20).
          */
         keywords?: Array<(string)>;
+        /**
+         * Google Search only; other platforms return 400. BROAD-match negative keywords on the new ad group. Editable later via PUT /v1/ads/{adId} targeting.negativeKeywords.
+         */
+        negativeKeywords?: Array<(string)>;
         /**
          * Google Search RSA only. Extra headlines.
          */

package/dist/index.d.ts

@@ -1926,43 +1926,43 @@ type AdMetrics = {
      */
     roas?: number;
     /**
-     * Meta video ads only (0 for non-video ads and other platforms), like all video* fields below. Number of times the video started playing (Meta `video_play_actions`), summed over the date range and across children at ad-set/campaign level.
+     * Number of times the video started playing, summed over the date range and across children at ad-set/campaign level. 0 for non-video ads. Sources: Meta `video_play_actions`, TikTok `video_play_actions`.
      */
     videoPlayActions?: number;
     /**
-     * Views of at least 30 seconds (or to the end, for shorter videos). Meta `video_30_sec_watched_actions`.
+     * Views of at least 30 seconds (or to the end, for shorter videos). Sources: Meta `video_30_sec_watched_actions` (Meta only).
      */
     video30SecWatchedActions?: number;
     /**
-     * ThruPlays (watched to completion, or at least 15 seconds). Meta `video_thruplay_watched_actions`.
+     * ThruPlays (watched to completion, or at least 15 seconds). Sources: Meta `video_thruplay_watched_actions` (Meta only).
      */
     videoThruplayWatchedActions?: number;
     /**
-     * Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Meta `video_p25_watched_actions`.
+     * Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Sources: Meta `video_p25_watched_actions`, TikTok `video_views_p25`.
      */
     videoP25WatchedActions?: number;
     /**
-     * Views reaching 50% of the video's length. Meta `video_p50_watched_actions`.
+     * Views reaching 50% of the video's length. Sources: Meta `video_p50_watched_actions`, TikTok `video_views_p50`.
      */
     videoP50WatchedActions?: number;
     /**
-     * Views reaching 75% of the video's length. Meta `video_p75_watched_actions`.
+     * Views reaching 75% of the video's length. Sources: Meta `video_p75_watched_actions`, TikTok `video_views_p75`.
      */
     videoP75WatchedActions?: number;
     /**
-     * Views reaching 95% of the video's length. Meta `video_p95_watched_actions`.
+     * Views reaching 95% of the video's length. Sources: Meta `video_p95_watched_actions` (Meta only).
      */
     videoP95WatchedActions?: number;
     /**
-     * Views reaching 100% of the video's length. Meta `video_p100_watched_actions`.
+     * Views reaching 100% of the video's length. Sources: Meta `video_p100_watched_actions`, TikTok `video_views_p100`.
      */
     videoP100WatchedActions?: number;
     /**
-     * Average seconds watched per play (Meta `video_avg_time_watched_actions`). Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages.
+     * Average seconds watched per play. Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages. Sources: Meta `video_avg_time_watched_actions`, TikTok `average_video_play`.
      */
     videoAvgTimeWatchedActions?: number;
     /**
-     * Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays.
+     * Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays (ThruPlay is Meta-only).
      */
     costPerThruplay?: number;
     funnel?: AdFunnelCounts;
@@ -27234,10 +27234,25 @@ type UpdateAdData = {
             type?: 'daily' | 'lifetime';
         };
         /**
-         * Meta + TikTok only. Pinterest / X / LinkedIn / Google return 501.
+         * Meta + TikTok (demographics/interests) and Google (keyword edits only).
+         * Pinterest / X / LinkedIn return 501.
          *
          */
         targeting?: {
+            /**
+             * Google only. The FULL new set of positive keywords for the ad group; live keywords not listed are removed. Entries are strings (BROAD) or { text, matchType } with matchType exact | phrase | broad. Mirrored to GET /v1/ads/keywords immediately.
+             */
+            keywords?: Array<(string | {
+                text: string;
+                matchType?: 'exact' | 'phrase' | 'broad';
+            })>;
+            /**
+             * Google only. Same declarative contract as keywords, for the ad group's negative keywords.
+             */
+            negativeKeywords?: Array<(string | {
+                text: string;
+                matchType?: 'exact' | 'phrase' | 'broad';
+            })>;
             ageMin?: number;
             ageMax?: number;
             countries?: Array<(string)>;
@@ -29843,9 +29858,13 @@ type CreateStandaloneAdData = {
          */
         campaignType?: 'display' | 'search';
         /**
-         * Google Search only
+         * Google Search only. BROAD-match keywords on the new ad group (first 20).
          */
         keywords?: Array<(string)>;
+        /**
+         * Google Search only; other platforms return 400. BROAD-match negative keywords on the new ad group. Editable later via PUT /v1/ads/{adId} targeting.negativeKeywords.
+         */
+        negativeKeywords?: Array<(string)>;
         /**
          * Google Search RSA only. Extra headlines.
          */

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.545",
+  version: "0.2.547",
   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.545",
+  version: "0.2.547",
   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.545",
+  "version": "0.2.547",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -7333,7 +7333,12 @@ export const getAd = <ThrowOnError extends boolean = false>(options: OptionsLega
  * - **Meta** (Facebook + Instagram): all fields supported.
  * - **TikTok**: status, budget, targeting (via `/v2/adgroup/update/`), and creative
  * (via `/v2/ad/update/` patch-style — `headline` is ignored, `body` becomes `ad_text`).
- * - **Pinterest / X / LinkedIn / Google / OpenAI Ads**: status + budget only. Sending
+ * - **Google**: status, budget, and KEYWORD edits via `targeting.keywords` /
+ * `targeting.negativeKeywords` — each list you send becomes the FULL new set of its
+ * kind on the ad group (criteria not in the list are removed); a kind left out is
+ * untouched. Any other `targeting` field returns 400: Google cannot mutate broad
+ * targeting post-create without recreating the campaign. `creative` returns 501.
+ * - **Pinterest / X / LinkedIn / OpenAI Ads**: status + budget only. Sending
  * `targeting` or `creative` returns 501 with code `unsupported_platform_operation`.
  * OpenAI Ads budget is lifetime-only (see `budget.type` below).
  *

package/src/generated/types.gen.ts

@@ -675,43 +675,43 @@ export type AdMetrics = {
      */
     roas?: number;
     /**
-     * Meta video ads only (0 for non-video ads and other platforms), like all video* fields below. Number of times the video started playing (Meta `video_play_actions`), summed over the date range and across children at ad-set/campaign level.
+     * Number of times the video started playing, summed over the date range and across children at ad-set/campaign level. 0 for non-video ads. Sources: Meta `video_play_actions`, TikTok `video_play_actions`.
      */
     videoPlayActions?: number;
     /**
-     * Views of at least 30 seconds (or to the end, for shorter videos). Meta `video_30_sec_watched_actions`.
+     * Views of at least 30 seconds (or to the end, for shorter videos). Sources: Meta `video_30_sec_watched_actions` (Meta only).
      */
     video30SecWatchedActions?: number;
     /**
-     * ThruPlays (watched to completion, or at least 15 seconds). Meta `video_thruplay_watched_actions`.
+     * ThruPlays (watched to completion, or at least 15 seconds). Sources: Meta `video_thruplay_watched_actions` (Meta only).
      */
     videoThruplayWatchedActions?: number;
     /**
-     * Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Meta `video_p25_watched_actions`.
+     * Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Sources: Meta `video_p25_watched_actions`, TikTok `video_views_p25`.
      */
     videoP25WatchedActions?: number;
     /**
-     * Views reaching 50% of the video's length. Meta `video_p50_watched_actions`.
+     * Views reaching 50% of the video's length. Sources: Meta `video_p50_watched_actions`, TikTok `video_views_p50`.
      */
     videoP50WatchedActions?: number;
     /**
-     * Views reaching 75% of the video's length. Meta `video_p75_watched_actions`.
+     * Views reaching 75% of the video's length. Sources: Meta `video_p75_watched_actions`, TikTok `video_views_p75`.
      */
     videoP75WatchedActions?: number;
     /**
-     * Views reaching 95% of the video's length. Meta `video_p95_watched_actions`.
+     * Views reaching 95% of the video's length. Sources: Meta `video_p95_watched_actions` (Meta only).
      */
     videoP95WatchedActions?: number;
     /**
-     * Views reaching 100% of the video's length. Meta `video_p100_watched_actions`.
+     * Views reaching 100% of the video's length. Sources: Meta `video_p100_watched_actions`, TikTok `video_views_p100`.
      */
     videoP100WatchedActions?: number;
     /**
-     * Average seconds watched per play (Meta `video_avg_time_watched_actions`). Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages.
+     * Average seconds watched per play. Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages. Sources: Meta `video_avg_time_watched_actions`, TikTok `average_video_play`.
      */
     videoAvgTimeWatchedActions?: number;
     /**
-     * Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays.
+     * Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays (ThruPlay is Meta-only).
      */
     costPerThruplay?: number;
     funnel?: AdFunnelCounts;
@@ -27638,10 +27638,25 @@ export type UpdateAdData = {
             type?: 'daily' | 'lifetime';
         };
         /**
-         * Meta + TikTok only. Pinterest / X / LinkedIn / Google return 501.
+         * Meta + TikTok (demographics/interests) and Google (keyword edits only).
+         * Pinterest / X / LinkedIn return 501.
          *
          */
         targeting?: {
+            /**
+             * Google only. The FULL new set of positive keywords for the ad group; live keywords not listed are removed. Entries are strings (BROAD) or { text, matchType } with matchType exact | phrase | broad. Mirrored to GET /v1/ads/keywords immediately.
+             */
+            keywords?: Array<(string | {
+    text: string;
+    matchType?: 'exact' | 'phrase' | 'broad';
+})>;
+            /**
+             * Google only. Same declarative contract as keywords, for the ad group's negative keywords.
+             */
+            negativeKeywords?: Array<(string | {
+    text: string;
+    matchType?: 'exact' | 'phrase' | 'broad';
+})>;
             ageMin?: number;
             ageMax?: number;
             countries?: Array<(string)>;
@@ -30373,9 +30388,13 @@ export type CreateStandaloneAdData = {
          */
         campaignType?: 'display' | 'search';
         /**
-         * Google Search only
+         * Google Search only. BROAD-match keywords on the new ad group (first 20).
          */
         keywords?: Array<(string)>;
+        /**
+         * Google Search only; other platforms return 400. BROAD-match negative keywords on the new ad group. Editable later via PUT /v1/ads/{adId} targeting.negativeKeywords.
+         */
+        negativeKeywords?: Array<(string)>;
         /**
          * Google Search RSA only. Extra headlines.
          */