@getlatedev/node 0.2.1113 → 0.2.1115

package/README.md

@@ -515,7 +515,7 @@ try {
 | `adCampaigns.getCampaignAdSchedule()` | Read a campaign's ad schedule (dayparting) |
 | `adCampaigns.getCampaignBidding()` | Read a campaign's current bidding |
 | `adCampaigns.getCampaignConversionGoals()` | Get campaign conversion goals |
-| `adCampaigns.getCampaignTargeting()` | Read a Google campaign's device, location, and language targeting |
+| `adCampaigns.getCampaignTargeting()` | Read a Google campaign's device, location, excluded location, and language targeting |
 | `adCampaigns.getGoogleAssetGroup()` | Get a Performance Max asset group |
 | `adCampaigns.updateAd()` | Update ad |
 | `adCampaigns.updateAdCampaign()` | Update a campaign |
@@ -529,7 +529,7 @@ try {
 | `adCampaigns.updateCampaignAdSchedule()` | Replace a campaign's ad schedule (dayparting) |
 | `adCampaigns.updateCampaignAssets()` | Update campaign assets |
 | `adCampaigns.updateCampaignConversionGoals()` | Update campaign conversion goals |
-| `adCampaigns.updateCampaignTargeting()` | Edit a Google campaign's device, location, or language targeting |
+| `adCampaigns.updateCampaignTargeting()` | Edit a Google campaign's device, location, excluded location, or language targeting |
 | `adCampaigns.updateGoogleAssetGroup()` | Update a Performance Max asset group |
 | `adCampaigns.deleteAd()` | Cancel an ad |
 | `adCampaigns.deleteAdCampaign()` | Delete a campaign |

package/dist/index.d.mts

@@ -12138,7 +12138,7 @@ type TargetingSpec = {
         address?: string;
     }>;
     /**
-     * Geo to exclude from the audience. Mirrors the inclusion geo shape: excluded cities can carry a radius catchment and excluded custom (lat/lng) pins are supported, both on Meta (excluded_geo_locations).
+     * Geo to exclude from the audience. Mirrors the inclusion geo shape: excluded cities can carry a radius catchment and excluded custom (lat/lng) pins are supported, both on Meta (excluded_geo_locations). Google (Search, Display, Performance Max) excludes countries, regions, cities and zips as negative location criteria; countryGroups, places, neighborhoods, customLocations and a city radius return 400 there, and Demand Gen returns 400 for any exclusion.
      */
     excludedLocations?: {
         countries?: Array<(string)>;
@@ -40452,6 +40452,27 @@ type GetCampaignTargetingResponse = ({
          */
         countryCode?: (string) | null;
     }>;
+    /**
+     * The negative (excluded) location criteria, same item shape as `locations` with `negative: true`.
+     */
+    excludedLocations?: Array<{
+        /**
+         * Numeric id from Google's geoTargetConstants/{id}.
+         */
+        geoTargetId?: string;
+        /**
+         * Always true here.
+         */
+        negative?: boolean;
+        name?: (string) | null;
+        canonicalName?: (string) | null;
+        type?: (string) | null;
+        countryCode?: (string) | null;
+    }>;
+    /**
+     * Whether PUT accepts `excludedLocations` for this campaign. False on Demand Gen, which returns 400 for any exclusion.
+     */
+    excludedLocationsEditable?: boolean;
     languages?: Array<{
         /**
          * 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.
@@ -40517,6 +40538,28 @@ type UpdateCampaignTargetingData = {
              * Google's language codes (ISO 639-1, plus variants such as `zh_CN`), e.g. ["en", "de"].
              */
             languages?: Array<(string)>;
+            /**
+             * Locations the campaign never serves in, as a bare country-code array or the nested countries/regions/cities/zips/metros shape. Replaces the excluded set; [] removes every exclusion.
+             */
+            excludedLocations?: (Array<(string)> | {
+                countries?: Array<(string)>;
+                regions?: Array<(string | {
+                    key: string;
+                    name?: string;
+                })>;
+                cities?: Array<(string | {
+                    key: string;
+                    name?: string;
+                })>;
+                zips?: Array<(string | {
+                    key: string;
+                    name?: string;
+                })>;
+                metros?: Array<(string | {
+                    key: string;
+                    name?: string;
+                })>;
+            });
             locationTargetingType?: GoogleLocationTargetingType;
         };
     };
@@ -40536,7 +40579,7 @@ type UpdateCampaignTargetingResponse = ({
     /**
      * Which targeting fields were applied.
      */
-    updated?: Array<('devices' | 'locations' | 'languages' | 'locationTargetingType')>;
+    updated?: Array<('devices' | 'locations' | 'excludedLocations' | 'languages' | 'locationTargetingType')>;
     /**
      * The value read back from Google after the edit.
      */
@@ -40575,6 +40618,17 @@ type UpdateCampaignTargetingResponse = ({
          */
         countryCode?: (string) | null;
     }>;
+    /**
+     * The negative (excluded) location criteria read back after the edit, same item shape as `locations`.
+     */
+    excludedLocations?: Array<{
+        geoTargetId?: string;
+        negative?: boolean;
+        name?: (string) | null;
+        canonicalName?: (string) | null;
+        type?: (string) | null;
+        countryCode?: (string) | null;
+    }>;
     languages?: Array<{
         code?: string;
         id?: string;
@@ -44810,15 +44864,15 @@ type GetAdAccountFinanceError = (unknown | ErrorResponse);
 type GetAdAccountLiveEntitiesData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the platform token.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Meta ad account id (act_<n>) or TikTok advertiser id (digits).
          */
         adAccountId: string;
         /**
-         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level`.
+         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level` (and on TikTok the same `limit`).
          */
         after?: string;
         /**
@@ -44833,6 +44887,7 @@ type GetAdAccountLiveEntitiesData = {
          * Comma-separated Meta `effective_status` values to keep: ACTIVE, PAUSED, IN_PROCESS,
          * WITH_ISSUES, DELETED, ARCHIVED, and CAMPAIGN_PAUSED (ad sets only; the campaigns level
          * ignores it). Defaults to every status except DELETED and ARCHIVED. An unknown value is a 400.
+         * TikTok takes a single value: ACTIVE, PAUSED or DELETED (see the description).
          */
         status?: string;
     };
@@ -44840,13 +44895,13 @@ type GetAdAccountLiveEntitiesData = {
 type GetAdAccountLiveEntitiesResponse = ({
     accountId?: string;
     adAccountId?: string;
-    platform?: 'facebook';
+    platform?: 'facebook' | 'tiktok';
     /**
      * ISO 4217 code every budget and bid amount is expressed in.
      */
     currency?: string;
     /**
-     * When Meta was read.
+     * When the platform was read.
      */
     readAt?: string;
     /**
@@ -44856,11 +44911,11 @@ type GetAdAccountLiveEntitiesResponse = ({
         platformCampaignId?: string;
         campaignName?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, WITH_ISSUES.
+         * Meta `effective_status` (ACTIVE, PAUSED, WITH_ISSUES...) or TikTok `secondary_status` (CAMPAIGN_STATUS_ENABLE...).
          */
         platformCampaignStatus?: (string) | null;
         /**
-         * Meta `status`: the campaign's own switch (ACTIVE, PAUSED, DELETED, ARCHIVED).
+         * The campaign's own switch: Meta `status` (ACTIVE, PAUSED, DELETED, ARCHIVED), or TikTok `operation_status` as ACTIVE (ENABLE) / PAUSED (DISABLE).
          */
         configuredStatus?: (string) | null;
         /**
@@ -44875,23 +44930,27 @@ type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency` (Meta `daily_budget`; TikTok `budget` under a daily budget mode).
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency` (Meta `lifetime_budget`; TikTok `budget` under BUDGET_MODE_TOTAL).
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it (BUDGET_MODE_DAY, BUDGET_MODE_DYNAMIC_DAILY_BUDGET, BUDGET_MODE_TOTAL, BUDGET_MODE_INFINITE).
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set.
+         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set, and always on TikTok.
          */
         spendCap?: (number) | null;
         /**
-         * Meta `bid_strategy`, set on campaigns with a campaign budget.
+         * Meta `bid_strategy`, set on campaigns with a campaign budget. Null on TikTok.
          */
         bidStrategy?: (string) | null;
     }>;
@@ -44903,11 +44962,11 @@ type GetAdAccountLiveEntitiesResponse = ({
         adSetName?: (string) | null;
         platformCampaignId?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, CAMPAIGN_PAUSED.
+         * Meta `effective_status` (ACTIVE, PAUSED, CAMPAIGN_PAUSED...) or TikTok `secondary_status` (ADGROUP_STATUS_DELIVERY_OK, ADGROUP_STATUS_AUDIT...).
          */
         platformAdSetStatus?: (string) | null;
         /**
-         * Meta `status`: the ad set's own switch.
+         * The ad set's own switch: Meta `status`, or TikTok `operation_status` as ACTIVE / PAUSED.
          */
         configuredStatus?: (string) | null;
         /**
@@ -44922,41 +44981,45 @@ type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency`.
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency`.
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it.
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Meta `bid_strategy`.
+         * Meta `bid_strategy`. On TikTok the ad group's `bid_type` normalized to the same vocabulary (LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, LOWEST_COST_WITH_MIN_ROAS).
          */
         bidStrategy?: (string) | null;
         /**
-         * Meta `bid_amount` (bid cap or cost target) in whole units of `currency`. Null when the strategy has none.
+         * Bid cap or cost target in whole units of `currency` (Meta `bid_amount`; TikTok `bid_price`, else `conversion_bid_price`, else `deep_cpa_bid`). Null when the strategy has none.
          */
         bidAmount?: (number) | null;
         /**
-         * Meta `optimization_goal`.
+         * Meta or TikTok `optimization_goal`.
          */
         optimizationGoal?: (string) | null;
         /**
-         * Meta `billing_event`.
+         * Meta or TikTok `billing_event`.
          */
         billingEvent?: (string) | null;
         /**
-         * Meta `promoted_object` verbatim (snake_case).
+         * Meta `promoted_object` verbatim (snake_case). On TikTok `{ pixelId, customEventType, applicationId, customConversionId }` from `pixel_id`, `optimization_event`, `app_id` and `custom_conversion_id`, only the keys TikTok has set; null when none is.
          */
         promotedObject?: {
             [key: string]: unknown;
         } | null;
         /**
-         * Meta `targeting` verbatim (snake_case), as Meta returns it now.
+         * The platform's targeting verbatim (snake_case), as it reports it now: Meta `targeting`, or TikTok's ad group targeting fields (location_ids, age_groups, gender, languages, interest_category_ids, audience_ids, placements...).
          */
         targeting?: {
             [key: string]: unknown;

package/dist/index.d.ts

@@ -12138,7 +12138,7 @@ type TargetingSpec = {
         address?: string;
     }>;
     /**
-     * Geo to exclude from the audience. Mirrors the inclusion geo shape: excluded cities can carry a radius catchment and excluded custom (lat/lng) pins are supported, both on Meta (excluded_geo_locations).
+     * Geo to exclude from the audience. Mirrors the inclusion geo shape: excluded cities can carry a radius catchment and excluded custom (lat/lng) pins are supported, both on Meta (excluded_geo_locations). Google (Search, Display, Performance Max) excludes countries, regions, cities and zips as negative location criteria; countryGroups, places, neighborhoods, customLocations and a city radius return 400 there, and Demand Gen returns 400 for any exclusion.
      */
     excludedLocations?: {
         countries?: Array<(string)>;
@@ -40452,6 +40452,27 @@ type GetCampaignTargetingResponse = ({
          */
         countryCode?: (string) | null;
     }>;
+    /**
+     * The negative (excluded) location criteria, same item shape as `locations` with `negative: true`.
+     */
+    excludedLocations?: Array<{
+        /**
+         * Numeric id from Google's geoTargetConstants/{id}.
+         */
+        geoTargetId?: string;
+        /**
+         * Always true here.
+         */
+        negative?: boolean;
+        name?: (string) | null;
+        canonicalName?: (string) | null;
+        type?: (string) | null;
+        countryCode?: (string) | null;
+    }>;
+    /**
+     * Whether PUT accepts `excludedLocations` for this campaign. False on Demand Gen, which returns 400 for any exclusion.
+     */
+    excludedLocationsEditable?: boolean;
     languages?: Array<{
         /**
          * 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.
@@ -40517,6 +40538,28 @@ type UpdateCampaignTargetingData = {
              * Google's language codes (ISO 639-1, plus variants such as `zh_CN`), e.g. ["en", "de"].
              */
             languages?: Array<(string)>;
+            /**
+             * Locations the campaign never serves in, as a bare country-code array or the nested countries/regions/cities/zips/metros shape. Replaces the excluded set; [] removes every exclusion.
+             */
+            excludedLocations?: (Array<(string)> | {
+                countries?: Array<(string)>;
+                regions?: Array<(string | {
+                    key: string;
+                    name?: string;
+                })>;
+                cities?: Array<(string | {
+                    key: string;
+                    name?: string;
+                })>;
+                zips?: Array<(string | {
+                    key: string;
+                    name?: string;
+                })>;
+                metros?: Array<(string | {
+                    key: string;
+                    name?: string;
+                })>;
+            });
             locationTargetingType?: GoogleLocationTargetingType;
         };
     };
@@ -40536,7 +40579,7 @@ type UpdateCampaignTargetingResponse = ({
     /**
      * Which targeting fields were applied.
      */
-    updated?: Array<('devices' | 'locations' | 'languages' | 'locationTargetingType')>;
+    updated?: Array<('devices' | 'locations' | 'excludedLocations' | 'languages' | 'locationTargetingType')>;
     /**
      * The value read back from Google after the edit.
      */
@@ -40575,6 +40618,17 @@ type UpdateCampaignTargetingResponse = ({
          */
         countryCode?: (string) | null;
     }>;
+    /**
+     * The negative (excluded) location criteria read back after the edit, same item shape as `locations`.
+     */
+    excludedLocations?: Array<{
+        geoTargetId?: string;
+        negative?: boolean;
+        name?: (string) | null;
+        canonicalName?: (string) | null;
+        type?: (string) | null;
+        countryCode?: (string) | null;
+    }>;
     languages?: Array<{
         code?: string;
         id?: string;
@@ -44810,15 +44864,15 @@ type GetAdAccountFinanceError = (unknown | ErrorResponse);
 type GetAdAccountLiveEntitiesData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the platform token.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Meta ad account id (act_<n>) or TikTok advertiser id (digits).
          */
         adAccountId: string;
         /**
-         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level`.
+         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level` (and on TikTok the same `limit`).
          */
         after?: string;
         /**
@@ -44833,6 +44887,7 @@ type GetAdAccountLiveEntitiesData = {
          * Comma-separated Meta `effective_status` values to keep: ACTIVE, PAUSED, IN_PROCESS,
          * WITH_ISSUES, DELETED, ARCHIVED, and CAMPAIGN_PAUSED (ad sets only; the campaigns level
          * ignores it). Defaults to every status except DELETED and ARCHIVED. An unknown value is a 400.
+         * TikTok takes a single value: ACTIVE, PAUSED or DELETED (see the description).
          */
         status?: string;
     };
@@ -44840,13 +44895,13 @@ type GetAdAccountLiveEntitiesData = {
 type GetAdAccountLiveEntitiesResponse = ({
     accountId?: string;
     adAccountId?: string;
-    platform?: 'facebook';
+    platform?: 'facebook' | 'tiktok';
     /**
      * ISO 4217 code every budget and bid amount is expressed in.
      */
     currency?: string;
     /**
-     * When Meta was read.
+     * When the platform was read.
      */
     readAt?: string;
     /**
@@ -44856,11 +44911,11 @@ type GetAdAccountLiveEntitiesResponse = ({
         platformCampaignId?: string;
         campaignName?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, WITH_ISSUES.
+         * Meta `effective_status` (ACTIVE, PAUSED, WITH_ISSUES...) or TikTok `secondary_status` (CAMPAIGN_STATUS_ENABLE...).
          */
         platformCampaignStatus?: (string) | null;
         /**
-         * Meta `status`: the campaign's own switch (ACTIVE, PAUSED, DELETED, ARCHIVED).
+         * The campaign's own switch: Meta `status` (ACTIVE, PAUSED, DELETED, ARCHIVED), or TikTok `operation_status` as ACTIVE (ENABLE) / PAUSED (DISABLE).
          */
         configuredStatus?: (string) | null;
         /**
@@ -44875,23 +44930,27 @@ type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency` (Meta `daily_budget`; TikTok `budget` under a daily budget mode).
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency` (Meta `lifetime_budget`; TikTok `budget` under BUDGET_MODE_TOTAL).
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it (BUDGET_MODE_DAY, BUDGET_MODE_DYNAMIC_DAILY_BUDGET, BUDGET_MODE_TOTAL, BUDGET_MODE_INFINITE).
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set.
+         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set, and always on TikTok.
          */
         spendCap?: (number) | null;
         /**
-         * Meta `bid_strategy`, set on campaigns with a campaign budget.
+         * Meta `bid_strategy`, set on campaigns with a campaign budget. Null on TikTok.
          */
         bidStrategy?: (string) | null;
     }>;
@@ -44903,11 +44962,11 @@ type GetAdAccountLiveEntitiesResponse = ({
         adSetName?: (string) | null;
         platformCampaignId?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, CAMPAIGN_PAUSED.
+         * Meta `effective_status` (ACTIVE, PAUSED, CAMPAIGN_PAUSED...) or TikTok `secondary_status` (ADGROUP_STATUS_DELIVERY_OK, ADGROUP_STATUS_AUDIT...).
          */
         platformAdSetStatus?: (string) | null;
         /**
-         * Meta `status`: the ad set's own switch.
+         * The ad set's own switch: Meta `status`, or TikTok `operation_status` as ACTIVE / PAUSED.
          */
         configuredStatus?: (string) | null;
         /**
@@ -44922,41 +44981,45 @@ type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency`.
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency`.
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it.
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Meta `bid_strategy`.
+         * Meta `bid_strategy`. On TikTok the ad group's `bid_type` normalized to the same vocabulary (LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, LOWEST_COST_WITH_MIN_ROAS).
          */
         bidStrategy?: (string) | null;
         /**
-         * Meta `bid_amount` (bid cap or cost target) in whole units of `currency`. Null when the strategy has none.
+         * Bid cap or cost target in whole units of `currency` (Meta `bid_amount`; TikTok `bid_price`, else `conversion_bid_price`, else `deep_cpa_bid`). Null when the strategy has none.
          */
         bidAmount?: (number) | null;
         /**
-         * Meta `optimization_goal`.
+         * Meta or TikTok `optimization_goal`.
          */
         optimizationGoal?: (string) | null;
         /**
-         * Meta `billing_event`.
+         * Meta or TikTok `billing_event`.
          */
         billingEvent?: (string) | null;
         /**
-         * Meta `promoted_object` verbatim (snake_case).
+         * Meta `promoted_object` verbatim (snake_case). On TikTok `{ pixelId, customEventType, applicationId, customConversionId }` from `pixel_id`, `optimization_event`, `app_id` and `custom_conversion_id`, only the keys TikTok has set; null when none is.
          */
         promotedObject?: {
             [key: string]: unknown;
         } | null;
         /**
-         * Meta `targeting` verbatim (snake_case), as Meta returns it now.
+         * The platform's targeting verbatim (snake_case), as it reports it now: Meta `targeting`, or TikTok's ad group targeting fields (location_ids, age_groups, gender, languages, interest_category_ids, audience_ids, placements...).
          */
         targeting?: {
             [key: string]: unknown;

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -9941,7 +9941,7 @@ export const duplicateAdCampaign = <ThrowOnError extends boolean = false>(option
 };
 
 /**
- * Read a Google campaign's device, location, and language targeting
+ * Read a Google campaign's device, location, excluded location, and language targeting
  * 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
@@ -9954,6 +9954,11 @@ export const duplicateAdCampaign = <ThrowOnError extends boolean = false>(option
  * for that device, `null` when it has none, and `0` when the device is
  * switched off; `included` is false for exactly that case.
  *
+ * `excludedLocations` lists the campaign's negative location criteria (the
+ * places it never serves in). `locations` still lists every location criterion,
+ * each flagged with `negative`, so a client reading the targeted set filters
+ * `negative: false`.
+ *
  */
 export const getCampaignTargeting = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetCampaignTargetingData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetCampaignTargetingResponse, GetCampaignTargetingError, ThrowOnError>({
@@ -9963,10 +9968,10 @@ export const getCampaignTargeting = <ThrowOnError extends boolean = false>(optio
 };
 
 /**
- * Edit a Google campaign's device, location, or language targeting
+ * Edit a Google campaign's device, location, excluded 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`, `locationTargetingType`; each provided field REPLACES that field's
+ * `locations`, `excludedLocations`, `languages`, `locationTargetingType`; 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.
@@ -9978,11 +9983,19 @@ export const getCampaignTargeting = <ThrowOnError extends boolean = false>(optio
  *
  * `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. An empty location list
+ * key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Excluded
+ * locations are left untouched by `locations`. An empty location list
  * returns 400 instead of removing every criterion: a Google campaign with no location
  * criteria targets every country, so omit `locations` to leave targeting alone.
  *
+ * `excludedLocations` takes the same two shapes and replaces the campaign's negative
+ * location criteria (the places it never serves in), leaving the targeted `locations`
+ * untouched. An empty list (or `{}`) removes every exclusion. Radius exclusions are
+ * not supported. A place cannot be both targeted and excluded: a request whose result
+ * would leave one on both sides returns 400 before anything is written, and moving a
+ * place from one side to the other in the same request is applied atomically. Example:
+ * `{ "platform": "google", "targeting": { "excludedLocations": { "countries": ["CA"], "regions": ["21137"] } } }`.
+ *
  * The removes and the creates go out in ONE Google `googleAds:mutate`, so a failed
  * edit leaves the campaign's previous set intact rather than a half-applied one.
  *
@@ -9994,7 +10007,7 @@ export const getCampaignTargeting = <ThrowOnError extends boolean = false>(optio
  * (also people searching for or interested in them). Example:
  * `{ "platform": "google", "targeting": { "locationTargetingType": "presence" } }`.
  *
- * The response includes the refreshed `devices`/`locations`/`languages` state
+ * The response includes the refreshed `devices`/`locations`/`excludedLocations`/`languages` state
  * read back from Google after the edit, and invalidates the cached copy
  * `GET` on this campaign would otherwise keep serving.
  *
@@ -10005,6 +10018,7 @@ export const getCampaignTargeting = <ThrowOnError extends boolean = false>(optio
  * returns 400 naming them: edit each one with PUT /v1/ads/{adId} `targeting` on an ad of
  * that ad group. Campaigns migrated from Discovery that still target on the campaign keep
  * being written there. `devices` and `locationTargetingType` stay campaign-level.
+ * `excludedLocations` is not available on Demand Gen yet and returns 400.
  *
  */
 export const updateCampaignTargeting = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateCampaignTargetingData, ThrowOnError>) => {
@@ -11811,25 +11825,40 @@ export const getAdAccountFinance = <ThrowOnError extends boolean = false>(option
 
 /**
  * Read an ad account's campaigns and ad sets live
- * Reads the campaigns and ad sets of one Meta ad account **live from Meta**, in a single
- * Graph call per request (the account's `/campaigns` and `/adsets` edges, filtered by
- * `effective_status`), so it is cheap enough to run before every write: for example a
- * per-ad-account spend ceiling that must see the current `daily_budget` / `lifetime_budget`
- * rather than the synced copy.
+ * Reads the campaigns and ad sets of one Meta ad account or TikTok advertiser **live from
+ * the platform**, so it is cheap enough to run before every write: for example a
+ * per-ad-account spend ceiling that must see the current daily / lifetime budget rather
+ * than the synced copy. On Meta it is a single Graph call per request (the account's
+ * `/campaigns` and `/adsets` edges, filtered by `effective_status`); on TikTok one
+ * `campaign/get` and one `adgroup/get` page (TikTok ad groups are returned as `adSets`).
  *
  * **Live vs synced.** GET /v1/ads/campaigns and GET /v1/ads/ad-sets serve Zernio's synced
  * store, refreshed by background sync (typically 15 to 60 minutes behind Meta), and their
  * `live=true` re-reads only the on/off switches of at most 20 objects. This endpoint returns
  * what Meta reports at `readAt`, for every matching campaign and ad set, and stores nothing.
  *
- * Budgets and bid amounts are converted from Meta's minor units to whole units of
- * `currency`, the same units as the synced rows. A campaign with a campaign budget
- * (Advantage+ campaign budget) carries `budget` and its ad sets have `budget: null`;
- * otherwise each ad set carries its own.
+ * Budgets and bid amounts are in whole units of `currency`, the same units as the synced
+ * rows (Meta's minor units are converted; TikTok already reports whole units). A campaign
+ * with a campaign budget (Meta Advantage+ campaign budget, TikTok campaign budget
+ * optimization) carries `budget`; otherwise each ad set carries its own.
  *
  * Each level returns at most `limit` rows. When more match, `paging.<level>.after` is a
  * cursor: pass it back as `after` together with `level` to read the next page of that
- * level only. Other platforms answer 501 rather than serving synced data.
+ * level only. TikTok pages by number, so a TikTok cursor must be sent with the same
+ * `limit` that produced it (another `limit` is a 400). Other platforms answer 501 rather
+ * than serving synced data.
+ *
+ * **TikTok specifics.** `status` maps to TikTok's `primary_status` filter, which takes one
+ * value: ACTIVE = delivering (`STATUS_DELIVERY_OK`), PAUSED = switched off
+ * (`STATUS_DISABLE`), DELETED = `STATUS_DELETE`; omitted = every status except deleted
+ * (`STATUS_NOT_DELETE`, which includes enabled entities that are not delivering, such as
+ * an ad group in review). Several values, or IN_PROCESS, WITH_ISSUES, CAMPAIGN_PAUSED and
+ * ARCHIVED, are a 400. `budgetRemaining` and `spendCap` are always null (TikTok reports
+ * neither), campaign `bidStrategy` is null (TikTok bids per ad group), ad set `bidStrategy`
+ * is normalized to the Meta vocabulary like GET /v1/ads, `promotedObject` is
+ * `{ pixelId, customEventType, applicationId, customConversionId }` (the keys TikTok has
+ * set, as POST /v1/ads/create takes them), and `targeting` holds TikTok's targeting
+ * fields verbatim.
  */
 export const getAdAccountLiveEntities = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdAccountLiveEntitiesData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetAdAccountLiveEntitiesResponse, GetAdAccountLiveEntitiesError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -10612,7 +10612,7 @@ export type TargetingSpec = {
         address?: string;
     }>;
     /**
-     * Geo to exclude from the audience. Mirrors the inclusion geo shape: excluded cities can carry a radius catchment and excluded custom (lat/lng) pins are supported, both on Meta (excluded_geo_locations).
+     * Geo to exclude from the audience. Mirrors the inclusion geo shape: excluded cities can carry a radius catchment and excluded custom (lat/lng) pins are supported, both on Meta (excluded_geo_locations). Google (Search, Display, Performance Max) excludes countries, regions, cities and zips as negative location criteria; countryGroups, places, neighborhoods, customLocations and a city radius return 400 there, and Demand Gen returns 400 for any exclusion.
      */
     excludedLocations?: {
         countries?: Array<(string)>;
@@ -40898,6 +40898,27 @@ export type GetCampaignTargetingResponse = ({
          */
         countryCode?: (string) | null;
     }>;
+    /**
+     * The negative (excluded) location criteria, same item shape as `locations` with `negative: true`.
+     */
+    excludedLocations?: Array<{
+        /**
+         * Numeric id from Google's geoTargetConstants/{id}.
+         */
+        geoTargetId?: string;
+        /**
+         * Always true here.
+         */
+        negative?: boolean;
+        name?: (string) | null;
+        canonicalName?: (string) | null;
+        type?: (string) | null;
+        countryCode?: (string) | null;
+    }>;
+    /**
+     * Whether PUT accepts `excludedLocations` for this campaign. False on Demand Gen, which returns 400 for any exclusion.
+     */
+    excludedLocationsEditable?: boolean;
     languages?: Array<{
         /**
          * 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.
@@ -40965,6 +40986,28 @@ export type UpdateCampaignTargetingData = {
              * Google's language codes (ISO 639-1, plus variants such as `zh_CN`), e.g. ["en", "de"].
              */
             languages?: Array<(string)>;
+            /**
+             * Locations the campaign never serves in, as a bare country-code array or the nested countries/regions/cities/zips/metros shape. Replaces the excluded set; [] removes every exclusion.
+             */
+            excludedLocations?: (Array<(string)> | {
+    countries?: Array<(string)>;
+    regions?: Array<(string | {
+    key: string;
+    name?: string;
+})>;
+    cities?: Array<(string | {
+    key: string;
+    name?: string;
+})>;
+    zips?: Array<(string | {
+    key: string;
+    name?: string;
+})>;
+    metros?: Array<(string | {
+    key: string;
+    name?: string;
+})>;
+});
             locationTargetingType?: GoogleLocationTargetingType;
         };
     };
@@ -40985,7 +41028,7 @@ export type UpdateCampaignTargetingResponse = ({
     /**
      * Which targeting fields were applied.
      */
-    updated?: Array<('devices' | 'locations' | 'languages' | 'locationTargetingType')>;
+    updated?: Array<('devices' | 'locations' | 'excludedLocations' | 'languages' | 'locationTargetingType')>;
     /**
      * The value read back from Google after the edit.
      */
@@ -41024,6 +41067,17 @@ export type UpdateCampaignTargetingResponse = ({
          */
         countryCode?: (string) | null;
     }>;
+    /**
+     * The negative (excluded) location criteria read back after the edit, same item shape as `locations`.
+     */
+    excludedLocations?: Array<{
+        geoTargetId?: string;
+        negative?: boolean;
+        name?: (string) | null;
+        canonicalName?: (string) | null;
+        type?: (string) | null;
+        countryCode?: (string) | null;
+    }>;
     languages?: Array<{
         code?: string;
         id?: string;
@@ -45567,15 +45621,15 @@ export type GetAdAccountFinanceError = (unknown | ErrorResponse);
 export type GetAdAccountLiveEntitiesData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the platform token.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Meta ad account id (act_<n>) or TikTok advertiser id (digits).
          */
         adAccountId: string;
         /**
-         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level`.
+         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level` (and on TikTok the same `limit`).
          */
         after?: string;
         /**
@@ -45590,6 +45644,7 @@ export type GetAdAccountLiveEntitiesData = {
          * Comma-separated Meta `effective_status` values to keep: ACTIVE, PAUSED, IN_PROCESS,
          * WITH_ISSUES, DELETED, ARCHIVED, and CAMPAIGN_PAUSED (ad sets only; the campaigns level
          * ignores it). Defaults to every status except DELETED and ARCHIVED. An unknown value is a 400.
+         * TikTok takes a single value: ACTIVE, PAUSED or DELETED (see the description).
          */
         status?: string;
     };
@@ -45598,13 +45653,13 @@ export type GetAdAccountLiveEntitiesData = {
 export type GetAdAccountLiveEntitiesResponse = ({
     accountId?: string;
     adAccountId?: string;
-    platform?: 'facebook';
+    platform?: 'facebook' | 'tiktok';
     /**
      * ISO 4217 code every budget and bid amount is expressed in.
      */
     currency?: string;
     /**
-     * When Meta was read.
+     * When the platform was read.
      */
     readAt?: string;
     /**
@@ -45614,11 +45669,11 @@ export type GetAdAccountLiveEntitiesResponse = ({
         platformCampaignId?: string;
         campaignName?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, WITH_ISSUES.
+         * Meta `effective_status` (ACTIVE, PAUSED, WITH_ISSUES...) or TikTok `secondary_status` (CAMPAIGN_STATUS_ENABLE...).
          */
         platformCampaignStatus?: (string) | null;
         /**
-         * Meta `status`: the campaign's own switch (ACTIVE, PAUSED, DELETED, ARCHIVED).
+         * The campaign's own switch: Meta `status` (ACTIVE, PAUSED, DELETED, ARCHIVED), or TikTok `operation_status` as ACTIVE (ENABLE) / PAUSED (DISABLE).
          */
         configuredStatus?: (string) | null;
         /**
@@ -45633,23 +45688,27 @@ export type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency` (Meta `daily_budget`; TikTok `budget` under a daily budget mode).
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency` (Meta `lifetime_budget`; TikTok `budget` under BUDGET_MODE_TOTAL).
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it (BUDGET_MODE_DAY, BUDGET_MODE_DYNAMIC_DAILY_BUDGET, BUDGET_MODE_TOTAL, BUDGET_MODE_INFINITE).
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set.
+         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set, and always on TikTok.
          */
         spendCap?: (number) | null;
         /**
-         * Meta `bid_strategy`, set on campaigns with a campaign budget.
+         * Meta `bid_strategy`, set on campaigns with a campaign budget. Null on TikTok.
          */
         bidStrategy?: (string) | null;
     }>;
@@ -45661,11 +45720,11 @@ export type GetAdAccountLiveEntitiesResponse = ({
         adSetName?: (string) | null;
         platformCampaignId?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, CAMPAIGN_PAUSED.
+         * Meta `effective_status` (ACTIVE, PAUSED, CAMPAIGN_PAUSED...) or TikTok `secondary_status` (ADGROUP_STATUS_DELIVERY_OK, ADGROUP_STATUS_AUDIT...).
          */
         platformAdSetStatus?: (string) | null;
         /**
-         * Meta `status`: the ad set's own switch.
+         * The ad set's own switch: Meta `status`, or TikTok `operation_status` as ACTIVE / PAUSED.
          */
         configuredStatus?: (string) | null;
         /**
@@ -45680,41 +45739,45 @@ export type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency`.
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency`.
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it.
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Meta `bid_strategy`.
+         * Meta `bid_strategy`. On TikTok the ad group's `bid_type` normalized to the same vocabulary (LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, LOWEST_COST_WITH_MIN_ROAS).
          */
         bidStrategy?: (string) | null;
         /**
-         * Meta `bid_amount` (bid cap or cost target) in whole units of `currency`. Null when the strategy has none.
+         * Bid cap or cost target in whole units of `currency` (Meta `bid_amount`; TikTok `bid_price`, else `conversion_bid_price`, else `deep_cpa_bid`). Null when the strategy has none.
          */
         bidAmount?: (number) | null;
         /**
-         * Meta `optimization_goal`.
+         * Meta or TikTok `optimization_goal`.
          */
         optimizationGoal?: (string) | null;
         /**
-         * Meta `billing_event`.
+         * Meta or TikTok `billing_event`.
          */
         billingEvent?: (string) | null;
         /**
-         * Meta `promoted_object` verbatim (snake_case).
+         * Meta `promoted_object` verbatim (snake_case). On TikTok `{ pixelId, customEventType, applicationId, customConversionId }` from `pixel_id`, `optimization_event`, `app_id` and `custom_conversion_id`, only the keys TikTok has set; null when none is.
          */
         promotedObject?: {
             [key: string]: unknown;
         } | null;
         /**
-         * Meta `targeting` verbatim (snake_case), as Meta returns it now.
+         * The platform's targeting verbatim (snake_case), as it reports it now: Meta `targeting`, or TikTok's ad group targeting fields (location_ids, age_groups, gender, languages, interest_category_ids, audience_ids, placements...).
          */
         targeting?: {
             [key: string]: unknown;