@getlatedev/node 0.2.1195 → 0.2.1197

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
@@ -7030,7 +7030,7 @@ type CtwaMultiResponse = {
7030
7030
  platformAdSetId: string;
7031
7031
  message: string;
7032
7032
  /**
7033
- * Present when Meta created the ad set differently from the request. Today: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button).
7033
+ * Present when Meta created the ad set differently from the request: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button), or the ad set joined a CBO campaign (`existingCampaignId`) whose own bid strategy applies, so a different `bidStrategy` or a `roasAverageFloor` that strategy cannot take was not applied.
7034
7034
  */
7035
7035
  warnings?: Array<(string)>;
7036
7036
  };
@@ -7051,7 +7051,7 @@ type CtwaSingleResponse = {
7051
7051
  };
7052
7052
  message: string;
7053
7053
  /**
7054
- * Present when Meta created the ad set differently from the request. Today: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button).
7054
+ * Present when Meta created the ad set differently from the request: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button), or the ad set joined a CBO campaign (`existingCampaignId`) whose own bid strategy applies, so a different `bidStrategy` or a `roasAverageFloor` that strategy cannot take was not applied.
7055
7055
  */
7056
7056
  warnings?: Array<(string)>;
7057
7057
  };
@@ -42172,6 +42172,8 @@ type UpdateAdSetData = {
42172
42172
  /**
42173
42173
  * Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Required when bidStrategy is
42174
42174
  * LOWEST_COST_WITH_MIN_ROAS. Sent to Meta as `bid_constraints.roas_average_floor` × 10000.
42175
+ * Meta only: may be sent alone, WITHOUT bidStrategy, to update the floor on an ad set
42176
+ * whose strategy (its own, or the campaign's under CBO) is LOWEST_COST_WITH_MIN_ROAS.
42175
42177
  * Not supported on OpenAI (422).
42176
42178
  *
42177
42179
  */
@@ -46423,6 +46425,10 @@ type ListAdAccountsData = {
46423
46425
  * Filter response to a single platform ad account ID (e.g. `act_123` for Meta, advertiser_id for TikTok). Returns at most one item.
46424
46426
  */
46425
46427
  adAccountId?: string;
46428
+ /**
46429
+ * Google Ads only. `true` returns only the customers this connection accepts as `adAccountId` (or `customerId`) on the other /v1/ads endpoints, i.e. those inside its ad-account selection. Without it every customer the Google login can reach is listed, including ones selected on another connection of the same login, which those endpoints answer with a 400. Ignored on other platforms.
46430
+ */
46431
+ inScopeOnly?: boolean;
46426
46432
  /**
46427
46433
  * Clamp the returned `accounts[]` length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.
46428
46434
  */
package/dist/index.d.ts CHANGED
@@ -7030,7 +7030,7 @@ type CtwaMultiResponse = {
7030
7030
  platformAdSetId: string;
7031
7031
  message: string;
7032
7032
  /**
7033
- * Present when Meta created the ad set differently from the request. Today: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button).
7033
+ * Present when Meta created the ad set differently from the request: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button), or the ad set joined a CBO campaign (`existingCampaignId`) whose own bid strategy applies, so a different `bidStrategy` or a `roasAverageFloor` that strategy cannot take was not applied.
7034
7034
  */
7035
7035
  warnings?: Array<(string)>;
7036
7036
  };
@@ -7051,7 +7051,7 @@ type CtwaSingleResponse = {
7051
7051
  };
7052
7052
  message: string;
7053
7053
  /**
7054
- * Present when Meta created the ad set differently from the request. Today: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button).
7054
+ * Present when Meta created the ad set differently from the request: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button), or the ad set joined a CBO campaign (`existingCampaignId`) whose own bid strategy applies, so a different `bidStrategy` or a `roasAverageFloor` that strategy cannot take was not applied.
7055
7055
  */
7056
7056
  warnings?: Array<(string)>;
7057
7057
  };
@@ -42172,6 +42172,8 @@ type UpdateAdSetData = {
42172
42172
  /**
42173
42173
  * Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Required when bidStrategy is
42174
42174
  * LOWEST_COST_WITH_MIN_ROAS. Sent to Meta as `bid_constraints.roas_average_floor` × 10000.
42175
+ * Meta only: may be sent alone, WITHOUT bidStrategy, to update the floor on an ad set
42176
+ * whose strategy (its own, or the campaign's under CBO) is LOWEST_COST_WITH_MIN_ROAS.
42175
42177
  * Not supported on OpenAI (422).
42176
42178
  *
42177
42179
  */
@@ -46423,6 +46425,10 @@ type ListAdAccountsData = {
46423
46425
  * Filter response to a single platform ad account ID (e.g. `act_123` for Meta, advertiser_id for TikTok). Returns at most one item.
46424
46426
  */
46425
46427
  adAccountId?: string;
46428
+ /**
46429
+ * Google Ads only. `true` returns only the customers this connection accepts as `adAccountId` (or `customerId`) on the other /v1/ads endpoints, i.e. those inside its ad-account selection. Without it every customer the Google login can reach is listed, including ones selected on another connection of the same login, which those endpoints answer with a 400. Ignored on other platforms.
46430
+ */
46431
+ inScopeOnly?: boolean;
46426
46432
  /**
46427
46433
  * Clamp the returned `accounts[]` length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.
46428
46434
  */
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.1195",
39
+ version: "0.2.1197",
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.1195",
8
+ version: "0.2.1197",
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.1195",
3
+ "version": "0.2.1197",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -10480,9 +10480,14 @@ export const getAdSetDetails = <ThrowOnError extends boolean = false>(options: O
10480
10480
  * - `LOWEST_COST_WITH_BID_CAP` / `COST_CAP`: `bidAmount` REQUIRED (whole currency units).
10481
10481
  * - `LOWEST_COST_WITH_MIN_ROAS`: `roasAverageFloor` REQUIRED (decimal multiplier, e.g. 2.0 = 2.0x ROAS).
10482
10482
  * - Meta only: send `bidAmount` WITHOUT `bidStrategy` to change the cap amount on an ad set
10483
- * under a COST_CAP / LOWEST_COST_WITH_BID_CAP parent campaign, leaving the strategy itself
10484
- * (inherited from the campaign) untouched. `roasAverageFloor` without `bidStrategy` is
10485
- * rejected (it has no meaning outside LOWEST_COST_WITH_MIN_ROAS).
10483
+ * whose strategy (its own, or the campaign's under CBO) is COST_CAP / LOWEST_COST_WITH_BID_CAP,
10484
+ * leaving the strategy untouched. Send `roasAverageFloor` WITHOUT `bidStrategy` the same way
10485
+ * to change the floor of a LOWEST_COST_WITH_MIN_ROAS ad set. Either field against an
10486
+ * incompatible current strategy is a 400.
10487
+ * - Meta CBO (the campaign holds the budget): the campaign also holds the bid strategy, so only
10488
+ * `bidAmount` or `roasAverageFloor` is written on the ad set. A `bidStrategy` equal to the
10489
+ * campaign's is accepted; a different one is a 409 (change it with
10490
+ * PUT /v1/ads/campaigns/{campaignId}).
10486
10491
  *
10487
10492
  * Delivery settings are validated by Meta against the campaign objective;
10488
10493
  * incompatible combinations (e.g. a billingEvent the optimization goal
@@ -5219,7 +5219,7 @@ export type CtwaMultiResponse = {
5219
5219
  platformAdSetId: string;
5220
5220
  message: string;
5221
5221
  /**
5222
- * Present when Meta created the ad set differently from the request. Today: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button).
5222
+ * Present when Meta created the ad set differently from the request: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button), or the ad set joined a CBO campaign (`existingCampaignId`) whose own bid strategy applies, so a different `bidStrategy` or a `roasAverageFloor` that strategy cannot take was not applied.
5223
5223
  */
5224
5224
  warnings?: Array<(string)>;
5225
5225
  };
@@ -5242,7 +5242,7 @@ export type CtwaSingleResponse = {
5242
5242
  };
5243
5243
  message: string;
5244
5244
  /**
5245
- * Present when Meta created the ad set differently from the request. Today: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button).
5245
+ * Present when Meta created the ad set differently from the request: Meta kept the ad set without the requested `whatsappPhoneNumber` in its promoted_object (the ads still carry it on their WhatsApp button), or the ad set joined a CBO campaign (`existingCampaignId`) whose own bid strategy applies, so a different `bidStrategy` or a `roasAverageFloor` that strategy cannot take was not applied.
5246
5246
  */
5247
5247
  warnings?: Array<(string)>;
5248
5248
  };
@@ -42654,6 +42654,8 @@ export type UpdateAdSetData = {
42654
42654
  /**
42655
42655
  * Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Required when bidStrategy is
42656
42656
  * LOWEST_COST_WITH_MIN_ROAS. Sent to Meta as `bid_constraints.roas_average_floor` × 10000.
42657
+ * Meta only: may be sent alone, WITHOUT bidStrategy, to update the floor on an ad set
42658
+ * whose strategy (its own, or the campaign's under CBO) is LOWEST_COST_WITH_MIN_ROAS.
42657
42659
  * Not supported on OpenAI (422).
42658
42660
  *
42659
42661
  */
@@ -47202,6 +47204,10 @@ export type ListAdAccountsData = {
47202
47204
  * Filter response to a single platform ad account ID (e.g. `act_123` for Meta, advertiser_id for TikTok). Returns at most one item.
47203
47205
  */
47204
47206
  adAccountId?: string;
47207
+ /**
47208
+ * Google Ads only. `true` returns only the customers this connection accepts as `adAccountId` (or `customerId`) on the other /v1/ads endpoints, i.e. those inside its ad-account selection. Without it every customer the Google login can reach is listed, including ones selected on another connection of the same login, which those endpoints answer with a 400. Ignored on other platforms.
47209
+ */
47210
+ inScopeOnly?: boolean;
47205
47211
  /**
47206
47212
  * Clamp the returned `accounts[]` length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.
47207
47213
  */