@getlatedev/node 0.2.939 → 0.2.941

package/src/generated/types.gen.ts

@@ -4682,6 +4682,61 @@ export type GeoRestriction = {
     countries: Array<(string)>;
 };
 
+export type GoogleAdLabel = {
+    /**
+     * Google label id
+     */
+    id?: string;
+    resourceName?: string;
+    name?: string;
+    status?: 'ENABLED' | 'REMOVED' | 'UNKNOWN';
+    /**
+     * #RRGGBB
+     */
+    backgroundColor?: (string) | null;
+    /**
+     * Null when empty.
+     */
+    description?: (string) | null;
+};
+
+export type status11 = 'ENABLED' | 'REMOVED' | 'UNKNOWN';
+
+/**
+ * At least one id across the four target lists. Up to 1000 ids per list.
+ */
+export type GoogleAdLabelAssignments = {
+    /**
+     * Zernio SocialAccount id (Google Ads)
+     */
+    accountId: string;
+    /**
+     * Google customer id. Required when the connection has multiple customers.
+     */
+    adAccountId?: string;
+    /**
+     * Alias of adAccountId
+     * @deprecated
+     */
+    customerId?: string;
+    /**
+     * Google campaign ids
+     */
+    campaignIds?: Array<(string)>;
+    /**
+     * Google ad group ids
+     */
+    adSetIds?: Array<(string)>;
+    /**
+     * Google ad group ad ids, {adGroupId}~{adId}
+     */
+    adIds?: Array<(string)>;
+    /**
+     * Google keyword criterion ids, {adGroupId}~{criterionId}
+     */
+    keywordIds?: Array<(string)>;
+};
+
 /**
  * Link one asset to the asset group. Send exactly one of asset (an existing asset), text, imageUrl or youtubeVideoId (new content, created in the same request).
  */
@@ -5135,6 +5190,62 @@ export type GooglePmaxAssetGroupUpdate = {
     youtubeVideoIds?: Array<(string)>;
 };
 
