@zernio/node 0.2.717 → 0.2.719

package/src/generated/types.gen.ts

@@ -1858,6 +1858,50 @@ export type CampaignAnalyticsResponse = {
     };
 };
 
+/**
+ * A Google campaign's current bidding, mapped onto the same triplet PUT /v1/ads/campaigns/{campaignId} accepts.
+ */
+export type CampaignBidding = {
+    /**
+     * campaign.advertising_channel_type. COST_CAP's underlying Google field differs by channel; see bidStrategy on PUT.
+     */
+    channel?: 'SEARCH' | 'DISPLAY';
+    /**
+     * Google's raw enum: MAXIMIZE_CONVERSIONS, TARGET_CPA, MAXIMIZE_CONVERSION_VALUE, TARGET_ROAS, TARGET_SPEND, MANUAL_CPC, TARGET_IMPRESSION_SHARE, or another Google adds later.
+     */
+    biddingStrategyType?: string;
+    /**
+     * Null when the campaign is on a strategy PUT does not model (Manual CPC, Target Impression Share, ...); show biddingStrategyType instead in that case.
+     */
+    bidSpec?: {
+        bidStrategy?: BidStrategy;
+        /**
+         * Whole currency units. Present for COST_CAP and LOWEST_COST_WITH_BID_CAP, and omitted when the campaign is on a bare TARGET_SPEND with no CPC ceiling set.
+         */
+        bidAmount?: number;
+        /**
+         * Decimal ROAS multiplier (2.0 = 2.0x). Present for LOWEST_COST_WITH_MIN_ROAS.
+         */
+        roasAverageFloor?: number;
+        /**
+         * Present alone (bidStrategy omitted) when the campaign is on a portfolio strategy; see portfolio.
+         */
+        portfolioBidStrategyId?: string;
+    } | null;
+    /**
+     * Set only when the campaign is on a portfolio bid strategy (campaign.bidding_strategy); null otherwise.
+     */
+    portfolio?: {
+        id?: string;
+        name?: string;
+    } | null;
+};
+
+/**
+ * campaign.advertising_channel_type. COST_CAP's underlying Google field differs by channel; see bidStrategy on PUT.
+ */
+export type channel2 = 'SEARCH' | 'DISPLAY';
+
 /**
  * Who a comment automation answers. Instagram only - Meta exposes the follow
  * relationship on no other platform, and only for people who have MESSAGED the
@@ -1992,6 +2036,55 @@ export type ConnectedApp = {
     tokenCount?: number;
 };
 
+/**
+ * A Google Ads conversion action, e.g. a WEBPAGE conversion created via
+ * `createConversionAction`. Returned by `listConversionActions` and
+ * `createConversionAction`.
+ *
+ */
+export type ConversionAction = {
+    /**
+     * Google Ads conversion action id.
+     */
+    id: string;
+    name: string;
+    /**
+     * Google's ConversionActionType, e.g. WEBPAGE, UPLOAD_CLICKS.
+     */
+    type: string;
+    /**
+     * Google's ConversionActionStatus, e.g. ENABLED, REMOVED, HIDDEN.
+     */
+    status: string;
+    /**
+     * Google's ConversionActionCategory, e.g. DEFAULT, PURCHASE, LEAD.
+     */
+    category: string;
+    /**
+     * The code a customer pastes onto their site. Present for types
+     * Google generates a snippet for (e.g. WEBPAGE); empty otherwise.
+     *
+     */
+    tagSnippets: Array<{
+        /**
+         * Google's TrackingCodeType, e.g. WEBPAGE.
+         */
+        type: string;
+        /**
+         * Google's TrackingCodePageFormat, e.g. HTML, AMP.
+         */
+        pageFormat?: string;
+        /**
+         * The gtag.js snippet to install once per site.
+         */
+        globalSiteTag?: string;
+        /**
+         * The per-conversion-page snippet that fires the event.
+         */
+        eventSnippet?: string;
+    }>;
+};
+
 /**
  * A discoverable conversion destination on an ad platform — a Meta pixel,
  * Google conversion action, or LinkedIn conversion rule. Returned by
@@ -4954,6 +5047,51 @@ export type errorCategory = 'auth_expired' | 'user_content' | 'user_abuse' | 'ac
  */
 export type errorSource = 'user' | 'platform' | 'system';
 
