@getlatedev/node 0.2.1114 → 0.2.1116

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)>;
@@ -18954,7 +18954,7 @@ type ListInboxConversationAnalyticsResponse = ({
     to?: (string) | null;
     items?: Array<{
         /**
-         * The platformConversationId (the same identity used by metadata.conversationId)
+         * The platformConversationId. A thread whose events were logged under both its ids comes back as one row.
          */
         conversationId?: 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;

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)>;
@@ -18954,7 +18954,7 @@ type ListInboxConversationAnalyticsResponse = ({
     to?: (string) | null;
     items?: Array<{
         /**
-         * The platformConversationId (the same identity used by metadata.conversationId)
+         * The platformConversationId. A thread whose events were logged under both its ids comes back as one row.
          */
         conversationId?: 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;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1114",
+  version: "0.2.1116",
   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.1114",
+  version: "0.2.1116",
   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.1114",
+  "version": "0.2.1116",
   "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>) => {

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)>;
@@ -17744,7 +17744,7 @@ export type ListInboxConversationAnalyticsResponse = ({
     to?: (string) | null;
     items?: Array<{
         /**
-         * The platformConversationId (the same identity used by metadata.conversationId)
+         * The platformConversationId. A thread whose events were logged under both its ids comes back as one row.
          */
         conversationId?: 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;