@zinn-digital/sdk 0.1.1388 → 0.1.1389

package/dist/generated/schema.d.ts

@@ -18181,6 +18181,32 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/ads/connections/{connection_id}/microsoft/import-google": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * What importing the org's Google Ads Search campaigns into this Microsoft account would queue (za-39).
+         * @description Gated on `ads.view`. `connection_id` is a Microsoft Advertising connection, `google_connection_id` a Google Ads connection of the same org (else `422` `refusal.adsconnect.importNotOnNetwork`; different currencies `importCurrency`; an account whose currency is unknown `importCurrencyUnknown`; a failed read `importReadFailed`, whose `error.failure` is the classified `VendorFailure` of the network that failed: an outage, the customer's own credential, or ours, §2.57). Reads both networks, writes nothing. Each enabled Google campaign is listed: a Search campaign is `ready` or says why it cannot be copied, any other type (Performance Max, Display, Shopping, Video) is `notSearch`; a name already live in Microsoft or already imported is `alreadyThere`; a campaign with no daily budget (a Google total budget) is `noDailyBudget`, never `ready` (docs/1006 §103).
+         */
+        get: operations["previewAdsMicrosoftImportGoogle"];
+        put?: never;
+        /**
+         * Queue the ready Google Ads Search campaigns as pending Microsoft changes (za-39).
+         * @description Gated on `ads.manage`; audit action `ads.microsoft_import_google`. Each `ready` campaign (or only `campaign_ids`) becomes ONE pending `campaigns:mutate` `build` change on the Microsoft connection — nothing is sent until a person approves it, and the kill switch, good standing and spend ceiling are checked again when it is applied. A month of the imported daily budgets is checked against the Zinn® Ads plan first (`noAdsPlan`, `spendBracket`). Nothing left to queue is `422` `refusal.adsconnect.importNothing`.
+         */
+        post: operations["queueAdsMicrosoftImportGoogle"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/ads/connections/{connection_id}/network-campaigns": {
         parameters: {
             query?: never;
@@ -138481,6 +138507,132 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    previewAdsMicrosoftImportGoogle: {
+        parameters: {
+            query: {
+                google_connection_id: string;
+                /** @description Max CPC for campaigns Google gives none. */
+                max_cpc_micros?: number;
+            };
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The preview. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        connection_id: string;
+                        currency: string;
+                        data: {
+                            ad_groups: number;
+                            /**
+                             * Format: uuid
+                             * @description The pending Microsoft change (after POST).
+                             */
+                            change_id: string | null;
+                            /**
+                             * Format: int64
+                             * @description Account currency micros; a shared Google budget split between its campaigns.
+                             */
+                            daily_budget_micros: number;
+                            /** @description Google location targets with no Microsoft equivalent (regions, cities). */
+                            dropped_targets: number;
+                            google_campaign_id: string;
+                            keywords: number;
+                            /** Format: int64 */
+                            max_cpc_micros: number;
+                            name: string;
+                            negatives: number;
+                            /** @enum {string} */
+                            state: "ready" | "queued" | "alreadyThere" | "notSearch" | "noMicrosoftLocation" | "noMicrosoftLanguage" | "noAdGroups" | "needsMaxCpc" | "noDailyBudget";
+                        }[];
+                        /** Format: uuid */
+                        google_connection_id: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    queueAdsMicrosoftImportGoogle: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    campaign_ids?: string[];
+                    /** Format: uuid */
+                    google_connection_id: string;
+                    /** Format: int64 */
+                    max_cpc_micros?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Queued. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        connection_id: string;
+                        currency: string;
+                        data: {
+                            ad_groups: number;
+                            /**
+                             * Format: uuid
+                             * @description The pending Microsoft change (after POST).
+                             */
+                            change_id: string | null;
+                            /**
+                             * Format: int64
+                             * @description Account currency micros; a shared Google budget split between its campaigns.
+                             */
+                            daily_budget_micros: number;
+                            /** @description Google location targets with no Microsoft equivalent (regions, cities). */
+                            dropped_targets: number;
+                            google_campaign_id: string;
+                            keywords: number;
+                            /** Format: int64 */
+                            max_cpc_micros: number;
+                            name: string;
+                            negatives: number;
+                            /** @enum {string} */
+                            state: "ready" | "queued" | "alreadyThere" | "notSearch" | "noMicrosoftLocation" | "noMicrosoftLanguage" | "noAdGroups" | "needsMaxCpc" | "noDailyBudget";
+                        }[];
+                        /** Format: uuid */
+                        google_connection_id: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     getAdsNetworkCampaigns: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zinn-digital/sdk",
-  "version": "0.1.1388",
+  "version": "0.1.1389",
   "description": "Typed TypeScript client for the Zinn Digital Platform API, generated from its OpenAPI spec.",
   "license": "MIT",
   "author": "Neil Lock \u2014 CEO, Zinn Digital\u00ae Ltd <office@zinndigital.com>",