@zernio/node 0.2.715 → 0.2.717

package/src/generated/types.gen.ts

@@ -661,6 +661,65 @@ export type AdFunnelCounts = {
     messagingFirstReplies?: number;
 };
 
+export type AdKeyword = {
+    id?: string;
+    /**
+     * Social account ID owning the sync
+     */
+    accountId?: string;
+    profileId?: string;
+    platform?: 'google';
+    /**
+     * Google customer ID
+     */
+    adAccountId?: string;
+    campaignId?: string;
+    campaignName?: (string) | null;
+    campaignStatus?: (string) | null;
+    /**
+     * Google ad group ID
+     */
+    adSetId?: string;
+    adSetName?: (string) | null;
+    adSetStatus?: (string) | null;
+    keyword?: string;
+    matchType?: 'exact' | 'phrase' | 'broad' | 'unknown';
+    status?: 'active' | 'paused';
+    negative?: boolean;
+    /**
+     * Google Quality Score, 1-10. Null when unrated.
+     */
+    qualityScore?: (number) | null;
+    syncedAt?: (string) | null;
+    /**
+     * Trailing 30-day window. Null on rows synced before the metrics columns existed (re-synced on the keyword's next weekly sweep).
+     */
+    metrics?: {
+        windowDays?: number;
+        clicks?: number;
+        impressions?: number;
+        /**
+         * Account currency, not USD-normalized
+         */
+        cost?: number;
+        conversions?: number;
+        /**
+         * Account currency
+         */
+        firstPageCpc?: (number) | null;
+        /**
+         * Account currency
+         */
+        firstPositionCpc?: (number) | null;
+    } | null;
+};
+
+export type platform2 = 'google';
+
+export type matchType = 'exact' | 'phrase' | 'broad' | 'unknown';
+
+export type status = 'active' | 'paused';
+
 export type AdMetrics = {
     spend?: number;
     impressions?: number;
@@ -1320,7 +1379,7 @@ export type AnalyticsSinglePostResponse = {
 /**
  * Overall post status. "partial" when some platforms published and others failed.
  */
-export type status = 'published' | 'failed' | 'partial';
+export type status2 = 'published' | 'failed' | 'partial';
 
 /**
  * Overall sync state across all platforms
@@ -1468,7 +1527,7 @@ export type Blog = {
     handle?: string;
 };
 
-export type platform2 = 'shopify';
+export type platform3 = 'shopify';
 
 /**
  * An article inside a blog on the connected platform.
@@ -1757,7 +1816,7 @@ export type channel = 'whatsapp' | 'pstn';
 
 export type direction = 'inbound' | 'outbound';
 
-export type status2 = 'ringing' | 'answered' | 'ended' | 'failed';
+export type status3 = 'ringing' | 'answered' | 'ended' | 'failed';
 
 /**
  * Caller ID presented on the forwarded leg.
@@ -1973,7 +2032,7 @@ export type ConversionDestination = {
  * For LinkedIn, `inactive` means the rule is soft-deleted (`enabled: false`).
  *
  */
-export type status3 = 'active' | 'inactive';
+export type status4 = 'active' | 'inactive';
 
 /**
  * A single conversion event to relay to the ad platform. All PII fields
@@ -2569,7 +2628,7 @@ export type objective = 'OUTCOME_ENGAGEMENT' | 'OUTCOME_SALES' | 'OUTCOME_LEADS'
  * newly created ad(s) after Meta accepts them.
  *
  */
-export type status4 = 'ACTIVE' | 'PAUSED';
+export type status5 = 'ACTIVE' | 'PAUSED';
 
 /**
  * Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults
@@ -2937,7 +2996,7 @@ export type privacy_level = 2;
 /**
  * 1=SCHEDULED, 2=ACTIVE, 3=COMPLETED, 4=CANCELED
  */
-export type status5 = 1 | 2 | 3 | 4;
+export type status6 = 1 | 2 | 3 | 4;
 
 /**
  * 1=STAGE_INSTANCE, 2=VOICE, 3=EXTERNAL
@@ -3694,7 +3753,7 @@ export type InboxWebhookConversation = {
     contactId?: string;
 };
 
-export type status6 = 'active' | 'archived';
+export type status7 = 'active' | 'archived';
 
 /**
  * The message object included in inbox webhook payloads.
@@ -3810,7 +3869,7 @@ export type InboxWebhookMessage = {
     isRead: boolean;
 };
 
-export type platform3 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'sms';
+export type platform4 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'sms';
 
 export type direction2 = 'incoming' | 'outgoing';
 
@@ -3938,7 +3997,7 @@ export type InstagramAccountInsightsResponse = {
 /**
  * Platform that served this response.
  */
-export type platform4 = 'facebook' | 'instagram' | 'youtube' | 'linkedin' | 'tiktok';
+export type platform5 = 'facebook' | 'instagram' | 'youtube' | 'linkedin' | 'tiktok';
 
 export type metricType = 'time_series' | 'total_value';
 
@@ -4153,6 +4212,16 @@ export type contentType2 = 'story';
  */
 export type graduationStrategy = 'MANUAL' | 'SS_PERFORMANCE';
 
+/**
+ * A Google Search keyword: a bare string (BROAD match), or an object naming the match type.
+ */
+export type KeywordEntry = string | {
+    text: string;
+    matchType?: 'exact' | 'phrase' | 'broad';
+};
+
+export type matchType2 = 'exact' | 'phrase' | 'broad';
+
 /**
  * LinkedIn-specific options for POST /v1/ads/boost and POST /v1/ads/create: campaign bidding and delivery controls, plus the LinkedIn-only creative formats on /v1/ads/create. Unknown keys are rejected.
  *
@@ -4800,7 +4869,7 @@ export type PlatformAnalytics = {
     errorMessage?: (string) | null;
 };
 
-export type status7 = 'published' | 'failed';
+export type status8 = 'published' | 'failed';
 
 /**
  * Sync state of analytics for this platform
@@ -4829,7 +4898,7 @@ export type PlatformTarget = {
         [key: string]: unknown;
     };
     /**
-     * Platform-specific status: pending, publishing, published, failed
+     * Platform-specific status: pending, processing, uploading, published, failed, cancelled (removed from the platform via DELETE /v1/posts/{postId}/unpublish)
      */
     status?: string;
     /**
@@ -4897,7 +4966,10 @@ export type Post = {
     platforms?: Array<PlatformTarget>;
     scheduledFor?: string;
     timezone?: string;
-    status?: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+    /**
+     * `cancelled` is set by DELETE /v1/posts/{postId}/unpublish once every platform entry has been removed from its platform (a post with published entries left becomes `partial`); cancelled posts can be edited and rescheduled like drafts.
+     */
+    status?: 'draft' | 'scheduled' | 'publishing' | 'published' | 'partial' | 'failed' | 'cancelled';
     /**
      * YouTube constraints: each tag max 100 chars, combined max 500 chars, duplicates removed.
      */
@@ -4931,7 +5003,10 @@ export type Post = {
     updatedAt?: string;
 };
 
-export type status8 = 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+/**
+ * `cancelled` is set by DELETE /v1/posts/{postId}/unpublish once every platform entry has been removed from its platform (a post with published entries left becomes `partial`); cancelled posts can be edited and rescheduled like drafts.
+ */
+export type status9 = 'draft' | 'scheduled' | 'publishing' | 'published' | 'partial' | 'failed' | 'cancelled';
 
 export type visibility = 'public' | 'private' | 'unlisted';
 
@@ -5427,7 +5502,7 @@ export type ReviewWebhookReview = {
 /**
  * Platform the review originated on. Currently Google Business Profile only.
  */
-export type platform5 = 'googlebusiness';
+export type platform6 = 'googlebusiness';
 
 /**
  * A Meta Reach & Frequency prediction. Money values in whole units of the ad account currency.
@@ -5590,7 +5665,7 @@ export type SocialAccount = {
     };
 };
 
-export type platform6 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'sms' | 'phone' | 'rcs';
+export type platform7 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'sms' | 'phone' | 'rcs';
 
 /**
  * Normalized, platform-agnostic ad-targeting spec. Every field is optional, an
@@ -6056,7 +6131,7 @@ export type TrackingTag = {
     ownerAdAccountId?: string;
 };
 
-export type platform7 = 'metaads';
+export type platform8 = 'metaads';
 
 /**
  * Platform-native flavor of the tag (Meta: `pixel`).
@@ -6156,7 +6231,7 @@ export type UploadTokenResponse = {
     status?: 'pending' | 'completed' | 'expired';
 };
 
-export type status9 = 'pending' | 'completed' | 'expired';
+export type status10 = 'pending' | 'completed' | 'expired';
 
 export type UploadTokenStatusResponse = {
     token?: string;
@@ -6631,7 +6706,7 @@ export type Verification = {
     resend?: boolean;
 };
 
-export type status10 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
+export type status11 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
 
 export type channel2 = 'sms';
 
@@ -6700,7 +6775,7 @@ export type WebhookLog = {
      */
     webhookName?: string;
     /**
-     * Stable webhook event ID (correlates to the delivered payload)
+     * Stable webhook event ID: the payload `id`, also sent as the X-Zernio-Event-Id header. Shared by every attempt and redelivery of the same event.
      */
     eventId?: string;
     /**
@@ -6750,7 +6825,7 @@ export type WebhookLog = {
 /**
  * Delivery outcome
  */
-export type status11 = 'success' | 'failed';
+export type status12 = 'success' | 'failed';
 
 /**
  * Webhook payload for `account.ads.initial_sync_completed` events.
@@ -6862,7 +6937,7 @@ export type event = 'account.ads.initial_sync_completed';
 /**
  * Overall outcome of the initial sync.
  */
-export type status12 = 'success' | 'failure';
+export type status13 = 'success' | 'failure';
 
 /**
  * Stable category for UX branching. New values may be added; existing ones are
@@ -7489,7 +7564,7 @@ export type WebhookPayloadComment = {
 
 export type event10 = 'comment.received';
 
-export type platform8 = 'instagram' | 'facebook' | 'twitter' | 'youtube' | 'linkedin' | 'bluesky' | 'reddit';
+export type platform9 = 'instagram' | 'facebook' | 'twitter' | 'youtube' | 'linkedin' | 'bluesky' | 'reddit';
 
 /**
  * Fired once when a new conversation begins, in either direction. A conversation
@@ -7546,7 +7621,7 @@ export type WebhookPayloadConversationStarted = {
 
 export type event11 = 'conversation.started';
 
-export type platform9 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms' | 'slack';
+export type platform10 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms' | 'slack';
 
 /**
  * Webhook payload for post.external.created / post.external.updated /
@@ -7647,7 +7722,7 @@ export type WebhookPayloadLead = {
 
 export type event13 = 'lead.received';
 
-export type platform10 = 'facebook';
+export type platform11 = 'facebook';
 
 /**
  * Webhook payload for message received events
@@ -8443,7 +8518,7 @@ export type event18 = 'message.sent';
 /**
  * Every platform whose outgoing messages Zernio observes. sms is absent on purpose: its carrier receipts update delivery status and never raise message.sent.
  */
-export type platform11 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'slack';
+export type platform12 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'slack';
 
 /**
  * WhatsApp send origin. whatsapp_business_app when sent from the WhatsApp Business phone app on a Coexistence number; cloud_api when sent through Zernio (dashboard, API, or broadcasts). Absent on non-WhatsApp platforms. Says where WhatsApp saw the send come from, not which Zernio surface produced it: read sentVia for that.
@@ -8629,7 +8704,7 @@ export type event21 = 'post.platform.published' | 'post.platform.failed' | 'post
 /**
  * Terminal status this event fires on. Matches the event suffix.
  */
-export type status13 = 'published' | 'failed' | 'deleted';
+export type status14 = 'published' | 'failed' | 'deleted';
 
 /**
  * Webhook payload for reaction received events (WhatsApp, Telegram, Slack, Instagram, Facebook Messenger)
@@ -8889,12 +8964,12 @@ export type WebhookPayloadWhatsAppAccountNameStatusUpdated = {
 
 export type event27 = 'whatsapp.account.name_status_updated';
 
-export type platform12 = 'whatsapp';
+export type platform13 = 'whatsapp';
 
 /**
  * Normalized from Meta's `decision` (REJECTED -> DECLINED, DEFERRED -> PENDING_REVIEW; the review is still open on DEFERRED, not a rejection).
  */
-export type status14 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
+export type status15 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
 
 /**
  * Webhook payload for the `whatsapp.template.category_updated` event.
@@ -9043,7 +9118,7 @@ export type event29 = 'whatsapp.template.status_updated';
  * request before the template is actually removed.
  *
  */
-export type status15 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
+export type status16 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
 
 export type WhatsAppBodyComponent = {
     type: 'body';
@@ -9192,7 +9267,7 @@ export type WhatsAppSandboxSession = {
  * list responses.
  *
  */
-export type status16 = 'pending' | 'active';
+export type status17 = 'pending' | 'active';
 
 export type WhatsAppTemplateButton = {
     type: 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
@@ -9311,7 +9386,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 status17 = 'success' | 'failed' | 'pending';
+export type status18 = 'success' | 'failed' | 'pending';
 
 /**
  * A node in a workflow graph. `config` shape depends on `type`.
@@ -11764,7 +11839,7 @@ export type ListPostsData = {
          * Which collection to read. `zernio` (default) returns posts authored through Zernio. `external` returns posts synced from the platform (existing/historical posts that were published outside Zernio). Combine with `accountId` and paginate via `page`/`limit` to walk the full synced history (we keep up to the last ~12 months per account).
          */
         source?: 'zernio' | 'external';
-        status?: 'draft' | 'scheduled' | 'published' | 'failed';
+        status?: 'draft' | 'scheduled' | 'publishing' | 'published' | 'partial' | 'failed' | 'cancelled';
     };
 };
 
@@ -11817,6 +11892,10 @@ export type CreatePostData = {
          * When true, saves the post as a draft. When none of scheduledFor, publishNow, or queuedFromProfile are provided, the post defaults to draft automatically.
          */
         isDraft?: boolean;
+        /**
+         * TikTok only. Preview whether each `tiktok` entry in `platforms` could publish right now under the TikTok Direct Post daily limits, without creating, scheduling or publishing anything: no post is persisted and no upload slot is claimed, so it can be repeated freely. The request still goes through auth, the payment gate and body validation, then returns HTTP 200 with `{ dryRun: true, canPublish, tiktok: [...] }` instead of 201. Only `tiktok` entries are evaluated; other platforms in the body are ignored, and a body with no `tiktok` entry is rejected with 400 `invalid_field_value` on `platforms`. An entry with `platformSpecificData.tiktokSettings.draft: true` (Creator Inbox upload) is not subject to the limit and always reports `canPublish: true`.
+         */
+        dryRun?: boolean;
         /**
          * IANA timezone (`Europe/Madrid`, `America/New_York`) used to interpret a `scheduledFor` (root or per-platform) that carries no `Z` or offset. Has no effect on values that already carry one. An unknown name returns 400 when `scheduledFor` is set.
          */
@@ -11873,7 +11952,31 @@ export type CreatePostData = {
     };
 };
 
-export type CreatePostResponse = (PostCreateResponse | PostPublishIncompleteResponse);
+export type CreatePostResponse = ({
+    /**
+     * Always true on this response
+     */
+    dryRun: boolean;
+    /**
+     * True only when every evaluated TikTok account can publish now
+     */
+    canPublish: boolean;
+    /**
+     * One verdict per `tiktok` entry in the request, in request order
+     */
+    tiktok: Array<{
+        accountId: string;
+        canPublish: boolean;
+        /**
+         * Whether this account already published a Direct Post today (an account that did can keep publishing). Absent for Creator Inbox drafts and when no per-user limit applies.
+         */
+        alreadyPostedToday?: boolean;
+        /**
+         * Human-readable explanation of the verdict
+         */
+        reason: string;
+    }>;
+} | PostCreateResponse | PostPublishIncompleteResponse);
 
 export type CreatePostError = ({
     error?: string;
@@ -16128,6 +16231,60 @@ export type ConnectDiscordChannelError = (ErrorResponse | {
     };
 } | unknown);
 
+export type ListSlackChannelsData = {
+    query: {
+        /**
+         * Existing active Slack account (yours or a team member's) whose workspace token is reused.
+         */
+        accountId?: string;
+        /**
+         * Nonce from the OAuth redirect (first connect).
+         */
+        pendingDataToken?: string;
+        /**
+         * Zernio profile the channel account will belong to. Must match the profile the OAuth flow was started on when `pendingDataToken` is used.
+         */
+        profileId: string;
+        /**
+         * Start-OAuth mode only: where to send the user after the connect completes. `redirectUrl` is accepted as an alias.
+         */
+        redirect_url?: string;
+    };
+};
+
+export type ListSlackChannelsResponse = (({
+    team: {
+        /**
+         * Slack workspace (team) id
+         */
+        id?: string;
+        name?: (string) | null;
+        /**
+         * Workspace icon URL
+         */
+        icon?: (string) | null;
+    };
+    channels: Array<{
+        /**
+         * Channel id (C... or G...), the value to send as channelId on POST
+         */
+        id: string;
+        name: string;
+        isPrivate: boolean;
+        /**
+         * Whether the Zernio bot is already a member of the channel
+         */
+        isMember: boolean;
+    }>;
+} | {
+    authUrl: string;
+    state: string;
+}));
+
+export type ListSlackChannelsError = (unknown | {
+    error?: string;
+});
+
 export type ConnectSlackChannelData = {
     body: {
         profileId: string;
@@ -30406,37 +30563,81 @@ export type ListAdKeywordsData = {
 };
 
 export type ListAdKeywordsResponse = ({
-    keywords?: Array<{
-        id?: string;
+    keywords?: Array<AdKeyword>;
+    pagination?: Pagination;
+});
+
+export type ListAdKeywordsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type AddAdKeywordsData = {
+    body: {
         /**
-         * Social account ID owning the sync
+         * Social account ID (Google Ads)
          */
-        accountId?: string;
-        profileId?: string;
-        platform?: 'google';
+        accountId: string;
         /**
-         * Google customer ID
+         * Google ad group ID to add the keywords to
          */
-        adAccountId?: string;
-        campaignId?: string;
-        campaignName?: (string) | null;
-        campaignStatus?: (string) | null;
+        adSetId: string;
+        keywords: Array<(string | {
+    text: string;
+    matchType?: 'exact' | 'phrase' | 'broad';
+})>;
         /**
-         * Google ad group ID
+         * Add as ad-group-level negatives instead of positive keywords
          */
-        adSetId?: string;
-        adSetName?: (string) | null;
-        adSetStatus?: (string) | null;
-        keyword?: string;
-        matchType?: 'exact' | 'phrase' | 'broad' | 'unknown';
-        status?: 'active' | 'paused';
         negative?: boolean;
-        syncedAt?: (string) | null;
-    }>;
-    pagination?: Pagination;
+    };
+};
+
+export type AddAdKeywordsResponse = ({
+    keywords?: Array<AdKeyword>;
 });
 
-export type ListAdKeywordsError = (ErrorResponse | {
+export type AddAdKeywordsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type UpdateAdKeywordData = {
+    body: {
+        status: 'active' | 'paused';
+    };
+    path: {
+        /**
+         * Zernio keyword ID (not the Google criterion ID)
+         */
+        keywordId: string;
+    };
+};
+
+export type UpdateAdKeywordResponse = ({
+    keyword?: AdKeyword;
+});
+
+export type UpdateAdKeywordError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type RemoveAdKeywordData = {
+    path: {
+        /**
+         * Zernio keyword ID (not the Google criterion ID)
+         */
+        keywordId: string;
+    };
+};
+
+export type RemoveAdKeywordResponse = ({
+    /**
+     * Always true on success
+     */
+    removed?: boolean;
+    keywordId?: string;
+});
+
+export type RemoveAdKeywordError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
@@ -30701,6 +30902,72 @@ export type DeleteAdCampaignError = ({
     error?: string;
 } | unknown);
 
+export type ListCampaignNegativeKeywordsData = {
+    path: {
+        /**
+         * Platform campaign ID
+         */
+        campaignId: string;
+    };
+    query?: {
+        /**
+         * Optional and NOT authoritative: the resolved campaign's own platform decides 200 vs 501, never this hint.
+         */
+        platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
+    };
+};
+
+export type ListCampaignNegativeKeywordsResponse = ({
+    keywords?: Array<{
+        criterionId?: string;
+        text?: string;
+        matchType?: 'exact' | 'phrase' | 'broad';
+    }>;
+});
+
+export type ListCampaignNegativeKeywordsError = ({
+    error?: string;
+} | unknown);
+
+export type ReplaceCampaignNegativeKeywordsData = {
+    body: {
+        /**
+         * Optional and NOT authoritative: the resolved campaign's own platform decides 200 vs 501, never this hint.
+         */
+        platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
+        keywords: Array<KeywordEntry>;
+    };
+    path: {
+        /**
+         * Platform campaign ID
+         */
+        campaignId: string;
+    };
+};
+
+export type ReplaceCampaignNegativeKeywordsResponse = ({
+    /**
+     * Negative criteria newly created on Google
+     */
+    created?: number;
+    /**
+     * Negative criteria removed from Google
+     */
+    removed?: number;
+    /**
+     * The full negative-keyword set after the replace
+     */
+    keywords?: Array<{
+        criterionId?: string;
+        text?: string;
+        matchType?: 'exact' | 'phrase' | 'broad';
+    }>;
+});
+
+export type ReplaceCampaignNegativeKeywordsError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type BulkUpdateAdCampaignStatusData = {
     body: {
         status: 'active' | 'paused';
@@ -34214,13 +34481,17 @@ export type CreateStandaloneAdData = {
          */
         campaignType?: 'display' | 'search';
         /**
-         * Google Search only. BROAD-match keywords on the new ad group. Editable later via PUT /v1/ads/{adId} targeting.keywords, which also sets match types.
+         * 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.
          */
-        keywords?: Array<(string)>;
+        keywords?: Array<KeywordEntry>;
+        /**
+         * Google Search only; other platforms return 400. Ad-group-level negative keywords on the new ad group. Editable later via PUT /v1/ads/{adId} targeting.negativeKeywords.
+         */
+        negativeKeywords?: Array<KeywordEntry>;
         /**
-         * Google Search only; other platforms return 400. BROAD-match negative keywords on the new ad group. Editable later via PUT /v1/ads/{adId} targeting.negativeKeywords.
+         * Google Search only; other platforms return 400. Campaign-level negative keywords (campaign_criterion.negative), created alongside the ad group. Editable later via PUT /v1/ads/campaigns/{campaignId}/negative-keywords.
          */
-        negativeKeywords?: Array<(string)>;
+        campaignNegativeKeywords?: Array<KeywordEntry>;
         /**
          * Google Search RSA only. Extra headlines.
          */