@getlatedev/node 0.2.1121 → 0.2.1123

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
@@ -40294,7 +40294,7 @@ type UpdateAdCampaignData = {
40294
40294
  */
40295
40295
  portfolioBidStrategyId?: string;
40296
40296
  /**
40297
- * Google only. Explicitly allow changing a shared campaign budget, affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40297
+ * Google only. Explicitly allow changing a shared campaign budget (flagged as shared by Google, or used by more than one campaign), affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40298
40298
  */
40299
40299
  allowSharedBudgetUpdate?: boolean;
40300
40300
  /**
@@ -42260,7 +42260,33 @@ type GetAdReviewResponse = ({
42260
42260
  } | null;
42261
42261
  }>;
42262
42262
  /**
42263
- * When the verdict was read from TikTok.
42263
+ * Google only. ad_group_ad.policy_summary.approval_status, verbatim.
42264
+ */
42265
+ approvalStatus?: (string) | null;
42266
+ /**
42267
+ * Google only. ad_group_ad.policy_summary.policy_topic_entries.
42268
+ */
42269
+ policyTopics?: Array<{
42270
+ topic?: (string) | null;
42271
+ /**
42272
+ * PROHIBITED, LIMITED, FULLY_LIMITED, DESCRIPTIVE, BROADENING, AREA_OF_INTEREST_ONLY.
42273
+ */
42274
+ type?: (string) | null;
42275
+ /**
42276
+ * Google's PolicyTopicEvidence objects, verbatim.
42277
+ */
42278
+ evidences?: Array<{
42279
+ [key: string]: unknown;
42280
+ }>;
42281
+ /**
42282
+ * Google's PolicyTopicConstraint objects, verbatim.
42283
+ */
42284
+ constraints?: Array<{
42285
+ [key: string]: unknown;
42286
+ }>;
42287
+ }>;
42288
+ /**
42289
+ * When the verdict was read from the platform.
42264
42290
  */
42265
42291
  readAt?: string;
42266
42292
  };
@@ -43007,7 +43033,7 @@ type GetAdsActivityLogData = {
43007
43033
  */
43008
43034
  accountId: string;
43009
43035
  /**
43010
- * Meta ad account id (act_<n>).
43036
+ * Meta ad account id (act_<n>), or the Google customer id (digits only).
43011
43037
  */
43012
43038
  adAccountId: string;
43013
43039
  /**
@@ -43019,11 +43045,11 @@ type GetAdsActivityLogData = {
43019
43045
  */
43020
43046
  limit?: number;
43021
43047
  /**
43022
- * Client-side filter to one Meta object id (campaign, ad set or ad).
43048
+ * Client-side filter to one object id (campaign, ad set / ad group or ad).
43023
43049
  */
43024
43050
  objectId?: string;
43025
43051
  /**
43026
- * Start of range (YYYY-MM-DD).
43052
+ * Start of range (YYYY-MM-DD). Google: at most 29 days ago, the default.
43027
43053
  */
43028
43054
  since?: string;
43029
43055
  /**
package/dist/index.d.ts CHANGED
@@ -40294,7 +40294,7 @@ type UpdateAdCampaignData = {
40294
40294
  */
40295
40295
  portfolioBidStrategyId?: string;
40296
40296
  /**
40297
- * Google only. Explicitly allow changing a shared campaign budget, affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40297
+ * Google only. Explicitly allow changing a shared campaign budget (flagged as shared by Google, or used by more than one campaign), affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40298
40298
  */
40299
40299
  allowSharedBudgetUpdate?: boolean;
40300
40300
  /**
@@ -42260,7 +42260,33 @@ type GetAdReviewResponse = ({
42260
42260
  } | null;
42261
42261
  }>;
42262
42262
  /**
42263
- * When the verdict was read from TikTok.
42263
+ * Google only. ad_group_ad.policy_summary.approval_status, verbatim.
42264
+ */
42265
+ approvalStatus?: (string) | null;
42266
+ /**
42267
+ * Google only. ad_group_ad.policy_summary.policy_topic_entries.
42268
+ */
42269
+ policyTopics?: Array<{
42270
+ topic?: (string) | null;
42271
+ /**
42272
+ * PROHIBITED, LIMITED, FULLY_LIMITED, DESCRIPTIVE, BROADENING, AREA_OF_INTEREST_ONLY.
42273
+ */
42274
+ type?: (string) | null;
42275
+ /**
42276
+ * Google's PolicyTopicEvidence objects, verbatim.
42277
+ */
42278
+ evidences?: Array<{
42279
+ [key: string]: unknown;
42280
+ }>;
42281
+ /**
42282
+ * Google's PolicyTopicConstraint objects, verbatim.
42283
+ */
42284
+ constraints?: Array<{
42285
+ [key: string]: unknown;
42286
+ }>;
42287
+ }>;
42288
+ /**
42289
+ * When the verdict was read from the platform.
42264
42290
  */
42265
42291
  readAt?: string;
42266
42292
  };
