@getlatedev/node 0.2.947 → 0.2.949

package/dist/index.d.mts

@@ -36456,6 +36456,10 @@ type UpdateCampaignTargetingData = {
 };
 type UpdateCampaignTargetingResponse = ({
     campaignId?: string;
+    /**
+     * Demand Gen only: the ad group that received the locations and languages.
+     */
+    adGroupId?: string;
     /**
      * Which targeting fields were applied.
      */
@@ -41693,6 +41697,11 @@ type CreateStandaloneAdData = {
          * `budgetAmount`/`budgetType` and bidding fields
          * (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`)
          * return 400 on this shape; the ad group already owns them.
+         * With `campaignType: "demand_gen"` the ad group must belong to a
+         * Demand Gen campaign (otherwise 400); `demandGen` carries only the
+         * ad's creative, the new ad is created PAUSED, and ad group settings
+         * (geo, languages, `demandGen.channels`/`audience`/`audienceId`/
+         * `adGroupName`) return 400. `validateOnly` is supported.
          *
          */
         adSetId?: string;
@@ -41713,7 +41722,12 @@ type CreateStandaloneAdData = {
          * Ads: create a new ad group under this EXISTING campaign;
          * the new ad group inherits the campaign's budget, so omit
          * `budgetAmount`/`budgetType` (and any bidding field), or
-         * the request returns 400. On failure only the entities we
+         * the request returns 400. With `campaignType: "demand_gen"` the
+         * campaign must be a Demand Gen campaign (otherwise 400): the new ad
+         * group (with its geo, languages, channels and audience from the
+         * request) and its ad are created in one atomic request, the ad
+         * group PAUSED; schedule and `locationTargetingType` belong to the
+         * campaign and return 400. On failure only the entities we
          * authored are cleaned up; the pre-existing parent is left
          * untouched and is never (re)activated. Mutually exclusive
          * with `adSetId` and `creatives[]`.

package/dist/index.d.ts

@@ -36456,6 +36456,10 @@ type UpdateCampaignTargetingData = {
 };
 type UpdateCampaignTargetingResponse = ({
     campaignId?: string;
+    /**
+     * Demand Gen only: the ad group that received the locations and languages.
+     */
+    adGroupId?: string;
     /**
      * Which targeting fields were applied.
      */
@@ -41693,6 +41697,11 @@ type CreateStandaloneAdData = {
          * `budgetAmount`/`budgetType` and bidding fields
          * (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`)
          * return 400 on this shape; the ad group already owns them.
+         * With `campaignType: "demand_gen"` the ad group must belong to a
+         * Demand Gen campaign (otherwise 400); `demandGen` carries only the
+         * ad's creative, the new ad is created PAUSED, and ad group settings
+         * (geo, languages, `demandGen.channels`/`audience`/`audienceId`/
+         * `adGroupName`) return 400. `validateOnly` is supported.
          *
          */
         adSetId?: string;
@@ -41713,7 +41722,12 @@ type CreateStandaloneAdData = {
          * Ads: create a new ad group under this EXISTING campaign;
          * the new ad group inherits the campaign's budget, so omit
          * `budgetAmount`/`budgetType` (and any bidding field), or
-         * the request returns 400. On failure only the entities we
+         * the request returns 400. With `campaignType: "demand_gen"` the
+         * campaign must be a Demand Gen campaign (otherwise 400): the new ad
+         * group (with its geo, languages, channels and audience from the
+         * request) and its ad are created in one atomic request, the ad
+         * group PAUSED; schedule and `locationTargetingType` belong to the
+         * campaign and return 400. On failure only the entities we
          * authored are cleaned up; the pre-existing parent is left
          * untouched and is never (re)activated. Mutually exclusive
          * with `adSetId` and `creatives[]`.

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -9083,6 +9083,14 @@ export const getCampaignTargeting = <ThrowOnError extends boolean = false>(optio
  * read back from Google after the edit, and invalidates the cached copy
  * `GET` on this campaign would otherwise keep serving.
  *
+ * **Demand Gen:** Google keeps a Demand Gen campaign's locations and languages on its
+ * ad groups and refuses them on the campaign. When the campaign has one ad group they are
+ * written there and the response carries its `adGroupId` (the campaign-level
+ * `locations`/`languages` read back then stay empty). With several ad groups the call
+ * returns 400 naming them: edit each one with PUT /v1/ads/{adId} `targeting` on an ad of
+ * that ad group. Campaigns migrated from Discovery that still target on the campaign keep
+ * being written there. `devices` and `locationTargetingType` stay campaign-level.
+ *
  */
 export const updateCampaignTargeting = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateCampaignTargetingData, ThrowOnError>) => {
     return (options?.client ?? client).put<UpdateCampaignTargetingResponse, UpdateCampaignTargetingError, ThrowOnError>({
@@ -10978,6 +10986,10 @@ export const replaceGoogleListingGroupFilters = <ThrowOnError extends boolean =
  * group) and `platformAdId`. Activate with PUT /v1/ads/campaigns/{campaignId}/status;
  * budget, bidding and name are edited with the regular campaign endpoints; creative,
  * channels, audience and ad group targeting with PUT /v1/ads/{adId} (`demandGen`, `targeting`).
+ * To grow an existing Demand Gen campaign, send `existingCampaignId` (adds a PAUSED ad group,
+ * with its own geo, languages, channels and audience, plus its ad) or `adSetId` (adds a
+ * PAUSED ad to that ad group); neither takes budget, bidding or schedule fields, and both
+ * support `validateOnly`.
  *
  * Other mutually-exclusive request shapes are selected by the body:
  *

package/src/generated/types.gen.ts

@@ -36791,6 +36791,10 @@ export type UpdateCampaignTargetingData = {
 
 export type UpdateCampaignTargetingResponse = ({
     campaignId?: string;
+    /**
+     * Demand Gen only: the ad group that received the locations and languages.
+     */
+    adGroupId?: string;
     /**
      * Which targeting fields were applied.
      */
@@ -42351,6 +42355,11 @@ export type CreateStandaloneAdData = {
          * `budgetAmount`/`budgetType` and bidding fields
          * (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`)
          * return 400 on this shape; the ad group already owns them.
+         * With `campaignType: "demand_gen"` the ad group must belong to a
+         * Demand Gen campaign (otherwise 400); `demandGen` carries only the
+         * ad's creative, the new ad is created PAUSED, and ad group settings
+         * (geo, languages, `demandGen.channels`/`audience`/`audienceId`/
+         * `adGroupName`) return 400. `validateOnly` is supported.
          *
          */
         adSetId?: string;
@@ -42371,7 +42380,12 @@ export type CreateStandaloneAdData = {
          * Ads: create a new ad group under this EXISTING campaign;
          * the new ad group inherits the campaign's budget, so omit
          * `budgetAmount`/`budgetType` (and any bidding field), or
-         * the request returns 400. On failure only the entities we
+         * the request returns 400. With `campaignType: "demand_gen"` the
+         * campaign must be a Demand Gen campaign (otherwise 400): the new ad
+         * group (with its geo, languages, channels and audience from the
+         * request) and its ad are created in one atomic request, the ad
+         * group PAUSED; schedule and `locationTargetingType` belong to the
+         * campaign and return 400. On failure only the entities we
          * authored are cleaned up; the pre-existing parent is left
          * untouched and is never (re)activated. Mutually exclusive
          * with `adSetId` and `creatives[]`.