@getlatedev/node 0.2.386 → 0.2.388

package/dist/index.d.mts

@@ -10371,7 +10371,13 @@ type SelectGoogleBusinessLocationResponse = ({
         username?: string;
         displayName?: string;
         isActive?: boolean;
+        /**
+         * Human-readable location display name, NOT a resource name. Do not use it to build API paths.
+         */
         selectedLocationName?: string;
+        /**
+         * Bare GBP location id. Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames.
+         */
         selectedLocationId?: string;
     };
 });
@@ -11438,7 +11444,7 @@ type UpdateGoogleBusinessServicesError = (ErrorResponse);
 type BatchGetGoogleBusinessReviewsData = {
     body: {
         /**
-         * Array of full location resource names (e.g. ['accounts/123/locations/456'])
+         * Array of full location resource names (e.g. ['accounts/123/locations/456']). Max 50 per request (Google's batchGetReviews cap); chunk larger sets into multiple requests.
          */
         locationNames: Array<(string)>;
         /**
@@ -11449,6 +11455,10 @@ type BatchGetGoogleBusinessReviewsData = {
          * Pagination token from previous response
          */
         pageToken?: string;
+        /**
+         * Sort order requested from Google. Defaults to 'updateTime desc' (newest first), which allows early-stopping pagination once results cross your date window.
+         */
+        orderBy?: 'updateTime desc' | 'rating' | 'rating desc';
     };
     path: {
         accountId: string;
@@ -11459,11 +11469,11 @@ type BatchGetGoogleBusinessReviewsResponse = ({
     accountId?: string;
     locationReviews?: Array<{
         /**
-         * Full review resource name (accounts*locations*reviews*)
+         * LOCATION resource name the review belongs to (accounts/{accountId}/locations/{locationId}) - NOT the review resource name. Use it to attribute the review to a location; the review identity is review.reviewId (full review resource name at review.name).
          */
         name?: string;
         /**
-         * The review object (reviewId, starRating, comment, reviewer, createTime, updateTime, reviewReply)
+         * The review object: reviewId (the review's identity), name (full review resource name, accounts*locations*reviews*), starRating, comment, reviewer, createTime, updateTime, reviewReply, and reviewMediaItems (review photos/videos; photo items carry thumbnailUrl, video items carry videoUrl)
          */
         review?: {
             [key: string]: unknown;
@@ -12806,7 +12816,13 @@ type AssignGoogleBusinessLocationResponse = ({
         username?: string;
         displayName?: string;
         isActive?: boolean;
+        /**
+         * Human-readable location display name (e.g. "Snap Fitness Dianella"), NOT a resource name. Do not use it to build API paths.
+         */
         selectedLocationName?: string;
+        /**
+         * Bare GBP location id (digits only). Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames.
+         */
         selectedLocationId?: string;
     };
 });
@@ -15604,11 +15620,23 @@ type ListInboxCommentsResponse = ({
         platform?: string;
         accountId?: string;
         accountUsername?: string;
+        /**
+         * The post text/caption. On ad rows (isAd: true) this is the AD NAME, not the underlying post's caption — the creative text isn't exposed here.
+         */
         content?: string;
+        /**
+         * Post media thumbnail. On ad rows this is the ad creative thumbnail.
+         */
         picture?: (string) | null;
+        /**
+         * Public URL of the post. On ad rows: the Facebook dark-post URL (facebook placement) or the IG media permalink (instagram placement); may be null when unknown.
+         */
         permalink?: (string) | null;
         createdTime?: string;
         commentCount?: number;
+        /**
+         * Not fetched for ad rows (always 0 there).
+         */
         likeCount?: number;
         /**
          * Bluesky content identifier
@@ -16404,10 +16432,21 @@ type ListInboxReviewsData = {
 type ListInboxReviewsResponse = ({
     status?: string;
     data?: Array<{
+        /**
+         * Review identifier. For Google Business this is the full review resource name (accounts/{accountId}/locations/{locationId}/reviews/{reviewId}), so it also encodes the location.
+         */
         id?: string;
         platform?: string;
         accountId?: string;
         accountUsername?: string;
+        /**
+         * Bare GBP location id the review belongs to. Google Business only; absent for other platforms.
+         */
+        locationId?: string;
+        /**
+         * Human-readable GBP location display name. Google Business only; absent for other platforms.
+         */
+        locationName?: (string) | null;
         reviewer?: {
             id?: (string) | null;
             name?: string;
@@ -23219,6 +23258,18 @@ type QueryAdInsightsData = {
          * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
          */
         accountId: string;
+        /**
+         * Comma-separated Meta attribution windows. Action values are returned keyed per window.
+         */
+        actionAttributionWindows?: string;
+        /**
+         * Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row.
+         */
+        actionBreakdowns?: string;
+        /**
+         * When actions are counted: impression, conversion or mixed.
+         */
+        actionReportTime?: string;
         /**
          * Cursor from paging.after of the previous page.
          */
@@ -23263,6 +23314,10 @@ type QueryAdInsightsData = {
          * End of range (YYYY-MM-DD); requires fromDate.
          */
         toDate?: string;
+        /**
+         * Use the ad sets' own attribution settings for action counting.
+         */
+        useUnifiedAttributionSetting?: boolean;
     };
 };
 type QueryAdInsightsResponse = ({
@@ -23299,6 +23354,22 @@ type CreateAdInsightsReportData = {
          * Comma-separated Graph breakdowns.
          */
         breakdowns?: string;
+        /**
+         * Comma-separated Graph action breakdowns (e.g. action_type,action_destination).
+         */
+        actionBreakdowns?: string;
+        /**
+         * Meta attribution windows (e.g. ["7d_click", "1d_view"]). Action values are returned keyed per window.
+         */
+        actionAttributionWindows?: Array<(string)>;
+        /**
+         * When actions are counted: impression, conversion or mixed.
+         */
+        actionReportTime?: string;
+        /**
+         * Use the ad sets' own attribution settings for action counting.
+         */
+        useUnifiedAttributionSetting?: boolean;
         /**
          * Meta filter objects, applied server-side.
          */
@@ -24401,6 +24472,38 @@ type CreateStandaloneAdData = {
              */
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
+        /**
+         * Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to
+         * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
+         * you control the card order and per-card copy/link. Requires top-level `body`,
+         * `linkUrl` and `callToAction`.
+         * Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`,
+         * `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal
+         * `catalog_sales`.
+         *
+         */
+        carouselCards?: Array<{
+            /**
+             * Card image; uploaded to the ad account and referenced by hash.
+             */
+            imageUrl: string;
+            /**
+             * Card destination URL. Defaults to the top-level linkUrl.
+             */
+            linkUrl?: string;
+            /**
+             * Card headline, shown below the card image.
+             */
+            headline?: string;
+            /**
+             * Card description, shown under the headline.
+             */
+            description?: string;
+            /**
+             * Card CTA override. Defaults to the top-level callToAction; same enum.
+             */
+            callToAction?: string;
+        }>;
         /**
          * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).

package/dist/index.d.ts

@@ -10371,7 +10371,13 @@ type SelectGoogleBusinessLocationResponse = ({
         username?: string;
         displayName?: string;
         isActive?: boolean;
+        /**
+         * Human-readable location display name, NOT a resource name. Do not use it to build API paths.
+         */
         selectedLocationName?: string;
+        /**
+         * Bare GBP location id. Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames.
+         */
         selectedLocationId?: string;
     };
 });
@@ -11438,7 +11444,7 @@ type UpdateGoogleBusinessServicesError = (ErrorResponse);
 type BatchGetGoogleBusinessReviewsData = {
     body: {
         /**
-         * Array of full location resource names (e.g. ['accounts/123/locations/456'])
+         * Array of full location resource names (e.g. ['accounts/123/locations/456']). Max 50 per request (Google's batchGetReviews cap); chunk larger sets into multiple requests.
          */
         locationNames: Array<(string)>;
         /**
@@ -11449,6 +11455,10 @@ type BatchGetGoogleBusinessReviewsData = {
          * Pagination token from previous response
          */
         pageToken?: string;
+        /**
+         * Sort order requested from Google. Defaults to 'updateTime desc' (newest first), which allows early-stopping pagination once results cross your date window.
+         */
+        orderBy?: 'updateTime desc' | 'rating' | 'rating desc';
     };
     path: {
         accountId: string;
@@ -11459,11 +11469,11 @@ type BatchGetGoogleBusinessReviewsResponse = ({
     accountId?: string;
     locationReviews?: Array<{
         /**
-         * Full review resource name (accounts*locations*reviews*)
+         * LOCATION resource name the review belongs to (accounts/{accountId}/locations/{locationId}) - NOT the review resource name. Use it to attribute the review to a location; the review identity is review.reviewId (full review resource name at review.name).
          */
         name?: string;
         /**
-         * The review object (reviewId, starRating, comment, reviewer, createTime, updateTime, reviewReply)
+         * The review object: reviewId (the review's identity), name (full review resource name, accounts*locations*reviews*), starRating, comment, reviewer, createTime, updateTime, reviewReply, and reviewMediaItems (review photos/videos; photo items carry thumbnailUrl, video items carry videoUrl)
          */
         review?: {
             [key: string]: unknown;
@@ -12806,7 +12816,13 @@ type AssignGoogleBusinessLocationResponse = ({
         username?: string;
         displayName?: string;
         isActive?: boolean;
+        /**
+         * Human-readable location display name (e.g. "Snap Fitness Dianella"), NOT a resource name. Do not use it to build API paths.
+         */
         selectedLocationName?: string;
+        /**
+         * Bare GBP location id (digits only). Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames.
+         */
         selectedLocationId?: string;
     };
 });
@@ -15604,11 +15620,23 @@ type ListInboxCommentsResponse = ({
         platform?: string;
         accountId?: string;
         accountUsername?: string;
+        /**
+         * The post text/caption. On ad rows (isAd: true) this is the AD NAME, not the underlying post's caption — the creative text isn't exposed here.
+         */
         content?: string;
+        /**
+         * Post media thumbnail. On ad rows this is the ad creative thumbnail.
+         */
         picture?: (string) | null;
+        /**
+         * Public URL of the post. On ad rows: the Facebook dark-post URL (facebook placement) or the IG media permalink (instagram placement); may be null when unknown.
+         */
         permalink?: (string) | null;
         createdTime?: string;
         commentCount?: number;
+        /**
+         * Not fetched for ad rows (always 0 there).
+         */
         likeCount?: number;
         /**
          * Bluesky content identifier
@@ -16404,10 +16432,21 @@ type ListInboxReviewsData = {
 type ListInboxReviewsResponse = ({
     status?: string;
     data?: Array<{
+        /**
+         * Review identifier. For Google Business this is the full review resource name (accounts/{accountId}/locations/{locationId}/reviews/{reviewId}), so it also encodes the location.
+         */
         id?: string;
         platform?: string;
         accountId?: string;
         accountUsername?: string;
+        /**
+         * Bare GBP location id the review belongs to. Google Business only; absent for other platforms.
+         */
+        locationId?: string;
+        /**
+         * Human-readable GBP location display name. Google Business only; absent for other platforms.
+         */
+        locationName?: (string) | null;
         reviewer?: {
             id?: (string) | null;
             name?: string;
@@ -23219,6 +23258,18 @@ type QueryAdInsightsData = {
          * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
          */
         accountId: string;
+        /**
+         * Comma-separated Meta attribution windows. Action values are returned keyed per window.
+         */
+        actionAttributionWindows?: string;
+        /**
+         * Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row.
+         */
+        actionBreakdowns?: string;
+        /**
+         * When actions are counted: impression, conversion or mixed.
+         */
+        actionReportTime?: string;
         /**
          * Cursor from paging.after of the previous page.
          */
@@ -23263,6 +23314,10 @@ type QueryAdInsightsData = {
          * End of range (YYYY-MM-DD); requires fromDate.
          */
         toDate?: string;
+        /**
+         * Use the ad sets' own attribution settings for action counting.
+         */
+        useUnifiedAttributionSetting?: boolean;
     };
 };
 type QueryAdInsightsResponse = ({
@@ -23299,6 +23354,22 @@ type CreateAdInsightsReportData = {
          * Comma-separated Graph breakdowns.
          */
         breakdowns?: string;
+        /**
+         * Comma-separated Graph action breakdowns (e.g. action_type,action_destination).
+         */
+        actionBreakdowns?: string;
+        /**
+         * Meta attribution windows (e.g. ["7d_click", "1d_view"]). Action values are returned keyed per window.
+         */
+        actionAttributionWindows?: Array<(string)>;
+        /**
+         * When actions are counted: impression, conversion or mixed.
+         */
+        actionReportTime?: string;
+        /**
+         * Use the ad sets' own attribution settings for action counting.
+         */
+        useUnifiedAttributionSetting?: boolean;
         /**
          * Meta filter objects, applied server-side.
          */
@@ -24401,6 +24472,38 @@ type CreateStandaloneAdData = {
              */
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
+        /**
+         * Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to
+         * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
+         * you control the card order and per-card copy/link. Requires top-level `body`,
+         * `linkUrl` and `callToAction`.
+         * Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`,
+         * `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal
+         * `catalog_sales`.
+         *
+         */
+        carouselCards?: Array<{
+            /**
+             * Card image; uploaded to the ad account and referenced by hash.
+             */
+            imageUrl: string;
+            /**
+             * Card destination URL. Defaults to the top-level linkUrl.
+             */
+            linkUrl?: string;
+            /**
+             * Card headline, shown below the card image.
+             */
+            headline?: string;
+            /**
+             * Card description, shown under the headline.
+             */
+            description?: string;
+            /**
+             * Card CTA override. Defaults to the top-level callToAction; same enum.
+             */
+            callToAction?: string;
+        }>;
         /**
          * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -1578,7 +1578,12 @@ export const updateGoogleBusinessServices = <ThrowOnError extends boolean = fals
  * Batch get reviews
  * Fetches reviews across multiple locations in a single request.
  * More efficient than calling GET /gmb-reviews per location for multi-location businesses.
- * Returns a flat list of individual reviews, each tagged with its review resource name.
+ * Returns a flat locationReviews array (not grouped by location): each item carries
+ * the location resource name it belongs to (`name`) plus the review object (`review`),
+ * whose identity is `review.reviewId`.
+ * Reviews are requested from Google ordered by `orderBy` (default `updateTime desc`,
+ * newest first), so callers polling for recent reviews can stop paginating once they
+ * cross their date window.
  * Note: this endpoint does not return aggregate metrics (averageRating / totalReviewCount).
  * For those, use the single-location GET /gmb-reviews endpoint.
  *

package/src/generated/types.gen.ts

@@ -9989,7 +9989,13 @@ export type SelectGoogleBusinessLocationResponse = ({
         username?: string;
         displayName?: string;
         isActive?: boolean;
+        /**
+         * Human-readable location display name, NOT a resource name. Do not use it to build API paths.
+         */
         selectedLocationName?: string;
+        /**
+         * Bare GBP location id. Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames.
+         */
         selectedLocationId?: string;
     };
 });
@@ -11121,7 +11127,7 @@ export type UpdateGoogleBusinessServicesError = (ErrorResponse);
 export type BatchGetGoogleBusinessReviewsData = {
     body: {
         /**
-         * Array of full location resource names (e.g. ['accounts/123/locations/456'])
+         * Array of full location resource names (e.g. ['accounts/123/locations/456']). Max 50 per request (Google's batchGetReviews cap); chunk larger sets into multiple requests.
          */
         locationNames: Array<(string)>;
         /**
@@ -11132,6 +11138,10 @@ export type BatchGetGoogleBusinessReviewsData = {
          * Pagination token from previous response
          */
         pageToken?: string;
+        /**
+         * Sort order requested from Google. Defaults to 'updateTime desc' (newest first), which allows early-stopping pagination once results cross your date window.
+         */
+        orderBy?: 'updateTime desc' | 'rating' | 'rating desc';
     };
     path: {
         accountId: string;
@@ -11143,11 +11153,11 @@ export type BatchGetGoogleBusinessReviewsResponse = ({
     accountId?: string;
     locationReviews?: Array<{
         /**
-         * Full review resource name (accounts*locations*reviews*)
+         * LOCATION resource name the review belongs to (accounts/{accountId}/locations/{locationId}) - NOT the review resource name. Use it to attribute the review to a location; the review identity is review.reviewId (full review resource name at review.name).
          */
         name?: string;
         /**
-         * The review object (reviewId, starRating, comment, reviewer, createTime, updateTime, reviewReply)
+         * The review object: reviewId (the review's identity), name (full review resource name, accounts*locations*reviews*), starRating, comment, reviewer, createTime, updateTime, reviewReply, and reviewMediaItems (review photos/videos; photo items carry thumbnailUrl, video items carry videoUrl)
          */
         review?: {
             [key: string]: unknown;
@@ -12595,7 +12605,13 @@ export type AssignGoogleBusinessLocationResponse = ({
         username?: string;
         displayName?: string;
         isActive?: boolean;
+        /**
+         * Human-readable location display name (e.g. "Snap Fitness Dianella"), NOT a resource name. Do not use it to build API paths.
+         */
         selectedLocationName?: string;
+        /**
+         * Bare GBP location id (digits only). Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames.
+         */
         selectedLocationId?: string;
     };
 });
@@ -15590,11 +15606,23 @@ export type ListInboxCommentsResponse = ({
         platform?: string;
         accountId?: string;
         accountUsername?: string;
+        /**
+         * The post text/caption. On ad rows (isAd: true) this is the AD NAME, not the underlying post's caption — the creative text isn't exposed here.
+         */
         content?: string;
+        /**
+         * Post media thumbnail. On ad rows this is the ad creative thumbnail.
+         */
         picture?: (string) | null;
+        /**
+         * Public URL of the post. On ad rows: the Facebook dark-post URL (facebook placement) or the IG media permalink (instagram placement); may be null when unknown.
+         */
         permalink?: (string) | null;
         createdTime?: string;
         commentCount?: number;
+        /**
+         * Not fetched for ad rows (always 0 there).
+         */
         likeCount?: number;
         /**
          * Bluesky content identifier
@@ -16447,10 +16475,21 @@ export type ListInboxReviewsData = {
 export type ListInboxReviewsResponse = ({
     status?: string;
     data?: Array<{
+        /**
+         * Review identifier. For Google Business this is the full review resource name (accounts/{accountId}/locations/{locationId}/reviews/{reviewId}), so it also encodes the location.
+         */
         id?: string;
         platform?: string;
         accountId?: string;
         accountUsername?: string;
+        /**
+         * Bare GBP location id the review belongs to. Google Business only; absent for other platforms.
+         */
+        locationId?: string;
+        /**
+         * Human-readable GBP location display name. Google Business only; absent for other platforms.
+         */
+        locationName?: (string) | null;
         reviewer?: {
             id?: (string) | null;
             name?: string;
@@ -23853,6 +23892,18 @@ export type QueryAdInsightsData = {
          * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
          */
         accountId: string;
+        /**
+         * Comma-separated Meta attribution windows. Action values are returned keyed per window.
+         */
+        actionAttributionWindows?: string;
+        /**
+         * Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row.
+         */
+        actionBreakdowns?: string;
+        /**
+         * When actions are counted: impression, conversion or mixed.
+         */
+        actionReportTime?: string;
         /**
          * Cursor from paging.after of the previous page.
          */
@@ -23897,6 +23948,10 @@ export type QueryAdInsightsData = {
          * End of range (YYYY-MM-DD); requires fromDate.
          */
         toDate?: string;
+        /**
+         * Use the ad sets' own attribution settings for action counting.
+         */
+        useUnifiedAttributionSetting?: boolean;
     };
 };
 
@@ -23936,6 +23991,22 @@ export type CreateAdInsightsReportData = {
          * Comma-separated Graph breakdowns.
          */
         breakdowns?: string;
+        /**
+         * Comma-separated Graph action breakdowns (e.g. action_type,action_destination).
+         */
+        actionBreakdowns?: string;
+        /**
+         * Meta attribution windows (e.g. ["7d_click", "1d_view"]). Action values are returned keyed per window.
+         */
+        actionAttributionWindows?: Array<(string)>;
+        /**
+         * When actions are counted: impression, conversion or mixed.
+         */
+        actionReportTime?: string;
+        /**
+         * Use the ad sets' own attribution settings for action counting.
+         */
+        useUnifiedAttributionSetting?: boolean;
         /**
          * Meta filter objects, applied server-side.
          */
@@ -25074,6 +25145,38 @@ export type CreateStandaloneAdData = {
              */
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
+        /**
+         * Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to
+         * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
+         * you control the card order and per-card copy/link. Requires top-level `body`,
+         * `linkUrl` and `callToAction`.
+         * Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`,
+         * `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal
+         * `catalog_sales`.
+         *
+         */
+        carouselCards?: Array<{
+            /**
+             * Card image; uploaded to the ad account and referenced by hash.
+             */
+            imageUrl: string;
+            /**
+             * Card destination URL. Defaults to the top-level linkUrl.
+             */
+            linkUrl?: string;
+            /**
+             * Card headline, shown below the card image.
+             */
+            headline?: string;
+            /**
+             * Card description, shown under the headline.
+             */
+            description?: string;
+            /**
+             * Card CTA override. Defaults to the top-level callToAction; same enum.
+             */
+            callToAction?: string;
+        }>;
         /**
          * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).