@@ -43007,7 +43033,7 @@ type GetAdsActivityLogData = {
43007
43033
  */
43008
43034
  accountId: string;
43009
43035
  /**
43010
- * Meta ad account id (act_<n>).
43036
+ * Meta ad account id (act_<n>), or the Google customer id (digits only).
43011
43037
  */
43012
43038
  adAccountId: string;
43013
43039
  /**
@@ -43019,11 +43045,11 @@ type GetAdsActivityLogData = {
43019
43045
  */
43020
43046
  limit?: number;
43021
43047
  /**
43022
- * Client-side filter to one Meta object id (campaign, ad set or ad).
43048
+ * Client-side filter to one object id (campaign, ad set / ad group or ad).
43023
43049
  */
43024
43050
  objectId?: string;
43025
43051
  /**
43026
- * Start of range (YYYY-MM-DD).
43052
+ * Start of range (YYYY-MM-DD). Google: at most 29 days ago, the default.
43027
43053
  */
43028
43054
  since?: string;
43029
43055
  /**
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.1121",
39
+ version: "0.2.1123",
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.1121",
8
+ version: "0.2.1123",
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.1121",
3
+ "version": "0.2.1123",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -9847,7 +9847,9 @@ export const getAdCampaignDetails = <ThrowOnError extends boolean = false>(optio
9847
9847
  *
9848
9848
  * Google budget updates read the current budget before mutation. Shared budgets return
9849
9849
  * 409 unless allowSharedBudgetUpdate=true is explicitly supplied, because the change
9850
- * affects every campaign using that budget. Unknown sharing state also returns 409.
9850
+ * affects every campaign using that budget. A budget counts as shared when Google flags
9851
+ * it as shared or when more than one campaign uses it (older budgets can serve several
9852
+ * campaigns without the flag). Unknown sharing state also returns 409.
9851
9853
  *
9852
9854
  * `sharedBudgetId` (Google) moves the campaign onto a shared budget from
9853
9855
  * GET /v1/ads/shared-budgets, which also needs `allowSharedBudgetUpdate: true` (409
@@ -10699,7 +10701,16 @@ export const getAdPreviews = <ThrowOnError extends boolean = false>(options: Opt
10699
10701
  * not deliver, and every rejection reason with TikTok's suggestion and the piece of content it
10700
10702
  * refers to. Read-only, so it works on a paused ad without re-enabling it.
10701
10703
  *
10702
- * TikTok only (`/ad/review_info/`); every other platform returns 501. Use it alongside the ad's
10704
+ * **Google**: reads `ad_group_ad.policy_summary` live. `approvalStatus` and `reviewStatus` are
10705
+ * Google's verbatim (`approvalStatus`: APPROVED, APPROVED_LIMITED, AREA_OF_INTEREST_ONLY,
10706
+ * DISAPPROVED, UNKNOWN; `reviewStatus`: REVIEW_IN_PROGRESS, REVIEWED, UNDER_APPEAL,
10707
+ * ELIGIBLE_MAY_SERVE); `approved` is true for the three approved statuses, false for
10708
+ * DISAPPROVED, null otherwise. `policyTopics` carries every policy topic entry with its
10709
+ * `type` (PROHIBITED, LIMITED, ...) and Google's `evidences` and `constraints` verbatim; each
10710
+ * PROHIBITED topic is also listed in `rejections` (reason = the topic). The `forbidden*`
10711
+ * arrays are TikTok-only and always empty on Google.
10712
+ *
10713
+ * TikTok uses `/ad/review_info/`; every other platform returns 501. On TikTok, use it alongside the ad's
10703
10714
  * `platformStatus`: TikTok reports `AD_STATUS_AUDIT` while the ad is in review and
10704
10715
  * `AD_STATUS_AD_PRE_ONLINE` once it passed and is about to deliver (both map to
10705
10716
  * `status: pending_review`); `AD_STATUS_AUDIT_DENY` maps to `rejected`.
@@ -11057,6 +11068,19 @@ export const listAdsBusinessCenters = <ThrowOnError extends boolean = false>(opt
11057
11068
 
11058
11069
  /**
11059
11070
  * Ad account change / audit log
11071
+ * **Google**: reads the customer's `change_event` history, newest first. Google keeps 30 days
11072
+ * of it, so `since` defaults to 29 days ago and an older `since` returns 400; `until`
11073
+ * defaults to today. Each change is mapped onto the Meta row shape: `event_type` =
11074
+ * resource_change_operation (CREATE, UPDATE, REMOVE), `event_time` = change_date_time,
11075
+ * `actor_name` = user_email, `object_type` = change_resource_type, `object_id` = the last numeric id
11076
+ * of `object_resource_name`, `application_name` = client_type, `changed_fields` (array), and
11077
+ * `extra_data` = a JSON string `{ old, new }` with Google's old and new resource.
11078
+ * Pass `paging.after` back as `after` for the next page; it is null when nothing older is
11079
+ * left. A page never splits a change batch (the changes of one request share an
11080
+ * `event_time`), so a page can hold fewer rows than `limit` while more follow, or more
11081
+ * when one batch is larger than `limit`. `adAccountId` is the numeric customer id.
11082
+ *
11083
+ * **Meta**:
11060
11084
  * Account-level audit log from Meta's `/act_X/activities`: who changed what and when
11061
11085
  * (creates, edits, status flips, budget changes...) with Meta's translated event names and
11062
11086
  * the structured before/after in `extra_data`. Rows are returned verbatim. Meta has no
@@ -40725,7 +40725,7 @@ export type UpdateAdCampaignData = {
40725
40725
  */
40726
40726
  portfolioBidStrategyId?: string;
40727
40727
  /**
40728
- * Google only. Explicitly allow changing a shared campaign budget, affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40728
+ * Google only. Explicitly allow changing a shared campaign budget (flagged as shared by Google, or used by more than one campaign), affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40729
40729
  */
40730
40730
  allowSharedBudgetUpdate?: boolean;
40731
40731
  /**
@@ -42791,7 +42791,33 @@ export type GetAdReviewResponse = ({
42791
42791
  } | null;
42792
42792
  }>;
42793
42793
  /**
42794
- * When the verdict was read from TikTok.
42794
+ * Google only. ad_group_ad.policy_summary.approval_status, verbatim.
42795
+ */
42796
+ approvalStatus?: (string) | null;
42797
+ /**
42798
+ * Google only. ad_group_ad.policy_summary.policy_topic_entries.
42799
+ */
42800
+ policyTopics?: Array<{
42801
+ topic?: (string) | null;
42802
+ /**
42803
+ * PROHIBITED, LIMITED, FULLY_LIMITED, DESCRIPTIVE, BROADENING, AREA_OF_INTEREST_ONLY.
42804
+ */
42805
+ type?: (string) | null;
42806
+ /**
42807
+ * Google's PolicyTopicEvidence objects, verbatim.
42808
+ */
42809
+ evidences?: Array<{
42810
+ [key: string]: unknown;
42811
+ }>;
42812
+ /**
42813
+ * Google's PolicyTopicConstraint objects, verbatim.
42814
+ */
42815
+ constraints?: Array<{
42816
+ [key: string]: unknown;
42817
+ }>;
42818
+ }>;
42819
+ /**
42820
+ * When the verdict was read from the platform.
42795
42821
  */
42796
42822
  readAt?: string;
42797
42823
  };
@@ -43582,7 +43608,7 @@ export type GetAdsActivityLogData = {
43582
43608
  */
43583
43609
  accountId: string;
43584
43610
  /**
43585
- * Meta ad account id (act_<n>).
43611
+ * Meta ad account id (act_<n>), or the Google customer id (digits only).
43586
43612
  */
43587
43613
  adAccountId: string;
43588
43614
  /**
@@ -43594,11 +43620,11 @@ export type GetAdsActivityLogData = {
43594
43620
  */
43595
43621
  limit?: number;
43596
43622
  /**
43597
- * Client-side filter to one Meta object id (campaign, ad set or ad).
43623
+ * Client-side filter to one object id (campaign, ad set / ad group or ad).
43598
43624
  */
43599
43625
  objectId?: string;
43600
43626
  /**
43601
- * Start of range (YYYY-MM-DD).
43627
+ * Start of range (YYYY-MM-DD). Google: at most 29 days ago, the default.
43602
43628
  */
43603
43629
  since?: string;
43604
43630
  /**