+export type GoogleRecommendation = {
+    /**
+     * customers/{customerId}/recommendations/{id}. Pass it to apply or dismiss.
+     */
+    resourceName: string;
+    id: string;
+    /**
+     * Google RecommendationType, such as CAMPAIGN_BUDGET, KEYWORD or SET_TARGET_CPA.
+     */
+    type: string;
+    dismissed: boolean;
+    campaignId: (string) | null;
+    /**
+     * Every campaign the recommendation targets (several for account-level types).
+     */
+    campaignIds: Array<(string)>;
+    adGroupId: (string) | null;
+    campaignBudgetId: (string) | null;
+    /**
+     * Google's estimate over its own window. Null when Google gives none for the type.
+     */
+    impact: {
+        base?: GoogleRecommendationMetrics;
+        potential?: GoogleRecommendationMetrics;
+    } | null;
+    /**
+     * The type-specific recommendation payload exactly as Google returns it (camelCase, amounts in micros), for example recommendedTargetCpaMicros or budgetOptions.
+     */
+    details: {
+        [key: string]: unknown;
+    } | null;
+};
+
+export type GoogleRecommendationMetrics = {
+    impressions?: number;
+    clicks?: number;
+    /**
+     * Account currency units.
+     */
+    cost?: number;
+    conversions?: number;
+    conversionsValue?: number;
+    videoViews?: number;
+};
+
+export type GoogleRecommendationResult = {
+    resourceName: string;
+    status: 'applied' | 'dismissed' | 'failed';
+    /**
+     * Google's message when status is failed.
+     */
+    error?: string;
+};
+
+export type status12 = 'applied' | 'dismissed' | 'failed';
+
 export type GoogleRsaDescription = {
     text: string;
     /**
@@ -5265,7 +5376,7 @@ export type kind = 'phone' | 'email';
 
 export type region = 'US' | 'GB';
 
-export type status11 = 'ordering' | 'activating' | 'active' | 'suspended' | 'canceled' | 'failed';
+export type status13 = 'ordering' | 'activating' | 'active' | 'suspended' | 'canceled' | 'failed';
 
 /**
  * Attachment snapshot inside an edit-history entry.
@@ -5337,7 +5448,7 @@ export type InboxWebhookConversation = {
     contactId?: string;
 };
 
-export type status12 = 'active' | 'archived';
+export type status14 = 'active' | 'archived';
 
 /**
  * The conversation object included in conversation lifecycle webhook payloads (conversation.started, conversation.control_changed).
@@ -6924,7 +7035,7 @@ export type OwnedPhoneNumber = {
     }>;
 };
 
-export type status13 = 'pending_payment' | 'pending_regulatory' | 'regulatory_declined' | 'provisioning' | 'verifying' | 'active' | 'suspended' | 'releasing' | 'released';
+export type status15 = 'pending_payment' | 'pending_regulatory' | 'regulatory_declined' | 'provisioning' | 'verifying' | 'active' | 'suspended' | 'releasing' | 'released';
 
 export type metaVerificationStatus = 'pending' | 'code_requested' | 'verified' | 'expired';
 
@@ -7049,7 +7160,7 @@ export type PlatformAnalytics = {
     errorMessage?: (string) | null;
 };
 
-export type status14 = 'published' | 'failed';
+export type status16 = 'published' | 'failed';
 
 /**
  * Sync state of analytics for this platform
@@ -7451,7 +7562,7 @@ export type Product = {
 
 export type platform8 = 'shopify';
 
-export type status15 = 'active' | 'draft' | 'archived';
+export type status17 = 'active' | 'draft' | 'archived';
 
 export type ProductImage = {
     url?: string;
@@ -8727,7 +8838,7 @@ export type UploadTokenResponse = {
     status?: 'pending' | 'completed' | 'expired';
 };
 
-export type status16 = 'pending' | 'completed' | 'expired';
+export type status18 = 'pending' | 'completed' | 'expired';
 
 export type UploadTokenStatusResponse = {
     token?: string;
@@ -9226,7 +9337,7 @@ export type Verification = {
     resend?: boolean;
 };
 
-export type status17 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
+export type status19 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
 
 export type channel4 = 'sms';
 
@@ -9353,7 +9464,7 @@ export type WebhookLog = {
 /**
  * Delivery outcome
  */
-export type status18 = 'success' | 'failed';
+export type status20 = 'success' | 'failed';
 
 /**
  * Webhook payload for `account.ads.initial_sync_completed` events.
@@ -9465,7 +9576,7 @@ export type event = 'account.ads.initial_sync_completed';
 /**
  * Overall outcome of the initial sync.
  */
-export type status19 = 'success' | 'failure';
+export type status21 = 'success' | 'failure';
 
 /**
  * Stable category for UX branching. New values may be added; existing ones are
@@ -11418,7 +11529,7 @@ export type event22 = 'post.platform.published' | 'post.platform.failed' | 'post
 /**
  * Terminal status this event fires on. Matches the event suffix.
  */
-export type status20 = 'published' | 'failed' | 'deleted';
+export type status22 = 'published' | 'failed' | 'deleted';
 
 /**
  * Webhook payload for reaction received events (WhatsApp, Telegram, Slack, Instagram, Facebook Messenger, TikTok)
@@ -11684,7 +11795,7 @@ export type platform15 = 'whatsapp';
 /**
  * Normalized from Meta's `decision` (REJECTED -> DECLINED, DEFERRED -> PENDING_REVIEW; the review is still open on DEFERRED, not a rejection).
  */
-export type status21 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
+export type status23 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
 
 /**
  * Webhook payload for the `whatsapp.template.category_updated` event.
@@ -11833,7 +11944,7 @@ export type event30 = 'whatsapp.template.status_updated';
  * request before the template is actually removed.
  *
  */
-export type status22 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
+export type status24 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
 
 export type WhatsAppBodyComponent = {
     type: 'body';
@@ -11987,7 +12098,7 @@ export type WhatsAppSandboxSession = {
  * list responses.
  *
  */
-export type status23 = 'pending' | 'active';
+export type status25 = 'pending' | 'active';
 
 export type WhatsAppTemplateButton = {
     type: 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
@@ -12145,7 +12256,7 @@ export type WorkflowExecutionEvent = {
 
 export type action2 = 'execution_started' | 'execution_completed' | 'execution_exited' | 'execution_paused' | 'execution_resumed' | 'node_started' | 'node_completed' | 'node_failed' | 'node_skipped';
 
-export type status24 = 'success' | 'failed' | 'pending';
+export type status26 = 'success' | 'failed' | 'pending';
 
 /**
  * A node in a workflow graph. `config` shape depends on `type`.
@@ -35236,6 +35347,103 @@ export type GetAdsSearchTermsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
+export type ListGoogleRecommendationsData = {
+    query: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Google customer id, digits only. Defaults to the connection's only customer.
+         */
+        adAccountId?: string;
+        /**
+         * Only recommendations targeting this campaign.
+         */
+        campaignId?: string;
+        /**
+         * Alias of adAccountId, kept for consistency with other Google endpoints.
+         * @deprecated
+         */
+        customerId?: string;
+        /**
+         * Comma-separated Google RecommendationType values, for example CAMPAIGN_BUDGET,KEYWORD,SET_TARGET_CPA.
+         */
+        types?: string;
+    };
+};
+
+export type ListGoogleRecommendationsResponse = ({
+    adAccountId: string;
+    recommendations: Array<GoogleRecommendation>;
+    cachedAt: (string) | null;
+    stale: boolean;
+});
+
+export type ListGoogleRecommendationsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type ApplyGoogleRecommendationsData = {
+    body: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Google customer id, digits only. Required when the connection has several customers.
+         */
+        adAccountId?: string;
+        recommendations: Array<{
+            /**
+             * Recommendation resource name from the list, or its id.
+             */
+            resourceName: string;
+            /**
+             * One key, such as campaignBudget, keyword, textAd, targetCpaOptIn, targetRoasOptIn, callAsset, calloutAsset, sitelinkAsset, moveUnusedBudget, responsiveSearchAd, responsiveSearchAdAsset, responsiveSearchAdImproveAdStrength, useBroadMatchKeyword, raiseTargetCpa, lowerTargetRoas, setTargetCpa, setTargetRoas, forecastingSetTargetCpa, forecastingSetTargetRoas, leadFormAsset, raiseTargetCpaBidTooLow, raiseTargetCpaPerformanceBidTooLow, lowerTargetRoasPerformanceBidTooLow, calloutExtension, callExtension or sitelinkExtension.
+             */
+            parameters?: {
+                [key: string]: unknown;
+            };
+        }>;
+    };
+};
+
+export type ApplyGoogleRecommendationsResponse = ({
+    adAccountId: string;
+    results: Array<GoogleRecommendationResult>;
+});
+
+export type ApplyGoogleRecommendationsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type DismissGoogleRecommendationsData = {
+    body: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Google customer id, digits only. Required when the connection has several customers.
+         */
+        adAccountId?: string;
+        /**
+         * Recommendation resource names from the list, or their ids.
+         */
+        resourceNames: Array<(string)>;
+    };
+};
+
+export type DismissGoogleRecommendationsResponse = ({
+    adAccountId: string;
+    results: Array<GoogleRecommendationResult>;
+});
+
+export type DismissGoogleRecommendationsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type ListBidStrategiesData = {
     query: {
         /**
@@ -39162,40 +39370,229 @@ export type ListMetaBusinessesError = (unknown | {
 export type ListAdLabelsData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id. For Meta, the posting or ads variant used to resolve the token.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Meta ad account id (act_<n>), or the Google Ads customer id (digits only).
          */
-        adAccountId: string;
+        adAccountId?: string;
         /**
-         * Cursor from paging.after of the previous page.
+         * Meta only. Cursor from paging.after of the previous page.
          */
         after?: string;
         /**
-         * Rows per page
+         * Google only. Alias of adAccountId, kept for existing callers.
+         * @deprecated
+         */
+        customerId?: string;
+        /**
+         * Meta only. Rows per page.
          */
         limit?: number;
     };
 };
 
 export type ListAdLabelsResponse = ({
+    /**
+     * Meta act_<n>, or the resolved Google customer id
+     */
     adAccountId?: string;
-    data?: Array<{
-        [key: string]: unknown;
-    }>;
+    data?: Array<(GoogleAdLabel | {
+    [key: string]: unknown;
+})>;
     paging?: {
         /**
-         * Cursor for the next page; null when exhausted.
+         * Cursor for the next page; null when exhausted (always null on Google).
          */
         after?: (string) | null;
     };
+    /**
+     * Google only. When the served list was fetched from Google.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * Google only. True when Google quota was exhausted and the last cached list was served.
+     */
+    stale?: boolean;
 });
 
-export type ListAdLabelsError = (unknown | {
+export type ListAdLabelsError = (ErrorResponse | {
     error?: string;
-} | ErrorResponse);
+} | unknown);
+
+export type CreateAdLabelData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (Google Ads)
+         */
+        accountId: string;
+        /**
+         * Google customer id. Required when the connection has multiple customers.
+         */
+        adAccountId?: string;
+        /**
+         * Alias of adAccountId
+         * @deprecated
+         */
+        customerId?: string;
+        /**
+         * Trimmed before sending.
+         */
+        name: string;
+        /**
+         * #RRGGBB. Google picks a color when omitted.
+         */
+        backgroundColor?: string;
+        description?: string;
+    };
+};
+
+export type CreateAdLabelResponse = ({
+    customerId?: string;
+    /**
+     * Google label id
+     */
+    id?: string;
+    /**
+     * customers/{customerId}/labels/{id}
+     */
+    resourceName?: string;
+});
+
+export type CreateAdLabelError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type UpdateAdLabelData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (Google Ads)
+         */
+        accountId: string;
+        /**
+         * Google customer id. Required when the connection has multiple customers.
+         */
+        adAccountId?: string;
+        /**
+         * Alias of adAccountId
+         * @deprecated
+         */
+        customerId?: string;
+        name?: string;
+        backgroundColor?: string;
+        /**
+         * Send "" to clear it.
+         */
+        description?: string;
+    };
+    path: {
+        /**
+         * Google label id
+         */
+        labelId: string;
+    };
+};
+
+export type UpdateAdLabelResponse = ({
+    customerId?: string;
+    label?: GoogleAdLabel;
+});
+
+export type UpdateAdLabelError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type RemoveAdLabelData = {
+    path: {
+        /**
+         * Google label id
+         */
+        labelId: string;
+    };
+    query: {
+        /**
+         * Zernio SocialAccount id (Google Ads)
+         */
+        accountId: string;
+        /**
+         * Google customer id. Required when the connection has multiple customers.
+         */
+        adAccountId?: string;
+        /**
+         * Alias of adAccountId
+         * @deprecated
+         */
+        customerId?: string;
+    };
+};
+
+export type RemoveAdLabelResponse = ({
+    customerId?: string;
+    labelId?: string;
+    /**
+     * Always true on success
+     */
+    removed?: boolean;
+});
+
+export type RemoveAdLabelError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type AttachAdLabelData = {
+    body: GoogleAdLabelAssignments;
+    path: {
+        /**
+         * Google label id
+         */
+        labelId: string;
+    };
+};
+
+export type AttachAdLabelResponse = ({
+    customerId?: string;
+    labelId?: string;
+    /**
+     * Links created by this call
+     */
+    attached?: number;
+    /**
+     * Targets that already carried the label
+     */
+    unchanged?: number;
+});
+
+export type AttachAdLabelError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type DetachAdLabelData = {
+    body: GoogleAdLabelAssignments;
+    path: {
+        /**
+         * Google label id
+         */
+        labelId: string;
+    };
+};
+
+export type DetachAdLabelResponse = ({
+    customerId?: string;
+    labelId?: string;
+    /**
+     * Links removed by this call
+     */
+    detached?: number;
+    /**
+     * Targets that did not carry the label
+     */
+    unchanged?: number;
+});
+
+export type DetachAdLabelError = (ErrorResponse | {
+    error?: string;
+} | unknown);
 
 export type ListHighDemandPeriodsData = {
     query: {