@getlatedev/node 0.2.940 → 0.2.942

package/src/generated/types.gen.ts

@@ -4737,6 +4737,69 @@ export type GoogleAdLabelAssignments = {
     keywordIds?: Array<(string)>;
 };
 
+/**
+ * A Google Ads account inside a manager tree.
+ */
+export type GoogleAdsHierarchyClient = {
+    /**
+     * Native Google Ads customer id, digits only.
+     */
+    customerId?: string;
+    /**
+     * Null for a pending invitation.
+     */
+    name?: (string) | null;
+    currency?: (string) | null;
+    timeZone?: (string) | null;
+    /**
+     * True for a sub-manager account.
+     */
+    manager?: boolean;
+    testAccount?: boolean;
+    /**
+     * Hidden in the manager's Google Ads UI.
+     */
+    hidden?: boolean;
+    /**
+     * Distance from the root (1 = direct client of the root).
+     */
+    level?: number;
+    /**
+     * Google customer status: ENABLED, CANCELED, SUSPENDED or CLOSED. Null for a pending invitation.
+     */
+    status?: (string) | null;
+    /**
+     * Direct manager of this account. Null only when more than 50 managers under the root were skipped.
+     */
+    parentCustomerId?: (string) | null;
+    /**
+     * Id of the link to the parent, used by PATCH /v1/ads/accounts/manager-links.
+     */
+    managerLinkId?: (string) | null;
+    linkStatus?: ('ACTIVE' | 'PENDING') | null;
+};
+
+export type linkStatus = 'ACTIVE' | 'PENDING';
+
+export type GoogleAdsManagerLink = {
+    managerCustomerId?: string;
+    clientCustomerId?: string;
+    /**
+     * Null on a validateOnly invitation, where Google creates nothing.
+     */
+    managerLinkId?: (string) | null;
+    /**
+     * Status the link has after this call.
+     */
+    status?: 'PENDING' | 'ACTIVE' | 'REFUSED' | 'CANCELED' | 'INACTIVE';
+    validateOnly?: boolean;
+};
+
+/**
+ * Status the link has after this call.
+ */
+export type status12 = 'PENDING' | 'ACTIVE' | 'REFUSED' | 'CANCELED' | 'INACTIVE';
+
 /**
  * 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).
  */
