@getlatedev/node 0.2.1180 → 0.2.1182

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -2572,7 +2572,7 @@ type AdCampaign = {
2572
2572
  */
2573
2573
  statusReadAt?: (string) | null;
2574
2574
  /**
2575
- * 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.
2575
+ * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. A fixed subset of TikTok's campaign/get record, not the whole record: campaign_id, 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, each with TikTok's own value and present only when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. Whether the campaign is Upgraded Smart+ is `isSmartPlus`.
2576
2576
  */
2577
2577
  nativeSettings?: {
2578
2578
  [key: string]: unknown;
@@ -2616,6 +2616,10 @@ type AdCampaign = {
2616
2616
  platformAdAccountName?: (string) | null;
2617
2617
  accountId?: string;
2618
2618
  profileId?: string;
2619
+ /**
2620
+ * TikTok only. true when the campaign is an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
2621
+ */
2622
+ isSmartPlus?: boolean;
2619
2623
  /**
2620
2624
  * Google-only. Raw campaign.advertising_channel_type. See AdTreeCampaign.advertisingChannelType.
2621
2625
  */
@@ -3381,6 +3385,10 @@ type AdTreeAdSet = {
3381
3385
  */
3382
3386
  createdTime?: (string) | null;
3383
3387
  adCount?: number;
3388
+ /**
3389
+ * TikTok only. true when this ad group belongs to an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
3390
+ */
3391
+ isSmartPlus?: boolean;
3384
3392
  /**
3385
3393
  * Effective budget at this level (back-compat). For CBO campaigns this mirrors the parent campaign's budget; for ABO this is the ad-set-specific budget. Use `adSetBudget` / parent `campaignBudget` + `budgetLevel` to disambiguate.
3386
3394
  */
@@ -3535,6 +3543,10 @@ type AdTreeCampaign = {
3535
3543
  platformAdAccountName?: (string) | null;
3536
3544
  accountId?: string;
3537
3545
  profileId?: string;
3546
+ /**
3547
+ * TikTok only. true when the campaign is an Upgraded Smart+ campaign (TikTok lists it on /smart_plus/campaign/get/), false when it is not. Set by ads sync, so the key is absent on other platforms and on TikTok campaigns not synced since this field shipped. On Smart+ objects Zernio can pause, resume, rename, delete and change the budget of the campaign and ad set, and pause or resume an ad; other edits answer 422 and belong in TikTok Ads Manager.
3548
+ */
3549
+ isSmartPlus?: boolean;
3538
3550
  /**
3539
3551
  * Google-only. Raw campaign.advertising_channel_type (SEARCH, PERFORMANCE_MAX, LOCAL_SERVICES, VIDEO, DEMAND_GEN, DISPLAY, SHOPPING, ...). Serving surface, distinct from platformObjective (advertiser intent). Null/absent for non-Google platforms.
3540
3552
  */
@@ -30053,7 +30065,7 @@ type GetMessageAttachmentError = (unknown | ErrorResponse);
30053
30065
  type ListInboxCommentsData = {
30054
30066
  query?: {
30055
30067
  /**
30056
- * Filter by specific account ID
30068
+ * Filter by specific account ID. With `platform=metaads` it takes the Meta Ads account ID, or the Facebook or Instagram account ID the Meta Ads connection belongs to, which returns that Meta Ads connection's ad rows. A Facebook or Instagram account with no Meta Ads connection returns no rows; an account on any other platform returns 400.
30057
30069
  */
30058
30070
  accountId?: string;
30059
30071
  cursor?: string;
@@ -41768,7 +41780,7 @@ type ListAdSetsResponse = ({
41768
41780
  [key: string]: unknown;
41769
41781
  } | null;
41770
41782
  /**
41771
- * 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.
41783
+ * TikTok only, only with `live=true` and only on rows read live. A fixed subset of TikTok's adgroup/get record, not the whole record (snake_case, TikTok's own names, enums and values): adgroup_id, campaign_id, 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.
41772
41784
  */
41773
41785
  nativeSettings?: {
41774
41786
  [key: string]: unknown;
package/dist/index.d.ts CHANGED
@@ -2572,7 +2572,7 @@ type AdCampaign = {
2572
2572
  */
2573
2573
  statusReadAt?: (string) | null;
2574
2574
  /**
2575
- * 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.
2575
+ * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. A fixed subset of TikTok's campaign/get record, not the whole record: campaign_id, 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, each with TikTok's own value and present only when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. Whether the campaign is Upgraded Smart+ is `isSmartPlus`.
2576
2576
  */
2577
2577
  nativeSettings?: {
2578
2578
  [key: string]: unknown;
@@ -2616,6 +2616,10 @@ type AdCampaign = {
2616
2616
  platformAdAccountName?: (string) | null;
2617
2617
  accountId?: string;
2618
2618
  profileId?: string;
2619
+ /**
2620
+ * TikTok only. true when the campaign is an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
2621
+ */
2622
+ isSmartPlus?: boolean;
2619
2623
  /**
2620
2624
  * Google-only. Raw campaign.advertising_channel_type. See AdTreeCampaign.advertisingChannelType.
2621
2625
  */
@@ -3381,6 +3385,10 @@ type AdTreeAdSet = {
3381
3385
  */
3382
3386
  createdTime?: (string) | null;
3383
3387
  adCount?: number;
3388
+ /**
3389
+ * TikTok only. true when this ad group belongs to an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
3390
+ */
3391
+ isSmartPlus?: boolean;
3384
3392
  /**
3385
3393
  * Effective budget at this level (back-compat). For CBO campaigns this mirrors the parent campaign's budget; for ABO this is the ad-set-specific budget. Use `adSetBudget` / parent `campaignBudget` + `budgetLevel` to disambiguate.
3386
3394
  */
@@ -3535,6 +3543,10 @@ type AdTreeCampaign = {
3535
3543
  platformAdAccountName?: (string) | null;
3536
3544
  accountId?: string;
3537
3545
  profileId?: string;
3546
+ /**
3547
+ * TikTok only. true when the campaign is an Upgraded Smart+ campaign (TikTok lists it on /smart_plus/campaign/get/), false when it is not. Set by ads sync, so the key is absent on other platforms and on TikTok campaigns not synced since this field shipped. On Smart+ objects Zernio can pause, resume, rename, delete and change the budget of the campaign and ad set, and pause or resume an ad; other edits answer 422 and belong in TikTok Ads Manager.
3548
+ */
3549
+ isSmartPlus?: boolean;
3538
3550
  /**
3539
3551
  * Google-only. Raw campaign.advertising_channel_type (SEARCH, PERFORMANCE_MAX, LOCAL_SERVICES, VIDEO, DEMAND_GEN, DISPLAY, SHOPPING, ...). Serving surface, distinct from platformObjective (advertiser intent). Null/absent for non-Google platforms.
3540
3552
  */
@@ -30053,7 +30065,7 @@ type GetMessageAttachmentError = (unknown | ErrorResponse);
30053
30065
  type ListInboxCommentsData = {
30054
30066
  query?: {
30055
30067
  /**
30056
- * Filter by specific account ID
30068
+ * Filter by specific account ID. With `platform=metaads` it takes the Meta Ads account ID, or the Facebook or Instagram account ID the Meta Ads connection belongs to, which returns that Meta Ads connection's ad rows. A Facebook or Instagram account with no Meta Ads connection returns no rows; an account on any other platform returns 400.
30057
30069
  */
30058
30070
  accountId?: string;
30059
30071
  cursor?: string;
@@ -41768,7 +41780,7 @@ type ListAdSetsResponse = ({
41768
41780
  [key: string]: unknown;
41769
41781
  } | null;
41770
41782
  /**
41771
- * 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.
41783
+ * TikTok only, only with `live=true` and only on rows read live. A fixed subset of TikTok's adgroup/get record, not the whole record (snake_case, TikTok's own names, enums and values): adgroup_id, campaign_id, 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.
41772
41784
  */
41773
41785
  nativeSettings?: {
41774
41786
  [key: string]: unknown;
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@getlatedev/node",
39
- version: "0.2.1180",
39
+ version: "0.2.1182",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@getlatedev/node",
8
- version: "0.2.1180",
8
+ version: "0.2.1182",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getlatedev/node",
3
- "version": "0.2.1180",
3
+ "version": "0.2.1182",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -10346,8 +10346,8 @@ export const updateCampaignTargeting = <ThrowOnError extends boolean = false>(op
10346
10346
  * The rolled-up `status` is not re-derived by a live read. On TikTok the same live read also
10347
10347
  * returns the ad group's applied `optimizationGoal` and `billingEvent`, as TikTok's adgroup/get
10348
10348
  * reports them, so you can verify the goal TikTok applied rather than the one you requested.
10349
- * It also returns `nativeSettings`: TikTok's own adgroup/get record for the ad group, verbatim and
10350
- * read in that same call (budget, budget_mode, schedule, placements, locations, ages, gender,
10349
+ * It also returns `nativeSettings`: a fixed subset of TikTok's own adgroup/get record for the ad group, with
10350
+ * TikTok's own values, read in that same call (budget, budget_mode, schedule, placements, locations, ages, gender,
10351
10351
  * languages, interests, actions, audiences and exclusions), plus the advertiser's currency and
10352
10352
  * timezone. TikTok's `schedule_start_time` / `schedule_end_time` are UTC wall clocks
10353
10353
  * ("YYYY-MM-DD HH:MM:SS", no offset); Ads Manager displays them in `advertiser_timezone`. `configReadAt` says when it was read; it
@@ -577,7 +577,7 @@ export type AdCampaign = {
577
577
  */
578
578
  statusReadAt?: (string) | null;
579
579
  /**
580
- * 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.
580
+ * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. A fixed subset of TikTok's campaign/get record, not the whole record: campaign_id, 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, each with TikTok's own value and present only when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. Whether the campaign is Upgraded Smart+ is `isSmartPlus`.
581
581
  */
582
582
  nativeSettings?: {
583
583
  [key: string]: unknown;
@@ -621,6 +621,10 @@ export type AdCampaign = {
621
621
  platformAdAccountName?: (string) | null;
622
622
  accountId?: string;
623
623
  profileId?: string;
624
+ /**
625
+ * TikTok only. true when the campaign is an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
626
+ */
627
+ isSmartPlus?: boolean;
624
628
  /**
625
629
  * Google-only. Raw campaign.advertising_channel_type. See AdTreeCampaign.advertisingChannelType.
626
630
  */
@@ -1413,6 +1417,10 @@ export type AdTreeAdSet = {
1413
1417
  */
1414
1418
  createdTime?: (string) | null;
1415
1419
  adCount?: number;
1420
+ /**
1421
+ * TikTok only. true when this ad group belongs to an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
1422
+ */
1423
+ isSmartPlus?: boolean;
1416
1424
  /**
1417
1425
  * Effective budget at this level (back-compat). For CBO campaigns this mirrors the parent campaign's budget; for ABO this is the ad-set-specific budget. Use `adSetBudget` / parent `campaignBudget` + `budgetLevel` to disambiguate.
1418
1426
  */
@@ -1568,6 +1576,10 @@ export type AdTreeCampaign = {
1568
1576
  platformAdAccountName?: (string) | null;
1569
1577
  accountId?: string;
1570
1578
  profileId?: string;
1579
+ /**
1580
+ * TikTok only. true when the campaign is an Upgraded Smart+ campaign (TikTok lists it on /smart_plus/campaign/get/), false when it is not. Set by ads sync, so the key is absent on other platforms and on TikTok campaigns not synced since this field shipped. On Smart+ objects Zernio can pause, resume, rename, delete and change the budget of the campaign and ad set, and pause or resume an ad; other edits answer 422 and belong in TikTok Ads Manager.
1581
+ */
1582
+ isSmartPlus?: boolean;
1571
1583
  /**
1572
1584
  * Google-only. Raw campaign.advertising_channel_type (SEARCH, PERFORMANCE_MAX, LOCAL_SERVICES, VIDEO, DEMAND_GEN, DISPLAY, SHOPPING, ...). Serving surface, distinct from platformObjective (advertiser intent). Null/absent for non-Google platforms.
1573
1585
  */
@@ -29529,7 +29541,7 @@ export type GetMessageAttachmentError = (unknown | ErrorResponse);
29529
29541
  export type ListInboxCommentsData = {
29530
29542
  query?: {
29531
29543
  /**
29532
- * Filter by specific account ID
29544
+ * Filter by specific account ID. With `platform=metaads` it takes the Meta Ads account ID, or the Facebook or Instagram account ID the Meta Ads connection belongs to, which returns that Meta Ads connection's ad rows. A Facebook or Instagram account with no Meta Ads connection returns no rows; an account on any other platform returns 400.
29533
29545
  */
29534
29546
  accountId?: string;
29535
29547
  cursor?: string;
@@ -42236,7 +42248,7 @@ export type ListAdSetsResponse = ({
42236
42248
  [key: string]: unknown;
42237
42249
  } | null;
42238
42250
  /**
42239
- * 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.
42251
+ * TikTok only, only with `live=true` and only on rows read live. A fixed subset of TikTok's adgroup/get record, not the whole record (snake_case, TikTok's own names, enums and values): adgroup_id, campaign_id, 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.
42240
42252
  */
42241
42253
  nativeSettings?: {
42242
42254
  [key: string]: unknown;