@zernio/node 0.2.771 → 0.2.773

package/dist/index.d.mts

@@ -4703,6 +4703,15 @@ type CtwaAdRequestBody = {
         key: string;
         name?: string;
     }>;
+    /**
+     * Meta only. Continents and trade blocs (`geo_locations.country_groups`),
+     * for targeting a whole region without listing its countries. Combines
+     * with `countries` rather than replacing it, and is also accepted under
+     * `excludedLocations`. Discoverable via
+     * `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`.
+     *
+     */
+    countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
     /**
      * Point-radius geo (Meta `geo_locations.custom_locations`).
      * Use for targeting a radius around a specific lat/long when
@@ -8256,6 +8265,15 @@ type TargetingSpec = {
         key: string;
         name?: string;
     }>;
+    /**
+     * Meta only. Continents and trade blocs (`geo_locations.country_groups`),
+     * for targeting a whole region without listing its countries. Combines
+     * with `countries` rather than replacing it, and is also accepted under
+     * `excludedLocations`. Discoverable via
+     * `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`.
+     *
+     */
+    countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
     /**
      * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured on Meta and Google; ignored on platforms without radius support.
      */
@@ -8278,6 +8296,10 @@ type TargetingSpec = {
      */
     excludedLocations?: {
         countries?: Array<(string)>;
+        /**
+         * Meta only. Continents and trade blocs to exclude (`excluded_geo_locations.country_groups`).
+         */
+        countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
         regions?: Array<{
             key: string;
             name?: string;
@@ -37245,6 +37267,14 @@ type CreateStandaloneAdData = {
          * ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no other geo targeting (flat or nested `targeting`) is provided. (LinkedIn and OpenAI Ads currently honour country-level targeting only; any other targeting field returns 400 for OpenAI Ads.)
          */
         countries?: Array<(string)>;
+        /**
+         * Meta only. Continents and trade blocs (`geo_locations.country_groups`),
+         * for targeting a whole region without listing its countries. Combines with
+         * `countries` rather than replacing it. Discoverable via
+         * `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`.
+         *
+         */
+        countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
         /**
          * City-level geo targeting (Meta and TikTok). Each city is targeted by the platform's opaque `key` (the city ID) which can be looked up via `GET /v1/ads/targeting/search?dimension=geo&q=<name>&countryCode=<ISO>`. Optional `radius` + `distance_unit` (Meta only) extend the targeting beyond the city limits (e.g. radius 25 km around the city center). Both must be set together, or both omitted (Meta defaults to ~16 km when omitted).
          *
@@ -38627,7 +38657,7 @@ type SearchAdTargetingData = {
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
-        geoType?: 'all' | 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
+        geoType?: 'all' | 'country' | 'country_group' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
         /**
          * Maximum results to return.
          */

package/dist/index.d.ts

@@ -4703,6 +4703,15 @@ type CtwaAdRequestBody = {
         key: string;
         name?: string;
     }>;
+    /**
+     * Meta only. Continents and trade blocs (`geo_locations.country_groups`),
+     * for targeting a whole region without listing its countries. Combines
+     * with `countries` rather than replacing it, and is also accepted under
+     * `excludedLocations`. Discoverable via
+     * `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`.
+     *
+     */
+    countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
     /**
      * Point-radius geo (Meta `geo_locations.custom_locations`).
      * Use for targeting a radius around a specific lat/long when
@@ -8256,6 +8265,15 @@ type TargetingSpec = {
         key: string;
         name?: string;
     }>;
+    /**
+     * Meta only. Continents and trade blocs (`geo_locations.country_groups`),
+     * for targeting a whole region without listing its countries. Combines
+     * with `countries` rather than replacing it, and is also accepted under
+     * `excludedLocations`. Discoverable via
+     * `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`.
+     *
+     */
+    countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
     /**
      * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured on Meta and Google; ignored on platforms without radius support.
      */
@@ -8278,6 +8296,10 @@ type TargetingSpec = {
      */
     excludedLocations?: {
         countries?: Array<(string)>;
+        /**
+         * Meta only. Continents and trade blocs to exclude (`excluded_geo_locations.country_groups`).
+         */
+        countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
         regions?: Array<{
             key: string;
             name?: string;
@@ -37245,6 +37267,14 @@ type CreateStandaloneAdData = {
          * ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no other geo targeting (flat or nested `targeting`) is provided. (LinkedIn and OpenAI Ads currently honour country-level targeting only; any other targeting field returns 400 for OpenAI Ads.)
          */
         countries?: Array<(string)>;
+        /**
+         * Meta only. Continents and trade blocs (`geo_locations.country_groups`),
+         * for targeting a whole region without listing its countries. Combines with
+         * `countries` rather than replacing it. Discoverable via
+         * `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`.
+         *
+         */
+        countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
         /**
          * City-level geo targeting (Meta and TikTok). Each city is targeted by the platform's opaque `key` (the city ID) which can be looked up via `GET /v1/ads/targeting/search?dimension=geo&q=<name>&countryCode=<ISO>`. Optional `radius` + `distance_unit` (Meta only) extend the targeting beyond the city limits (e.g. radius 25 km around the city center). Both must be set together, or both omitted (Meta defaults to ~16 km when omitted).
          *
@@ -38627,7 +38657,7 @@ type SearchAdTargetingData = {
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
-        geoType?: 'all' | 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
+        geoType?: 'all' | 'country' | 'country_group' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
         /**
          * Maximum results to return.
          */

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -3230,6 +3230,15 @@ export type CtwaAdRequestBody = {
         key: string;
         name?: string;
     }>;
+    /**
+     * Meta only. Continents and trade blocs (`geo_locations.country_groups`),
+     * for targeting a whole region without listing its countries. Combines
+     * with `countries` rather than replacing it, and is also accepted under
+     * `excludedLocations`. Discoverable via
+     * `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`.
+     *
+     */
+    countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
     /**
      * Point-radius geo (Meta `geo_locations.custom_locations`).
      * Use for targeting a radius around a specific lat/long when
@@ -6944,6 +6953,15 @@ export type TargetingSpec = {
         key: string;
         name?: string;
     }>;
+    /**
+     * Meta only. Continents and trade blocs (`geo_locations.country_groups`),
+     * for targeting a whole region without listing its countries. Combines
+     * with `countries` rather than replacing it, and is also accepted under
+     * `excludedLocations`. Discoverable via
+     * `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`.
+     *
+     */
+    countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
     /**
      * Point-radius (lat/lng) targeting (Meta custom_locations / Google proximity). Honoured on Meta and Google; ignored on platforms without radius support.
      */
@@ -6966,6 +6984,10 @@ export type TargetingSpec = {
      */
     excludedLocations?: {
         countries?: Array<(string)>;
+        /**
+         * Meta only. Continents and trade blocs to exclude (`excluded_geo_locations.country_groups`).
+         */
+        countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
         regions?: Array<{
             key: string;
             name?: string;
@@ -37861,6 +37883,14 @@ export type CreateStandaloneAdData = {
          * ISO 3166-1 alpha-2 country codes (e.g. ['NL']). Defaults to ['US'] when no other geo targeting (flat or nested `targeting`) is provided. (LinkedIn and OpenAI Ads currently honour country-level targeting only; any other targeting field returns 400 for OpenAI Ads.)
          */
         countries?: Array<(string)>;
+        /**
+         * Meta only. Continents and trade blocs (`geo_locations.country_groups`),
+         * for targeting a whole region without listing its countries. Combines with
+         * `countries` rather than replacing it. Discoverable via
+         * `GET /v1/ads/targeting/search?dimension=geo&geoType=country_group`.
+         *
+         */
+        countryGroups?: Array<('africa' | 'asia' | 'europe' | 'north_america' | 'south_america' | 'oceania' | 'central_america' | 'caribbean' | 'eea' | 'euro_area' | 'nafta' | 'mercosur' | 'afta' | 'apec' | 'gcc' | 'cisfta' | 'emerging_markets' | 'itunes_app_store' | 'android_free_store' | 'android_paid_store')>;
         /**
          * City-level geo targeting (Meta and TikTok). Each city is targeted by the platform's opaque `key` (the city ID) which can be looked up via `GET /v1/ads/targeting/search?dimension=geo&q=<name>&countryCode=<ISO>`. Optional `radius` + `distance_unit` (Meta only) extend the targeting beyond the city limits (e.g. radius 25 km around the city center). Both must be set together, or both omitted (Meta defaults to ~16 km when omitted).
          *
@@ -39285,7 +39315,7 @@ export type SearchAdTargetingData = {
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
-        geoType?: 'all' | 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
+        geoType?: 'all' | 'country' | 'country_group' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
         /**
          * Maximum results to return.
          */