@zernio/node 0.2.737 → 0.2.739

package/src/generated/types.gen.ts

@@ -255,6 +255,14 @@ export type Ad = {
      * Platform-specific creative data. Fields vary by platform.
      */
     creative?: {
+        /**
+         * Initial Performance Max asset group input. Use the asset-groups endpoint for current Google assets.
+         */
+        assetGroup?: GooglePmaxAssetGroupInput;
+        /**
+         * Google resource name of the created Performance Max asset group.
+         */
+        assetGroupResourceName?: string;
         /**
          * Google RSA only. Replaces the complete headline list. No padding or truncation on update.
          */
@@ -4473,6 +4481,70 @@ export type GoogleBusinessReview = {
  */
 export type starRating = 'ONE' | 'TWO' | 'THREE' | 'FOUR' | 'FIVE';
 
+export type GooglePmaxAssetGroup = {
+    id: string;
+    resourceName: string;
+    name: string;
+    /**
+     * Asset-group status on Google. Campaign status independently controls delivery.
+     */
+    status: string;
+    finalUrls: Array<(string)>;
+    assets: Array<{
+        resourceName: string;
+        /**
+         * Google asset role, such as HEADLINE or LOGO.
+         */
+        fieldType: string;
+        status: string;
+        text?: string;
+        imageUrl?: string;
+        youtubeVideoId?: string;
+    }>;
+};
+
+/**
+ * Google Performance Max creative assets. At least one description must be 60 characters or fewer. Texts within each list must be distinct.
+ */
+export type GooglePmaxAssetGroupInput = {
+    /**
+     * Defaults to the request name.
+     */
+    name?: string;
+    /**
+     * Required destination URL.
+     */
+    finalUrl: string;
+    headlines: Array<(string)>;
+    longHeadline: string;
+    /**
+     * At least one description must be 60 characters or fewer.
+     */
+    descriptions: Array<(string)>;
+    businessName: string;
+    /**
+     * Public HTTP(S) image URLs. GIF, JPEG or PNG, at most 5120 KB per image. Google validates dimensions and aspect ratios.
+     */
+    images: {
+        /**
+         * Landscape marketing images. Aspect ratio 1.91:1, minimum 600 x 314 pixels.
+         */
+        landscape: Array<(string)>;
+        /**
+         * Square marketing images. Aspect ratio 1:1, minimum 300 x 300 pixels.
+         */
+        square: Array<(string)>;
+        /**
+         * Required square logos. Aspect ratio 1:1, minimum 128 x 128 pixels.
+         */
+        logo: Array<(string)>;
+    };
+    /**
+     * Optional existing YouTube video id. Google can generate video when omitted. Video uploads and arbitrary video URLs are not supported.
+     */
+    youtubeVideoId?: string;
+};
+
 export type GoogleRsaDescription = {
     text: string;
     /**
@@ -6605,7 +6677,7 @@ export type SocialAccount = {
     /**
      * Reference to the parent posting SocialAccount. Set for ads accounts that share
      * or derive from a posting account's OAuth token. null for standalone ads (Google Ads)
-     * and all posting accounts.
+     * and all posting accounts. Meta ads business-login accounts also have no parent.
      *
      */
     parentAccountId?: (string) | null;
@@ -6627,6 +6699,17 @@ export type SocialAccount = {
      * - wabaId: WhatsApp Business Account ID
      * - phoneNumberId: Meta phone number ID
      *
+     * For Meta ads business-login accounts:
+     * - tokenType: system-user
+     * - businessId: The owning Business Manager ID when there is one owner; null for multiple owners.
+     * - businessIds: Owning Business Manager IDs discovered from granted ad accounts.
+     * - grantedAdAccountIds: Ad-account IDs granted to the token.
+     * - adAccountBusinesses: Map from ad-account ID to its owning business ID or null.
+     * - availablePages: Granted Page IDs and names. No Page tokens are exposed.
+     * - selectedPageId: The Page selected for creatives and lead forms, or null.
+     * - scopedAdAccountIds: Existing sync scope preserved on reconnect.
+     * Non-expiring tokens have no tokenExpiresAt field. Parent posting reconnects do not replace this token.
+     *
      * For LinkedIn accounts, profileData carries the profile details refreshed on each daily snapshot:
      * - profileData.bio: The member's headline for personal accounts, or the organization description for organization accounts. null when the member has not set one.
      * - profileData.extraData.vanityName: The member's profile slug, i.e. the /in/{vanityName} segment of profileUrl. Personal accounts only; an organization's own slug is in metadata.organizationInfo.vanityName.
@@ -14690,7 +14773,7 @@ export type ConnectAdsData = {
         /**
          * Platform to connect ads for. Only platforms with ads support are accepted.
          *
-         * `instagram` requires an Instagram account connected with loginMethod=facebook_login whose
+         * In classic mode, `instagram` requires an Instagram account connected with loginMethod=facebook_login whose
          * token carries ads_management and ads_read. With an account connected through the default
          * instagram_login flow no ads account can be created; do not use this value for those accounts.
          *
@@ -14708,7 +14791,9 @@ export type ConnectAdsData = {
         accountId?: string;
         /**
          * Scope ad sync to a single platform ad account. Without this param,
-         * sync covers every ad account the connected token can see. Supported
+         * sync covers every ad account the connected token can see. Business-login reconnects
+         * preserve the existing scope; supplied IDs are checked against the new grant. To change
+         * that scope after migration, call this endpoint with the IDs and omit loginMode. Supported
          * on `facebook`/`instagram` (Meta, `act_<digits>`), `linkedin` (bare
          * numeric sponsored-account id), `googleads` (bare customer id digits)
          * and `twitter` (X Ads, base36 account id). `tiktok` scopes advertisers
@@ -14745,6 +14830,14 @@ export type ConnectAdsData = {
          * Enable headless mode (same-token platforms only)
          */
         headless?: boolean;
+        /**
+         * Meta ads authorization mode. Business login is opt-in for Facebook and Instagram; classic preserves the posting-account flow.
+         */
+        loginMode?: 'classic' | 'business';
+        /**
+         * Business login only. Facebook Page ID to select from the token grants for ad creatives and lead forms.
+         */
+        pageId?: string;
         /**
          * Your Zernio profile ID
          */
@@ -14777,6 +14870,10 @@ export type ConnectAdsResponse = (({
     platform?: string;
     username?: string;
     displayName?: string;
+    /**
+     * Present for an existing business-login connection.
+     */
+    tokenType?: 'system-user';
     /**
      * Echo of the persisted ad-account scope when the caller passed
      * `adAccountId` / `adAccountIds`. Omitted when no scope is set.
@@ -14792,6 +14889,23 @@ export type ConnectAdsError = (unknown | {
     error?: string;
 });
 
+export type CompleteMetaAdsBusinessLoginData = {
+    query: {
+        /**
+         * Single-use authorization code returned by Meta.
+         */
+        code?: string;
+        /**
+         * Meta authorization error when the user declines the dialog.
+         */
+        error?: string;
+        /**
+         * Authenticated state from the initial connectAds response.
+         */
+        state: string;
+    };
+};
+
 export type GetShopifyConnectUrlData = {
     query: {
         /**
@@ -36421,6 +36535,14 @@ export type ListAdAccountsResponse = ({
         id?: string;
         name?: string;
         currency?: string;
+        /**
+         * Meta only. Owning Business Manager ID when available on the grant.
+         */
+        businessId?: string;
+        /**
+         * Owning business name when supplied by the platform.
+         */
+        businessName?: string;
         /**
          * LinkedIn only. LinkedIn's own ad account status. In practice always `ACTIVE`, because the LinkedIn query filters to active accounts. Meta, Google, TikTok and Pinterest report `accountStatus` instead; X reports `approvalStatus`.
          */
@@ -36912,6 +37034,25 @@ export type BoostPostError = (unknown | {
     error?: string;
 });
 
+export type ListGoogleAssetGroupsData = {
+    path: {
+        /**
+         * Google Ads campaign id.
+         */
+        campaignId: string;
+    };
+};
+
+export type ListGoogleAssetGroupsResponse = ({
+    assetGroups: Array<GooglePmaxAssetGroup>;
+    cachedAt: (string) | null;
+    stale: boolean;
+});
+
+export type ListGoogleAssetGroupsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type CreateStandaloneAdData = {
     body: {
         accountId: string;
@@ -36981,19 +37122,19 @@ export type CreateStandaloneAdData = {
          */
         multiAdvertiser?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Meta only. Validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
          */
         validateOnly?: boolean;
         /**
-         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
+         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
          */
         budgetAmount?: number;
         /**
-         * Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads accepts lifetime only (no daily-budget concept on the platform); sending daily returns 422. OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
+         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads accepts lifetime only (no daily-budget concept on the platform); sending daily returns 422. OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
          */
         budgetType?: 'daily' | 'lifetime';
         /**
-         * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused so you can review before they spend. On Meta the pause is held on the campaign this call creates, leaving the ad set and ad switched on, so a single PUT /v1/ads/campaigns/{campaignId}/status with `active` brings the whole thing live. It is held at every level instead when the pause cannot rely on the campaign: `existingCampaignId` (that campaign may be running and is never touched) or `campaignStatus: ACTIVE`. On TikTok the whole campaign > ad group > ad hierarchy stays paused. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
+         * Google Performance Max accepts PAUSED only and always creates a paused campaign. Meta, TikTok, and LinkedIn: publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused so you can review before they spend. On Meta the pause is held on the campaign this call creates, leaving the ad set and ad switched on, so a single PUT /v1/ads/campaigns/{campaignId}/status with `active` brings the whole thing live. It is held at every level instead when the pause cannot rely on the campaign: `existingCampaignId` (that campaign may be running and is never touched) or `campaignStatus: ACTIVE`. On TikTok the whole campaign > ad group > ad hierarchy stays paused. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
          */
         status?: 'ACTIVE' | 'PAUSED';
         /**
@@ -37689,9 +37830,10 @@ export type CreateStandaloneAdData = {
          */
         audienceId?: string;
         /**
-         * Google only
+         * Google only. Performance Max requires assetGroup and is always created PAUSED.
          */
-        campaignType?: 'display' | 'search';
+        campaignType?: 'display' | 'search' | 'pmax';
+        assetGroup?: GooglePmaxAssetGroupInput;
         /**
          * Google Search only. Keywords on the new ad group; entries are strings (BROAD) or { text, matchType }. Editable later via PUT /v1/ads/{adId} targeting.keywords.
          */
@@ -37829,7 +37971,7 @@ export type CreateStandaloneAdData = {
          */
         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.
+         * Google Search and Display only. Performance Max rejects portfolio bidding. 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;
         /**
@@ -37981,7 +38123,7 @@ export type CreateStandaloneAdResponse = ({
      */
     validateOnly?: boolean;
     results?: Array<{
-        node?: 'campaign' | 'adSet' | 'creative' | 'ad';
+        node?: 'campaign' | 'adSet' | 'creative' | 'ad' | 'performanceMaxCampaign';
         status?: 'validated' | 'skipped';
         /**
          * Why the node could not be validated (only on skipped).
@@ -38080,7 +38222,7 @@ export type ListLeadsError = (ErrorResponse | {
 export type ListLeadFormsData = {
     query: {
         /**
-         * Connected facebook or linkedin ads account id.
+         * Connected Facebook, Meta ads business-login or LinkedIn ads account ID.
          */
         accountId: string;
         /**