@zernio/node 0.2.1067 → 0.2.1069

package/dist/index.d.mts

@@ -2473,6 +2473,16 @@ type AdCampaign = {
      * Only on GET /v1/ads/campaigns with `live=true`. When `platformCampaignStatus` was read from the platform; null when this campaign could not be read live.
      */
     statusReadAt?: (string) | null;
+    /**
+     * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. TikTok's campaign/get record verbatim: operation_status, objective_type, budget_mode (BUDGET_MODE_INFINITE means no campaign budget, so budget lives on the ad groups), budget, and budget_optimize_on when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info.
+     */
+    nativeSettings?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Only on GET /v1/ads/campaigns with `live=true`. When `nativeSettings` was read from the platform. Null whenever native settings were not read now.
+     */
+    configReadAt?: (string) | null;
     /**
      * Platform-reported campaign issues (Meta `issues_info[]`).
      */
@@ -39469,6 +39479,16 @@ type ListAdSetsResponse = ({
          * TikTok only, only with `live=true` and only on rows read live. The ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM).
          */
         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. 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;
+        };
+        /**
+         * Only with `live=true`. When `nativeSettings` was read from the platform. Null on every row whose native settings were not read now (row past the cap, failed read, or a platform without a native read).
+         */
+        configReadAt?: (string) | null;
     }>;
 });
 type ListAdSetsError = (ErrorResponse | unknown);
@@ -46193,6 +46213,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

@@ -2473,6 +2473,16 @@ type AdCampaign = {
      * Only on GET /v1/ads/campaigns with `live=true`. When `platformCampaignStatus` was read from the platform; null when this campaign could not be read live.
      */
     statusReadAt?: (string) | null;
+    /**
+     * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. TikTok's campaign/get record verbatim: operation_status, objective_type, budget_mode (BUDGET_MODE_INFINITE means no campaign budget, so budget lives on the ad groups), budget, and budget_optimize_on when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info.
+     */
+    nativeSettings?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Only on GET /v1/ads/campaigns with `live=true`. When `nativeSettings` was read from the platform. Null whenever native settings were not read now.
+     */
+    configReadAt?: (string) | null;
     /**
      * Platform-reported campaign issues (Meta `issues_info[]`).
      */
@@ -39469,6 +39479,16 @@ type ListAdSetsResponse = ({
          * TikTok only, only with `live=true` and only on rows read live. The ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM).
          */
         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. 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;
+        };
+        /**
+         * Only with `live=true`. When `nativeSettings` was read from the platform. Null on every row whose native settings were not read now (row past the cap, failed read, or a platform without a native read).
+         */
+        configReadAt?: (string) | null;
     }>;
 });
 type ListAdSetsError = (ErrorResponse | unknown);
@@ -46193,6 +46213,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.1067",
+  version: "0.2.1069",
   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.1067",
+  version: "0.2.1069",
   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.1067",
+  "version": "0.2.1069",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -9778,6 +9778,13 @@ export const updateCampaignTargeting = <ThrowOnError extends boolean = false>(op
  * The rolled-up `status` is not re-derived by a live read. On TikTok the same live read also
  * returns the ad group's applied `optimizationGoal` and `billingEvent`, as TikTok's adgroup/get
  * reports them, so you can verify the goal TikTok applied rather than the one you requested.
+ * 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_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.
  */
 export const listAdSets = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<ListAdSetsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListAdSetsResponse, ListAdSetsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -516,6 +516,16 @@ export type AdCampaign = {
      * Only on GET /v1/ads/campaigns with `live=true`. When `platformCampaignStatus` was read from the platform; null when this campaign could not be read live.
      */
     statusReadAt?: (string) | null;
+    /**
+     * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. TikTok's campaign/get record verbatim: operation_status, objective_type, budget_mode (BUDGET_MODE_INFINITE means no campaign budget, so budget lives on the ad groups), budget, and budget_optimize_on when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info.
+     */
+    nativeSettings?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Only on GET /v1/ads/campaigns with `live=true`. When `nativeSettings` was read from the platform. Null whenever native settings were not read now.
+     */
+    configReadAt?: (string) | null;
     /**
      * Platform-reported campaign issues (Meta `issues_info[]`).
      */
@@ -39860,6 +39870,16 @@ export type ListAdSetsResponse = ({
          * TikTok only, only with `live=true` and only on rows read live. The ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM).
          */
         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. 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;
+        };
+        /**
+         * Only with `live=true`. When `nativeSettings` was read from the platform. Null on every row whose native settings were not read now (row past the cap, failed read, or a platform without a native read).
+         */
+        configReadAt?: (string) | null;
     }>;
 });
 
@@ -46974,6 +46994,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;
     }>;
 });