@@ -5190,6 +5253,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 status13 = 'applied' | 'dismissed' | 'failed';
+
 export type GoogleRsaDescription = {
     text: string;
     /**
@@ -5320,7 +5439,7 @@ export type kind = 'phone' | 'email';
 
 export type region = 'US' | 'GB';
 
-export type status12 = 'ordering' | 'activating' | 'active' | 'suspended' | 'canceled' | 'failed';
+export type status14 = 'ordering' | 'activating' | 'active' | 'suspended' | 'canceled' | 'failed';
 
 /**
  * Attachment snapshot inside an edit-history entry.
@@ -5392,7 +5511,7 @@ export type InboxWebhookConversation = {
     contactId?: string;
 };
 
-export type status13 = 'active' | 'archived';
+export type status15 = 'active' | 'archived';
 
 /**
  * The conversation object included in conversation lifecycle webhook payloads (conversation.started, conversation.control_changed).
@@ -6979,7 +7098,7 @@ export type OwnedPhoneNumber = {
     }>;
 };
 
-export type status14 = 'pending_payment' | 'pending_regulatory' | 'regulatory_declined' | 'provisioning' | 'verifying' | 'active' | 'suspended' | 'releasing' | 'released';
+export type status16 = 'pending_payment' | 'pending_regulatory' | 'regulatory_declined' | 'provisioning' | 'verifying' | 'active' | 'suspended' | 'releasing' | 'released';
 
 export type metaVerificationStatus = 'pending' | 'code_requested' | 'verified' | 'expired';
 
@@ -7104,7 +7223,7 @@ export type PlatformAnalytics = {
     errorMessage?: (string) | null;
 };
 
-export type status15 = 'published' | 'failed';
+export type status17 = 'published' | 'failed';
 
 /**
  * Sync state of analytics for this platform
@@ -7506,7 +7625,7 @@ export type Product = {
 
 export type platform8 = 'shopify';
 
-export type status16 = 'active' | 'draft' | 'archived';
+export type status18 = 'active' | 'draft' | 'archived';
 
 export type ProductImage = {
     url?: string;
@@ -8782,7 +8901,7 @@ export type UploadTokenResponse = {
     status?: 'pending' | 'completed' | 'expired';
 };
 
-export type status17 = 'pending' | 'completed' | 'expired';
+export type status19 = 'pending' | 'completed' | 'expired';
 
 export type UploadTokenStatusResponse = {
     token?: string;
@@ -9281,7 +9400,7 @@ export type Verification = {
     resend?: boolean;
 };
 
-export type status18 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
+export type status20 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
 
 export type channel4 = 'sms';
 
@@ -9408,7 +9527,7 @@ export type WebhookLog = {
 /**
  * Delivery outcome
  */
-export type status19 = 'success' | 'failed';
+export type status21 = 'success' | 'failed';
 
 /**
  * Webhook payload for `account.ads.initial_sync_completed` events.
@@ -9520,7 +9639,7 @@ export type event = 'account.ads.initial_sync_completed';
 /**
  * Overall outcome of the initial sync.
  */
-export type status20 = 'success' | 'failure';
+export type status22 = 'success' | 'failure';
 
 /**
  * Stable category for UX branching. New values may be added; existing ones are
@@ -11473,7 +11592,7 @@ export type event22 = 'post.platform.published' | 'post.platform.failed' | 'post
 /**
  * Terminal status this event fires on. Matches the event suffix.
  */
-export type status21 = 'published' | 'failed' | 'deleted';
+export type status23 = 'published' | 'failed' | 'deleted';
 
 /**
  * Webhook payload for reaction received events (WhatsApp, Telegram, Slack, Instagram, Facebook Messenger, TikTok)
@@ -11739,7 +11858,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 status22 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
+export type status24 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
 
 /**
  * Webhook payload for the `whatsapp.template.category_updated` event.
@@ -11888,7 +12007,7 @@ export type event30 = 'whatsapp.template.status_updated';
  * request before the template is actually removed.
  *
  */
-export type status23 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
+export type status25 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
 
 export type WhatsAppBodyComponent = {
     type: 'body';
@@ -12042,7 +12161,7 @@ export type WhatsAppSandboxSession = {
  * list responses.
  *
  */
-export type status24 = 'pending' | 'active';
+export type status26 = 'pending' | 'active';
 
 export type WhatsAppTemplateButton = {
     type: 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
@@ -12200,7 +12319,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 status25 = 'success' | 'failed' | 'pending';
+export type status27 = 'success' | 'failed' | 'pending';
 
 /**
  * A node in a workflow graph. `config` shape depends on `type`.
@@ -35291,6 +35410,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: {
         /**
@@ -40578,6 +40794,137 @@ export type RemoveAccountStructuredSnippetError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
+export type GetAdAccountHierarchyData = {
+    query: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Only return the tree rooted at this customer id (digits only). It must be an account the Google user accesses directly. Omit to list every tree.
+         */
+        adAccountId?: string;
+        /**
+         * Alias of adAccountId, kept for consistency with the other Google Ads account endpoints.
+         * @deprecated
+         */
+        customerId?: string;
+    };
+};
+
+export type GetAdAccountHierarchyResponse = ({
+    accountId?: string;
+    roots?: Array<{
+        /**
+         * Native Google Ads customer id, digits only.
+         */
+        customerId?: string;
+        name?: (string) | null;
+        /**
+         * ISO 4217 code.
+         */
+        currency?: (string) | null;
+        /**
+         * IANA time zone, e.g. Europe/Madrid.
+         */
+        timeZone?: (string) | null;
+        /**
+         * True for a manager (MCC) account.
+         */
+        manager?: boolean;
+        testAccount?: boolean;
+        /**
+         * Google customer status: ENABLED, CANCELED, SUSPENDED or CLOSED.
+         */
+        status?: (string) | null;
+        /**
+         * Managers linked to this account, ACTIVE or PENDING.
+         */
+        managerLinks?: Array<{
+            managerCustomerId?: string;
+            managerLinkId?: string;
+            status?: 'ACTIVE' | 'PENDING';
+        }>;
+        /**
+         * Every account under this root at any depth, in Google's order, followed by pending invitations.
+         */
+        clients?: Array<GoogleAdsHierarchyClient>;
+    }>;
+    unavailable?: Array<{
+        customerId?: string;
+        /**
+         * Google's error message and code.
+         */
+        reason?: string;
+    }>;
+    truncated?: boolean;
+    /**
+     * When this data was fetched from Google. Null on a live read.
+     */
+    cachedAt?: (string) | null;
+    /**
+     * True when Google's quota was exhausted and this is the last successful fetch.
+     */
+    stale?: boolean;
+});
+
+export type GetAdAccountHierarchyError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type InviteAdAccountToManagerData = {
+    body: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Manager customer id, digits only.
+         */
+        managerCustomerId: string;
+        /**
+         * Client customer id to invite, digits only.
+         */
+        clientCustomerId: string;
+        validateOnly?: boolean;
+    };
+};
+
+export type InviteAdAccountToManagerResponse = (GoogleAdsManagerLink);
+
+export type InviteAdAccountToManagerError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type UpdateAdAccountManagerLinkData = {
+    body: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Manager customer id, digits only.
+         */
+        managerCustomerId: string;
+        /**
+         * Client customer id, digits only.
+         */
+        clientCustomerId: string;
+        /**
+         * Numeric link id from GET /v1/ads/accounts/hierarchy.
+         */
+        managerLinkId: string;
+        action: 'accept' | 'decline' | 'cancel' | 'unlink';
+        validateOnly?: boolean;
+    };
+};
+
+export type UpdateAdAccountManagerLinkResponse = (GoogleAdsManagerLink);
+
+export type UpdateAdAccountManagerLinkError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type GetAdAccountFinanceData = {
     query: {
         /**