@getlatedev/node 0.2.945 → 0.2.947

package/src/generated/sdk.gen.ts

@@ -9398,6 +9398,12 @@ export const getAd = <ThrowOnError extends boolean = false>(options: OptionsLega
  * - **Performance Max**: top-level `assetGroup`, which swaps asset roles on the ad's asset
  * group. The other creative fields return 422 for this channel, and `assetGroup` returns
  * 422 on any other channel.
+ * - **Demand Gen**: top-level `demandGen` (see GoogleDemandGenUpdate): creative, channel
+ * and audience changes in one atomic Google request. The other creative fields return
+ * 422 for this channel. `targeting` takes locations, languages, `locationTargetingType`
+ * and `devices`; locations and languages are written to the ad's ad group, which
+ * Demand Gen requires (campaigns migrated from Discovery that still target on the
+ * campaign keep being written there), so they apply to every ad in that ad group.
  * - **LinkedIn**: status, budget, targeting (countries or regions, excludedLocations (countries),
  * the B2B facets, and audience segments; applied to the LinkedIn Campaign via
  * PARTIAL_UPDATE, and REPLACES the campaign's entire targetingCriteria, not a merge),
@@ -10958,7 +10964,8 @@ export const replaceGoogleListingGroupFilters = <ThrowOnError extends boolean =
  *
  * Google Demand Gen: set `campaignType: "demand_gen"` and supply `demandGen`. Creates a
  * daily budget, PAUSED campaign, one ad group and one ad in a single atomic request: a
- * multi-asset image ad, or a video responsive ad when `demandGen.youtubeVideoIds` is sent.
+ * multi-asset image ad, a video responsive ad when `demandGen.youtubeVideoIds` is sent, or
+ * a carousel ad (2 to 10 cards) when `demandGen.carouselCards` is sent.
  * Geo (countries, regions, cities, zips, metros) and languages go on the ad group, as
  * Demand Gen requires. `demandGen.channels` sets the ad group's channel controls and
  * `demandGen.audience` builds a Google Audience (user lists, interests, custom audiences,
@@ -10969,8 +10976,8 @@ export const replaceGoogleListingGroupFilters = <ThrowOnError extends boolean =
  * roasAverageFloor for target ROAS, LOWEST_COST_WITH_BID_CAP plus bidAmount for target
  * CPC. The created ad carries the native `platformCampaignId`, `platformAdSetId` (ad
  * group) and `platformAdId`. Activate with PUT /v1/ads/campaigns/{campaignId}/status;
- * budget, bidding and name are edited with the regular campaign endpoints. Creative and
- * targeting edits on an existing Demand Gen ad return 501 for now.
+ * 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`).
  *
  * Other mutually-exclusive request shapes are selected by the body:
  *

package/src/generated/types.gen.ts

@@ -5080,7 +5080,24 @@ export type GoogleCustomerConversionGoal = {
 };
 
 /**
- * Creative, channel and audience settings for a Google Demand Gen campaign (campaignType demand_gen). Creates one ad group with one ad: a multi-asset image ad, or a video responsive ad when youtubeVideoIds is sent.
+ * Created as a Google Audience and attached to the ad group. Send at least one dimension. Ids are numeric Google ids (user lists, interest categories, custom audiences) from the same customer.
+ */
+export type GoogleDemandGenAudience = {
+    userLists?: Array<(string)>;
+    userInterests?: Array<(string)>;
+    customAudiences?: Array<(string)>;
+    ageRanges?: Array<{
+        min: 18 | 25 | 35 | 45 | 55 | 65;
+        /**
+         * Omit for no upper bound.
+         */
+        max?: 24 | 34 | 44 | 54 | 64;
+    }>;
+    genders?: Array<('male' | 'female' | 'undetermined')>;
+};
+
+/**
+ * Creative, channel and audience settings for a Google Demand Gen campaign (campaignType demand_gen). Creates one ad group with one ad: a multi-asset image ad, a video responsive ad when youtubeVideoIds is sent, or a carousel ad when carouselCards is sent.
  */
 export type GoogleDemandGenInput = {
     /**
@@ -5090,20 +5107,23 @@ export type GoogleDemandGenInput = {
     finalUrl: string;
     businessName: string;
     /**
-     * Distinct texts.
+     * Distinct texts. A carousel ad takes exactly one.
      */
     headlines: Array<(string)>;
     /**
      * Video ads only, and required there.
      */
     longHeadlines?: Array<(string)>;
+    /**
+     * A carousel ad takes exactly one.
+     */
     descriptions: Array<(string)>;
     /**
-     * Image ads only. Call to action text such as 'Learn more'; Google picks one when omitted.
+     * Image and carousel ads only. Call to action text such as 'Learn more'; Google picks one when omitted.
      */
     callToAction?: string;
     /**
-     * Public image URLs. An image ad needs landscape or square; a video ad takes only one logo.
+     * Public image URLs. An image ad needs landscape or square; video and carousel ads take only one logo (carousel images go on each card).
      */
     images: {
         /**
@@ -5127,26 +5147,88 @@ export type GoogleDemandGenInput = {
      * Makes the ad a video responsive ad.
      */
     youtubeVideoIds?: Array<(string)>;
+    /**
+     * Makes the ad a carousel ad. Each card needs its own image (no two cards may share one); use the same image shape on every card. Card images are uploaded to the account's asset library before the campaign is created, validateOnly included (Google checks cards against existing images; identical images are reused, not duplicated).
+     */
+    carouselCards?: Array<{
+        headline: string;
+        /**
+         * Defaults to demandGen.finalUrl.
+         */
+        finalUrl?: string;
+        callToAction?: string;
+        images: {
+            /**
+             * 1.91:1.
+             */
+            landscape?: string;
+            /**
+             * 1:1.
+             */
+            square?: string;
+            /**
+             * 4:5.
+             */
+            portrait?: string;
+        };
+    }>;
     /**
      * Channel controls on the ad group. Only the listed channels serve; omit to serve on all of them.
      */
     channels?: Array<('youtube_in_stream' | 'youtube_in_feed' | 'youtube_shorts' | 'discover' | 'gmail' | 'display')>;
+    audience?: GoogleDemandGenAudience;
     /**
-     * Created as a Google Audience and attached to the ad group. Send at least one dimension. Ids are numeric Google ids (user lists, interest categories, custom audiences) from the same customer.
+     * Attach an existing Google Audience by numeric id instead of audience.
      */
-    audience?: {
-        userLists?: Array<(string)>;
-        userInterests?: Array<(string)>;
-        customAudiences?: Array<(string)>;
-        ageRanges?: Array<{
-            min: 18 | 25 | 35 | 45 | 55 | 65;
-            /**
-             * Omit for no upper bound.
-             */
-            max?: 24 | 34 | 44 | 54 | 64;
-        }>;
-        genders?: Array<('male' | 'female' | 'undetermined')>;
+    audienceId?: string;
+};
+
+/**
+ * Partial edit of a Google Demand Gen ad, sent in one atomic Google request. Every field
+ * you send replaces that whole field; fields you omit are kept. Which creative fields
+ * apply depends on the ad (read from Google): image ads take headlines, descriptions,
+ * businessName, callToAction and images (landscape, square, portrait, logo); video ads
+ * take headlines, longHeadlines, descriptions, businessName, youtubeVideoIds and exactly
+ * one images.logo; carousel ads take exactly one headline, one description, one logo,
+ * businessName and callToAction (their cards cannot be edited: create a new carousel ad).
+ * A field the ad does not take returns 422. New images are uploaded as new Google assets;
+ * the previous ones stay in the account's asset library.
+ *
+ * `channels`, `audience` and `audienceId` change the ad's ad group, so they apply to every
+ * ad in it. `audience` builds a new Google Audience and attaches it in place of the current
+ * one (the previous audience is detached, not deleted); `audienceId` attaches an existing
+ * one. Ad groups of campaigns migrated from Discovery use ungrouped audience segments,
+ * and Google refuses an Audience on them.
+ *
+ */
+export type GoogleDemandGenUpdate = {
+    finalUrl?: string;
+    businessName?: string;
+    headlines?: Array<(string)>;
+    /**
+     * Video ads only.
+     */
+    longHeadlines?: Array<(string)>;
+    descriptions?: Array<(string)>;
+    /**
+     * Image and carousel ads only.
+     */
+    callToAction?: string;
+    images?: {
+        landscape?: Array<(string)>;
+        square?: Array<(string)>;
+        portrait?: Array<(string)>;
+        logo?: Array<(string)>;
     };
+    /**
+     * Video ads only.
+     */
+    youtubeVideoIds?: Array<(string)>;
+    /**
+     * Replaces the ad group's channel controls; only the listed channels serve.
+     */
+    channels?: Array<('youtube_in_stream' | 'youtube_in_feed' | 'youtube_shorts' | 'discover' | 'gmail' | 'display')>;
+    audience?: GoogleDemandGenAudience;
     /**
      * Attach an existing Google Audience by numeric id instead of audience.
      */
@@ -37423,6 +37505,10 @@ export type UpdateAdData = {
          * Google Performance Max only. Replaces whole asset roles on the ad's asset group. Returns 422 on any other platform or channel.
          */
         assetGroup?: (GooglePmaxAssetGroupUpdate);
+        /**
+         * Google Demand Gen only. Returns 422 on any other platform or channel.
+         */
+        demandGen?: (GoogleDemandGenUpdate);
         status?: 'active' | 'paused';
         budget?: {
             /**