+/**
+ * A Google Ads portfolio bid strategy: a named bidding strategy shared across campaigns, with its R.130 report metrics over the queried date range.
+ */
+export type PortfolioBidStrategy = {
+    /**
+     * Numeric bid strategy id; pass as portfolioBidStrategyId or in the {strategyId} path.
+     */
+    id?: string;
+    name?: string;
+    type?: 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
+    /**
+     * ENABLED or REMOVED.
+     */
+    status?: string;
+    /**
+     * Number of campaigns currently attached.
+     */
+    campaignCount?: number;
+    clicks?: number;
+    /**
+     * Cost in the account's currency units (converted from micros).
+     */
+    cost?: number;
+    /**
+     * Cost per conversion in the account's currency units.
+     */
+    costPerConversion?: number;
+    impressions?: number;
+    /**
+     * Average CPC in the account's currency units.
+     */
+    averageCpc?: number;
+    conversions?: number;
+    /**
+     * Current target, in the account's currency units. Null for a ROAS-family type (TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE), or a Maximize type with no target set. Pre-fills the edit form's target field.
+     */
+    targetCpa?: (number) | null;
+    /**
+     * Current target as a decimal multiplier (2.0 = 2.0x). Null for a CPA-family type (TARGET_CPA, MAXIMIZE_CONVERSIONS), or a Maximize type with no target set.
+     */
+    targetRoas?: (number) | null;
+};
+
+export type type8 = 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
+
 export type Post = {
     _id?: string;
     userId?: (string | User);
@@ -6222,7 +6360,7 @@ export type UploadedFile = {
     mimeType?: string;
 };
 
-export type type8 = 'image' | 'video' | 'document';
+export type type9 = 'image' | 'video' | 'document';
 
 export type UploadTokenResponse = {
     token?: string;
@@ -6708,7 +6846,7 @@ export type Verification = {
 
 export type status11 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
 
-export type channel2 = 'sms';
+export type channel3 = 'sms';
 
 /**
  * Individual webhook configuration for receiving real-time notifications
@@ -9301,7 +9439,7 @@ export type WhatsAppTemplateButton = {
     navigate_screen?: string;
 };
 
-export type type9 = 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
+export type type10 = 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
 
 /**
  * Required when type is otp
@@ -9463,7 +9601,7 @@ export type WorkflowNode = {
  * integrations (webhook, ai, handoff, start_call).
  *
  */
-export type type10 = 'trigger' | 'send_message' | 'wait_for_reply' | 'condition' | 'set_variable' | 'delay' | 'webhook' | 'ai' | 'handoff' | 'start_call' | 'a_b_split' | 'set_field' | 'enroll_sequence' | 'add_tag' | 'remove_tag' | 'end';
+export type type11 = 'trigger' | 'send_message' | 'wait_for_reply' | 'condition' | 'set_variable' | 'delay' | 'webhook' | 'ai' | 'handoff' | 'start_call' | 'a_b_split' | 'set_field' | 'enroll_sequence' | 'add_tag' | 'remove_tag' | 'end';
 
 /**
  * A single X API operation with its per-call price and the Zernio platform methods that trigger it.
@@ -9599,7 +9737,7 @@ export type XArticleBlock = {
     entity_ranges?: Array<XArticleEntityRange>;
 };
 
-export type type11 = 'unstyled' | 'header-one' | 'header-two' | 'header-three' | 'unordered-list-item' | 'ordered-list-item' | 'blockquote' | 'atomic';
+export type type12 = 'unstyled' | 'header-one' | 'header-two' | 'header-three' | 'unordered-list-item' | 'ordered-list-item' | 'blockquote' | 'atomic';
 
 /**
  * X's snake_case content-state shape. Standard DraftJS camelCase fields such as entityMap, inlineStyleRanges, and entityRanges are rejected.
@@ -9678,7 +9816,7 @@ export type XArticleEntity = {
 
 export type mutability = 'immutable' | 'mutable' | 'segmented';
 
-export type type12 = 'divider' | 'latex';
+export type type13 = 'divider' | 'latex';
 
 /**
  * The referenced entity must exist, and offset plus length must not exceed the containing block's text length.
@@ -30379,6 +30517,111 @@ export type GetAdsSearchTermsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
+export type ListBidStrategiesData = {
+    query: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+         */
+        customerId?: string;
+        /**
+         * Defaults to 30 days ago.
+         */
+        fromDate?: string;
+        /**
+         * Defaults to today.
+         */
+        toDate?: string;
+    };
+};
+
+export type ListBidStrategiesResponse = ({
+    customerId?: string;
+    /**
+     * Account currency code; money fields are in this currency's units.
+     */
+    currency?: string;
+    strategies?: Array<PortfolioBidStrategy>;
+});
+
+export type ListBidStrategiesError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type CreateBidStrategyData = {
+    body: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+         */
+        customerId?: string;
+        name: string;
+        type: 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
+        /**
+         * Required when type is TARGET_CPA, in the account's currency units.
+         */
+        targetCpa?: number;
+        /**
+         * Required when type is TARGET_ROAS; a multiplier (2.0 = 2.0x).
+         */
+        targetRoas?: number;
+    };
+};
+
+export type CreateBidStrategyResponse = ({
+    strategy?: {
+        customerId?: string;
+        /**
+         * Numeric bid strategy id; pass as portfolioBidStrategyId or in the {strategyId} path.
+         */
+        id?: string;
+        resourceName?: string;
+    };
+});
+
+export type CreateBidStrategyError = (unknown | {
+    error?: string;
+});
+
+export type UpdateBidStrategyData = {
+    body: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+         */
+        customerId?: string;
+        name?: string;
+        type?: 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
+        targetCpa?: number;
+        targetRoas?: number;
+    };
+    path: {
+        /**
+         * Numeric Google Ads bid strategy id.
+         */
+        strategyId: string;
+    };
+};
+
+export type UpdateBidStrategyResponse = ({
+    strategy?: {
+        customerId?: string;
+    };
+});
+
+export type UpdateBidStrategyError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type ListLocalServicesLeadsData = {
     query: {
         /**
@@ -30728,17 +30971,21 @@ export type CreateAdCampaignData = {
         budgetType?: 'daily' | 'lifetime';
         status?: 'ACTIVE' | 'PAUSED';
         /**
-         * Campaign bid strategy. Meta stores `bid_strategy` alongside the budget, so this REQUIRES `budgetAmount` + `budgetType` on the same request; sending it without a campaign budget is a 400. A campaign carrying a strategy without its `bid_amount` makes every ad set created under it fail with an error that names the ad set (code 100, subcode 1815857), so the bad state is rejected up front rather than accepted. To bid at ad-set level, set the strategy there instead.
+         * Campaign bid strategy. Meta stores `bid_strategy` alongside the budget, so this REQUIRES `budgetAmount` + `budgetType` on the same request; sending it without a campaign budget is a 400. A campaign carrying a strategy without its `bid_amount` makes every ad set created under it fail with an error that names the ad set (code 100, subcode 1815857), so the bad state is rejected up front rather than accepted. To bid at ad-set level on Meta, set the strategy there instead. On Google: LOWEST_COST_WITHOUT_CAP = Maximize Conversions, COST_CAP + bidAmount = Target CPA, LOWEST_COST_WITH_MIN_ROAS + roasAverageFloor = Target ROAS, LOWEST_COST_WITH_BID_CAP + bidAmount = Maximize Clicks with a CPC ceiling; portfolioBidStrategyId attaches a portfolio strategy instead.
          */
         bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
         /**
-         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise. Validated here but NOT stored by Meta: the campaign object has no bid_amount field, only bid_strategy lives on it. The amount takes effect once an ad set joins this campaign (existingCampaignId on POST /v1/ads/create) and supplies its own bidAmount there.
+         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise. On Meta, validated here but NOT stored: the campaign object has no bid_amount field, only bid_strategy lives on it, and the amount takes effect once an ad set joins this campaign (existingCampaignId on POST /v1/ads/create) and supplies its own bidAmount there. On Google, stored directly on the campaign's bidding strategy.
          */
         bidAmount?: number;
         /**
          * Decimal ROAS multiplier (2.0 = 2.0x). Required for LOWEST_COST_WITH_MIN_ROAS.
          */
         roasAverageFloor?: number;
+        /**
+         * Google only. Attach an existing portfolio bid strategy (numeric id from GET /v1/ads/bid-strategies) to the new campaign instead of a standard one. Exclusive with bidStrategy.
+         */
+        portfolioBidStrategyId?: string;
     };
     headers?: {
         /**
@@ -30801,6 +31048,37 @@ export type UpdateAdCampaignStatusError = (unknown | {
     error?: string;
 });
 
+export type GetCampaignBiddingData = {
+    path: {
+        /**
+         * Numeric Google platform campaign id.
+         */
+        campaignId: string;
+    };
+    query: {
+        /**
+         * Zernio Google Ads SocialAccount id: resolves the customer id + refresh token.
+         */
+        accountId: string;
+        /**
+         * Numeric Google Ads customer id (no dashes). Required when the connection has multiple Google Ads accounts; optional (and inferred) when it has only one.
+         */
+        customerId?: string;
+        /**
+         * Required: campaign IDs are not globally unique. Only "google" is supported today.
+         */
+        platform: 'google';
+    };
+};
+
+export type GetCampaignBiddingResponse = (({
+    campaignId?: string;
+} & CampaignBidding));
+
+export type GetCampaignBiddingError = (unknown | {
+    error?: string;
+});
+
 export type UpdateAdCampaignData = {
     body: {
         /**
@@ -30812,7 +31090,7 @@ export type UpdateAdCampaignData = {
          */
         accountId?: string;
         /**
-         * **Meta + Google.** On Meta, the campaign default that ad sets inherit unless they override it. On Google, the campaign's own bidding strategy.
+         * **Meta + Google.** On Meta, the campaign default that ad sets inherit unless they override it. On Google, the campaign's own bidding strategy. On Google: LOWEST_COST_WITHOUT_CAP = Maximize Conversions, COST_CAP + bidAmount = Target CPA, LOWEST_COST_WITH_MIN_ROAS + roasAverageFloor = Target ROAS, LOWEST_COST_WITH_BID_CAP + bidAmount = Maximize Clicks with a CPC ceiling; portfolioBidStrategyId attaches a portfolio strategy instead.
          */
         bidStrategy?: (BidStrategy);
         /**
@@ -30823,6 +31101,10 @@ export type UpdateAdCampaignData = {
          * **Google only.** Decimal ROAS multiplier (2.0 = 2.0x), required for LOWEST_COST_WITH_MIN_ROAS.
          */
         roasAverageFloor?: number;
+        /**
+         * **Google only.** Attach an existing portfolio bid strategy (numeric id from GET /v1/ads/bid-strategies) instead of setting bidStrategy. Exclusive with bidStrategy.
+         */
+        portfolioBidStrategyId?: string;
         /**
          * **Meta only.** The CBO budget.
          */
@@ -30865,6 +31147,10 @@ export type UpdateAdCampaignResponse = ({
     bidStrategy?: BidStrategy;
     bidAmount?: number;
     roasAverageFloor?: number;
+    /**
+     * Google only. Echoed back, but NOT mirrored onto local Ad documents (no column for it yet).
+     */
+    portfolioBidStrategyId?: string;
     platformSpecificData?: {
         [key: string]: unknown;
     };
@@ -31055,6 +31341,198 @@ export type DuplicateAdCampaignError = (unknown | {
     error?: string;
 });
 
+export type GetCampaignTargetingData = {
+    path: {
+        /**
+         * Google platform campaign ID
+         */
+        campaignId: string;
+    };
+    query?: {
+        /**
+         * Disambiguates when the same campaignId string exists on more than one connected platform.
+         */
+        platform?: 'google';
+    };
+};
+
+export type GetCampaignTargetingResponse = ({
+    devices?: Array<{
+        device?: 'MOBILE' | 'DESKTOP' | 'TABLET' | 'CONNECTED_TV';
+        included?: boolean;
+        /**
+         * Always null on this read (see description).
+         */
+        bidModifier?: (number) | null;
+    }>;
+    locations?: Array<{
+        /**
+         * Numeric id from Google's geoTargetConstants/{id}.
+         */
+        geoTargetId?: string;
+        /**
+         * true = excluded location.
+         */
+        negative?: boolean;
+    }>;
+    languages?: Array<{
+        /**
+         * Google's language code (ISO 639-1, plus variants such as `zh_CN`). Empty when the campaign's language_constant id is not in Zernio's checked-in table.
+         */
+        code?: string;
+        /**
+         * Google's languageConstants/{id} numeric id.
+         */
+        id?: string;
+        name?: string;
+    }>;
+});
+
+export type GetCampaignTargetingError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type UpdateCampaignTargetingData = {
+    body: {
+        platform: 'google';
+        targeting: {
+            /**
+             * Devices to include. Devices not listed become excluded (negative) criteria, same contract as the existing devices-only edit.
+             */
+            devices?: Array<('MOBILE' | 'DESKTOP' | 'TABLET' | 'CONNECTED_TV' | {
+    device: 'MOBILE' | 'DESKTOP' | 'TABLET' | 'CONNECTED_TV';
+    /**
+     * Bid modifier for this device; devices without one use the campaign's base bid.
+     */
+    bidModifier: number;
+})>;
+            /**
+             * Bare country-code array, or the nested creation-time shape (countries/regions/cities/zips/metros).
+             */
+            locations?: (Array<(string)> | {
+    countries?: Array<(string)>;
+    regions?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    cities?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    zips?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    metros?: Array<{
+        key: string;
+        name?: string;
+    }>;
+});
+            /**
+             * Google's language codes (ISO 639-1, plus variants such as `zh_CN`), e.g. ["en", "de"].
+             */
+            languages?: Array<(string)>;
+        };
+    };
+    path: {
+        /**
+         * Google platform campaign ID
+         */
+        campaignId: string;
+    };
+};
+
+export type UpdateCampaignTargetingResponse = ({
+    campaignId?: string;
+    /**
+     * Which targeting fields were applied.
+     */
+    updated?: Array<('devices' | 'locations' | 'languages')>;
+});
+
+export type UpdateCampaignTargetingError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type ListAdSetsData = {
+    query?: {
+        /**
+         * Social account ID
+         */
+        accountId?: string;
+        /**
+         * Platform campaign ID
+         */
+        campaignId?: string;
+        platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
+    };
+};
+
+export type ListAdSetsResponse = ({
+    adSets?: Array<{
+        platformAdSetId?: string;
+        platform?: string;
+        adSetName?: (string) | null;
+        status?: (string) | null;
+        platformAdSetStatus?: (string) | null;
+        platformCampaignId?: (string) | null;
+        platformAdAccountId?: string;
+        accountId?: (string) | null;
+        profileId?: string;
+        currency?: (string) | null;
+        budget?: {
+            [key: string]: unknown;
+        } | null;
+        isExternal?: (boolean) | null;
+        platformCreatedAt?: (string) | null;
+    }>;
+});
+
+export type ListAdSetsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type CreateAdSetData = {
+    body: {
+        /**
+         * Zernio SocialAccount id owning the Google Ads connection.
+         */
+        accountId: string;
+        /**
+         * Only "google" is implemented today; every other value returns 501.
+         */
+        platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
+        /**
+         * Google platform campaign ID (numeric) the ad group is created under.
+         */
+        campaignId: string;
+        name: string;
+        status?: 'ACTIVE' | 'PAUSED';
+        /**
+         * Numeric Google Ads customer id. Only required when the connection has more than one.
+         */
+        customerId?: string;
+    };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
+};
+
+export type CreateAdSetResponse = ({
+    /**
+     * Platform id of the new ad group
+     */
+    adSetId?: string;
+    campaignId?: string;
+});
+
+export type CreateAdSetError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type DuplicateAdSetData = {
     body: {
         platform: 'facebook' | 'instagram';
@@ -31562,8 +32040,9 @@ export type UpdateAdData = {
             type?: 'daily' | 'lifetime';
         };
         /**
-         * Meta + TikTok (demographics/interests), Google (keyword edits only),
-         * and LinkedIn (geo countries). Pinterest / X return 501.
+         * Meta + TikTok (demographics/interests), Google (keyword and device
+         * bid adjustment edits only), and LinkedIn (geo countries). Pinterest / X
+         * return 501.
          *
          */
         targeting?: {
@@ -31580,6 +32059,16 @@ export type UpdateAdData = {
             negativeKeywords?: Array<(string | {
     text: string;
     matchType?: 'exact' | 'phrase' | 'broad';
+})>;
+            /**
+             * Google only. The FULL new set of device criteria for the campaign; devices not listed are excluded. Entries are a device name alone (included, no bid adjustment) or { device, bidModifier }.
+             */
+            devices?: Array<('MOBILE' | 'DESKTOP' | 'TABLET' | 'CONNECTED_TV' | {
+    device: 'MOBILE' | 'DESKTOP' | 'TABLET' | 'CONNECTED_TV';
+    /**
+     * Google device bid modifier, 0.1 to 10 (minus 90% to plus 900%). Omit a device to exclude it.
+     */
+    bidModifier?: number;
 })>;
             ageMin?: number;
             ageMax?: number;
@@ -33171,6 +33660,90 @@ export type DeleteValueRuleSetError = (unknown | {
     error?: string;
 });
 
+export type ListAccountCalloutsData = {
+    query: {
+        /**
+         * Google ads SocialAccount id.
+         */
+        accountId: string;
+        /**
+         * Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+         */
+        customerId?: string;
+    };
+};
+
+export type ListAccountCalloutsResponse = ({
+    customerId?: string;
+    callouts?: Array<{
+        assetId?: string;
+        text?: string;
+        /**
+         * customer_asset.status, e.g. ENABLED, REMOVED, PAUSED.
+         */
+        status?: string;
+    }>;
+});
+
+export type ListAccountCalloutsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type AddAccountCalloutsData = {
+    body: {
+        /**
+         * Zernio SocialAccount id owning the Google Ads connection.
+         */
+        accountId: string;
+        /**
+         * Numeric Google Ads customer id. Only required when the connection has more than one.
+         */
+        customerId?: string;
+        /**
+         * Callout text, 1-25 characters each; up to 20 per request (Google's CalloutAsset limits).
+         */
+        callouts: Array<(string)>;
+    };
+};
+
+export type AddAccountCalloutsResponse = ({
+    customerId?: string;
+    callouts?: Array<{
+        assetId?: string;
+        text?: string;
+    }>;
+});
+
+export type AddAccountCalloutsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type RemoveAccountCalloutData = {
+    body: {
+        /**
+         * Zernio SocialAccount id owning the Google Ads connection.
+         */
+        accountId: string;
+        /**
+         * Numeric Google Ads customer id. Only required when the connection has more than one.
+         */
+        customerId?: string;
+        /**
+         * Numeric asset id from GET /v1/ads/accounts/callouts.
+         */
+        assetId: string;
+    };
+};
+
+export type RemoveAccountCalloutResponse = ({
+    removed?: boolean;
+    customerId?: string;
+});
+
+export type RemoveAccountCalloutError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type GetAdAccountFinanceData = {
     query: {
         /**
@@ -34138,7 +34711,7 @@ export type CreateStandaloneAdData = {
          */
         incomeTier?: 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
         /**
-         * Language codes restricting the audience by language. On Meta, ISO 639-1 codes (e.g. ['en'], ['de']); a bare code targets all regional variants ("en" = all English), or use a region-qualified code for a specific one ("en_GB", "pt_BR", "zh_TW"). Unknown codes are rejected. Other ad platforms use their own language-code systems.
+         * e.g. ["en","es"]. Google: campaign language targeting (language_constant) using Google's language codes (ISO 639-1, plus variants such as `zh_CN`); unknown codes return 400. On Meta, a bare code targets all regional variants ("en" = all English), or use a region-qualified code for a specific one ("en_GB", "pt_BR", "zh_TW"); unknown codes are rejected. Other ad platforms use their own language-code systems.
          */
         languages?: Array<(string)>;
         /**
@@ -34582,6 +35155,8 @@ export type CreateStandaloneAdData = {
          *
          * OpenAI Ads: required on every ad group via this flat field, the only channel it supports (`platformSpecificData` is Meta/LinkedIn-only and returns 400 for OpenAI). No auto-bid option exists; send `LOWEST_COST_WITH_BID_CAP` or `COST_CAP` together with `bidAmount`, omitting it returns 400.
          *
+         * Google (not deprecated there, this shared flat field is Google's only shape): applied to the campaign this call creates. On Google: LOWEST_COST_WITHOUT_CAP = Maximize Conversions, COST_CAP + bidAmount = Target CPA, LOWEST_COST_WITH_MIN_ROAS + roasAverageFloor = Target ROAS, LOWEST_COST_WITH_BID_CAP + bidAmount = Maximize Clicks with a CPC ceiling; portfolioBidStrategyId attaches a portfolio strategy instead. Omitted, the campaign falls back to a goal-based default.
+         *
          * @deprecated
          */
         bidStrategy?: (BidStrategy);
@@ -34614,6 +35189,10 @@ export type CreateStandaloneAdData = {
          * @deprecated
          */
         roasAverageFloor?: number;
+        /**
+         * Google only. Attach an existing portfolio bid strategy (numeric id from GET /v1/ads/bid-strategies) to the new campaign instead of a standard one. Exclusive with bidStrategy.
+         */
+        portfolioBidStrategyId?: string;
         /**
          * Meta only (facebook, instagram; other platforms return 400). Value rule set
          * to attach to the new ad set, from `/v1/ads/value-rule-sets`. Attachment is
@@ -35514,9 +36093,9 @@ export type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options, `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics. Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
+         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics. Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
          */
-        dimension?: 'geo' | 'interest' | 'behavior' | 'income' | 'workPosition' | 'workEmployer' | 'workIndustry';
+        dimension?: 'geo' | 'interest' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry';
         /**
          * Only used when `dimension=geo`. The kind of location to resolve. `all` searches every type in one relevance-ranked call. Defaults to `city`.
          */
@@ -36420,6 +36999,69 @@ export type AdjustConversionsError = (unknown | {
     error?: string;
 });
 
+export type ListConversionActionsData = {
+    query: {
+        /**
+         * SocialAccount _id (must be a googleads account).
+         */
+        accountId: string;
+        /**
+         * Google Ads customer id (digits only). Resolved automatically when the connection has exactly one accessible customer.
+         */
+        customerId?: string;
+        /**
+         * Filter by Google's ConversionActionType enum (e.g. WEBPAGE, UPLOAD_CLICKS).
+         */
+        type?: string;
+    };
+};
+
+export type ListConversionActionsResponse = ({
+    /**
+     * The Google Ads customer id the actions were read from.
+     */
+    customerId?: string;
+    actions?: Array<ConversionAction>;
+});
+
+export type ListConversionActionsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type CreateConversionActionData = {
+    body: {
+        /**
+         * SocialAccount ID. Must be a `googleads` account.
+         */
+        accountId: string;
+        /**
+         * Google Ads customer id (digits only). Resolved automatically when the connection has exactly one accessible customer.
+         */
+        customerId?: string;
+        name: string;
+        /**
+         * Only WEBPAGE is supported for creation today.
+         */
+        type: 'WEBPAGE';
+        /**
+         * Default conversion value used when an event doesn't carry its own value.
+         */
+        defaultValue?: number;
+        /**
+         * When true, always use defaultValue and ignore any value sent with the event. Defaults to true when defaultValue is set.
+         */
+        alwaysUseDefaultValue?: boolean;
+    };
+};
+
+export type CreateConversionActionResponse = ({
+    action?: ConversionAction;
+});
+
+export type CreateConversionActionError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type ListConversionDestinationsData = {
     path: {
         /**