@zernio/node 0.2.1068 → 0.2.1070

package/dist/index.d.mts

@@ -39480,7 +39480,7 @@ type ListAdSetsResponse = ({
          */
         billingEvent?: (string) | null;
         /**
-         * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
+         * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
          */
         nativeSettings?: {
             [key: string]: unknown;
@@ -46165,6 +46165,10 @@ type SearchAdTargetingData = {
          * Account ID (a connected account on the target ad platform).
          */
         accountId: string;
+        /**
+         * TikTok only: the advertiser to search as, when the connection holds several. Each TikTok advertiser has its own targetable regions and catalogs. Defaults to the connection's first advertiser; an advertiser the connection does not hold returns 400.
+         */
+        adAccountId?: string;
         /**
          * ISO 3166-1 alpha-2 country code (e.g. NL) to scope a geo search.
          */
@@ -46213,6 +46217,10 @@ type SearchAdTargetingResponse = ({
          * ISO-3166 alpha-2 of the country a sub-country geo result (city, region, zip, metro) belongs to, when the platform reports it (Meta does). Useful to know whether a location falls under the EU DSA disclosure rules before creating the ad.
          */
         countryCode?: string;
+        /**
+         * Only on `country` results: the platform's own id for the country, which `id` replaced with the ISO code (TikTok's native location_id, a GeoNames id such as 2635167 for GB; Meta's country key; Google's geo target constant id; X's targeting value; LinkedIn's geo URN). Use it to match a country against what the platform reports back, e.g. `location_ids` in a TikTok `nativeSettings` read.
+         */
+        platformId?: string;
     }>;
 });
 type SearchAdTargetingError = (unknown | ErrorResponse);

package/dist/index.d.ts

@@ -39480,7 +39480,7 @@ type ListAdSetsResponse = ({
          */
         billingEvent?: (string) | null;
         /**
-         * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
+         * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
          */
         nativeSettings?: {
             [key: string]: unknown;
@@ -46165,6 +46165,10 @@ type SearchAdTargetingData = {
          * Account ID (a connected account on the target ad platform).
          */
         accountId: string;
+        /**
+         * TikTok only: the advertiser to search as, when the connection holds several. Each TikTok advertiser has its own targetable regions and catalogs. Defaults to the connection's first advertiser; an advertiser the connection does not hold returns 400.
+         */
+        adAccountId?: string;
         /**
          * ISO 3166-1 alpha-2 country code (e.g. NL) to scope a geo search.
          */
@@ -46213,6 +46217,10 @@ type SearchAdTargetingResponse = ({
          * ISO-3166 alpha-2 of the country a sub-country geo result (city, region, zip, metro) belongs to, when the platform reports it (Meta does). Useful to know whether a location falls under the EU DSA disclosure rules before creating the ad.
          */
         countryCode?: string;
+        /**
+         * Only on `country` results: the platform's own id for the country, which `id` replaced with the ISO code (TikTok's native location_id, a GeoNames id such as 2635167 for GB; Meta's country key; Google's geo target constant id; X's targeting value; LinkedIn's geo URN). Use it to match a country against what the platform reports back, e.g. `location_ids` in a TikTok `nativeSettings` read.
+         */
+        platformId?: string;
     }>;
 });
 type SearchAdTargetingError = (unknown | ErrorResponse);

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -9781,7 +9781,8 @@ export const updateCampaignTargeting = <ThrowOnError extends boolean = false>(op
  * It also returns `nativeSettings`: TikTok's own adgroup/get record for the ad group, verbatim and
  * read in that same call (budget, budget_mode, schedule, placements, locations, ages, gender,
  * languages, interests, actions, audiences and exclusions), plus the advertiser's currency and
- * timezone (TikTok's schedule times are in that timezone). `configReadAt` says when it was read; it
+ * timezone. TikTok's `schedule_start_time` / `schedule_end_time` are UTC wall clocks
+ * ("YYYY-MM-DD HH:MM:SS", no offset); Ads Manager displays them in `advertiser_timezone`. `configReadAt` says when it was read; it
  * is null on every row whose native settings were not read now, so never treat a null as a match.
  * These are read, not retained create payloads, and are not stored.
  */
@@ -12108,7 +12109,8 @@ export const searchAdInterests = <ThrowOnError extends boolean = false>(options:
  * TikTok geo searches return every matching level in one list (`type` is
  * `country`, `region`, `city`, `district`, or `metro` for DMA areas), and
  * `geoType` is not applied. Results are scoped to the advertiser's targetable
- * markets. A `country` result's id is its ISO 3166-1 alpha-2 code, for
+ * markets (pass `adAccountId` when the connection holds several advertisers). A
+ * two-letter `q` also matches a country by ISO code (`q=GB` returns the United Kingdom first). A `country` result's id is its ISO 3166-1 alpha-2 code, for
  * `targeting.countries`; every other id is TikTok's numeric location id,
  * usable in `regions`/`cities`/`metros` keys on `POST /v1/ads/create`.
  *

package/src/generated/types.gen.ts

@@ -39871,7 +39871,7 @@ export type ListAdSetsResponse = ({
          */
         billingEvent?: (string) | null;
         /**
-         * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
+         * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
          */
         nativeSettings?: {
             [key: string]: unknown;
@@ -46945,6 +46945,10 @@ export type SearchAdTargetingData = {
          * Account ID (a connected account on the target ad platform).
          */
         accountId: string;
+        /**
+         * TikTok only: the advertiser to search as, when the connection holds several. Each TikTok advertiser has its own targetable regions and catalogs. Defaults to the connection's first advertiser; an advertiser the connection does not hold returns 400.
+         */
+        adAccountId?: string;
         /**
          * ISO 3166-1 alpha-2 country code (e.g. NL) to scope a geo search.
          */
@@ -46994,6 +46998,10 @@ export type SearchAdTargetingResponse = ({
          * ISO-3166 alpha-2 of the country a sub-country geo result (city, region, zip, metro) belongs to, when the platform reports it (Meta does). Useful to know whether a location falls under the EU DSA disclosure rules before creating the ad.
          */
         countryCode?: string;
+        /**
+         * Only on `country` results: the platform's own id for the country, which `id` replaced with the ISO code (TikTok's native location_id, a GeoNames id such as 2635167 for GB; Meta's country key; Google's geo target constant id; X's targeting value; LinkedIn's geo URN). Use it to match a country against what the platform reports back, e.g. `location_ids` in a TikTok `nativeSettings` read.
+         */
+        platformId?: string;
     }>;
 });