@getlatedev/node 0.2.941 → 0.2.943

package/src/generated/types.gen.ts

@@ -2949,6 +2949,14 @@ export type ConversionAction = {
      * Google's ConversionActionCategory, e.g. DEFAULT, PURCHASE, LEAD.
      */
     category: string;
+    /**
+     * Google's ConversionOrigin, e.g. WEBSITE, APP. Together with category it names the goal the action belongs to (see GET /v1/ads/conversions/goals).
+     */
+    origin?: string;
+    /**
+     * true = primary (counts toward bidding when its goal is biddable), false = secondary. Change it with PATCH /v1/ads/conversions/actions/{actionId}.
+     */
+    primaryForGoal?: boolean;
     /**
      * The code a customer pastes onto their site. Present for types
      * Google generates a snippet for (e.g. WEBPAGE); empty otherwise.
@@ -4737,6 +4745,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).
  */
@@ -4795,6 +4866,18 @@ export type GoogleAssetUpdate = {
     structuredSnippetAsset?: GoogleStructuredSnippet;
 };
 
+export type GoogleBiddableGoalInput = {
+    /**
+     * Google ConversionActionCategory, e.g. PURCHASE, SIGNUP, SUBMIT_LEAD_FORM
+     */
+    category: string;
+    /**
+     * Google ConversionOrigin, e.g. WEBSITE, APP, CALL_FROM_ADS, STORE, GOOGLE_HOSTED
+     */
+    origin: string;
+    biddable: boolean;
+};
+
 /**
  * Text and single image only (no videos). Supports STANDARD, EVENT, OFFER, and ALERT post types. Posts appear on Google Business Profile, Google Search, and Maps. Use locationId for multi-location posting. Schedule dates accept both ISO 8601 strings (e.g. '2026-04-15T09:00:00Z') and Google's native {year, month, day} objects.
  */
@@ -4952,6 +5035,50 @@ export type GoogleBusinessReview = {
  */
 export type starRating = 'ONE' | 'TWO' | 'THREE' | 'FOUR' | 'FIVE';
 
+export type GoogleCampaignConversionGoals = {
+    campaignId?: string;
+    goalConfigLevel?: 'CUSTOMER' | 'CAMPAIGN' | 'UNSPECIFIED' | 'UNKNOWN';
+    customConversionGoalId?: (string) | null;
+    goals?: Array<{
+        category?: string;
+        origin?: string;
+        biddable?: boolean;
+        resourceName?: string;
+    }>;
+};
+
+export type goalConfigLevel = 'CUSTOMER' | 'CAMPAIGN' | 'UNSPECIFIED' | 'UNKNOWN';
+
+export type GoogleCustomConversionGoal = {
+    id?: string;
+    resourceName?: string;
+    name?: string;
+    status?: string;
+    conversionActionIds?: Array<(string)>;
+};
+
+export type GoogleCustomerConversionGoal = {
+    category?: string;
+    origin?: string;
+    /**
+     * Used for bidding and counted in the Conversions column.
+     */
+    biddable?: boolean;
+    resourceName?: string;
+    /**
+     * Non-removed conversion actions in this category and origin.
+     */
+    conversionActions?: Array<{
+        id?: string;
+        name?: string;
+        status?: string;
+        /**
+         * true = primary, false = secondary
+         */
+        primaryForGoal?: boolean;
+    }>;
+};
+
 /**
  * Exactly one key. Omit the value (for example { productBrand: {} }) for the everything-else node of that level.
  */
@@ -5190,62 +5317,6 @@ 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;
     /**
@@ -35347,103 +35418,6 @@ 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: {
         /**
@@ -40731,6 +40705,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: {
         /**
@@ -45122,6 +45227,281 @@ export type CreateConversionActionError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
+export type ListAdConversionGoalsData = {
+    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 ListAdConversionGoalsResponse = ({
+    customerId?: string;
+    goals?: Array<GoogleCustomerConversionGoal>;
+    cachedAt?: (string) | null;
+    stale?: boolean;
+});
+
+export type ListAdConversionGoalsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type UpdateAdConversionGoalsData = {
+    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;
+        goals: Array<GoogleBiddableGoalInput>;
+    };
+};
+
+export type UpdateAdConversionGoalsResponse = ({
+    customerId?: string;
+    goals?: Array<GoogleCustomerConversionGoal>;
+});
+
+export type UpdateAdConversionGoalsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type UpdateConversionActionData = {
+    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;
+        /**
+         * true = primary, false = secondary
+         */
+        primaryForGoal: boolean;
+    };
+    path: {
+        /**
+         * Google conversion action id
+         */
+        actionId: string;
+    };
+};
+
+export type UpdateConversionActionResponse = ({
+    customerId?: string;
+    action?: {
+        id?: string;
+        primaryForGoal?: boolean;
+    };
+});
+
+export type UpdateConversionActionError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type ListCustomConversionGoalsData = {
+    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 ListCustomConversionGoalsResponse = ({
+    customerId?: string;
+    goals?: Array<GoogleCustomConversionGoal>;
+    cachedAt?: (string) | null;
+    stale?: boolean;
+});
+
+export type ListCustomConversionGoalsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type CreateCustomConversionGoalData = {
+    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;
+        conversionActionIds: Array<(string)>;
+    };
+};
+
+export type CreateCustomConversionGoalResponse = ({
+    customerId?: string;
+    id?: string;
+    resourceName?: string;
+});
+
+export type CreateCustomConversionGoalError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type UpdateCustomConversionGoalData = {
+    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;
+        /**
+         * Replaces the whole set.
+         */
+        conversionActionIds?: Array<(string)>;
+    };
+    path: {
+        /**
+         * Google custom conversion goal id
+         */
+        goalId: string;
+    };
+};
+
+export type UpdateCustomConversionGoalResponse = ({
+    customerId?: string;
+    goal?: GoogleCustomConversionGoal;
+});
+
+export type UpdateCustomConversionGoalError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type RemoveCustomConversionGoalData = {
+    path: {
+        /**
+         * Google custom conversion goal id
+         */
+        goalId: 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 RemoveCustomConversionGoalResponse = ({
+    customerId?: string;
+    goalId?: string;
+    /**
+     * Always true on success
+     */
+    removed?: boolean;
+});
+
+export type RemoveCustomConversionGoalError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type GetCampaignConversionGoalsData = {
+    path: {
+        /**
+         * Google campaign id
+         */
+        campaignId: string;
+    };
+};
+
+export type GetCampaignConversionGoalsResponse = ((GoogleCampaignConversionGoals & {
+    customerId?: string;
+    cachedAt?: (string) | null;
+    stale?: boolean;
+}));
+
+export type GetCampaignConversionGoalsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type UpdateCampaignConversionGoalsData = {
+    body: {
+        goals?: Array<GoogleBiddableGoalInput>;
+        goalConfigLevel?: 'CUSTOMER' | 'CAMPAIGN';
+        /**
+         * Custom goal to bid on, or null to clear
+         */
+        customConversionGoalId?: (string) | null;
+    };
+    path: {
+        /**
+         * Google campaign id
+         */
+        campaignId: string;
+    };
+};
+
+export type UpdateCampaignConversionGoalsResponse = ((GoogleCampaignConversionGoals & {
+    customerId?: string;
+}));
+
+export type UpdateCampaignConversionGoalsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type ListConversionDestinationsData = {
     path: {
         /**