@zinn-digital/sdk 0.1.1387 → 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;
@@ -46057,7 +46083,7 @@ export interface paths {
         };
         /**
          * Read a site's automatic app updates add-on and its window.
-         * @description The paid automatic-updates add-on for the app the site runs (`wordpress_auto_updates`, `woocommerce_auto_updates`, `joomla_auto_updates`, `drupal_auto_updates`, `mediawiki_auto_updates` or `phpbb_auto_updates`, USD 29 a year per site; `nextcloud_auto_updates`, USD 50 a year per site; s1014 row 41): whether it is on sale and on, its price in the caller's currency, the renewal, the quiet window and the last run. Each run takes a safety backup first and rolls back to it when the homepage breaks. WordPress: core, plugins and themes (a held plugin version is never applied). Joomla!: the core only, through Joomla's own console; extensions and templates are not updated. Nextcloud: the server through its own updater, then every app with an update. Drupal: the core only (the newest release of the installed major version, then its database updates); contributed modules and themes are not updated. MediaWiki: the newest stable release with its bundled extensions and skins, then its own update script; extensions the customer added are not updated. phpBB: the newest release of the installed branch with its bundled style, language and extension, then its own `db:migrate`; styles, language packs and extensions the customer added are not updated. Buy it through `purchaseExtra` with `site_id`. Requires `sites.view`.
+         * @description The paid automatic-updates add-on for the app the site runs (`wordpress_auto_updates`, `woocommerce_auto_updates`, `joomla_auto_updates`, `drupal_auto_updates`, `mediawiki_auto_updates` or `phpbb_auto_updates`, USD 29 a year per site; `nextcloud_auto_updates` or `owncloud_auto_updates`, USD 50 a year per site; s1014 row 41): whether it is on sale and on, its price in the caller's currency, the renewal, the quiet window and the last run. Each run takes a safety backup first and rolls back to it when the homepage breaks. WordPress: core, plugins and themes (a held plugin version is never applied). Joomla!: the core only, through Joomla's own console; extensions and templates are not updated. Nextcloud: the server through its own updater, then every app with an update. Drupal: the core only (the newest release of the installed major version, then its database updates); contributed modules and themes are not updated. MediaWiki: the newest stable release with its bundled extensions and skins, then its own update script; extensions the customer added are not updated. phpBB: the newest release of the installed branch with its bundled style, language and extension, then its own `db:migrate`; styles, language packs and extensions the customer added are not updated. ownCloud: the newest release of the installed major version (the complete build, with its bundled apps), then its own `occ upgrade`; apps from the ownCloud marketplace are not updated. Buy it through `purchaseExtra` with `site_id`. Requires `sites.view`.
          */
         get: operations["getSiteAppAutoUpdate"];
         /**
@@ -96000,7 +96026,7 @@ export interface components {
             total_ms: number;
             transaction: string;
         };
-        /** @description The paid automatic app updates add-on for one site (s1014 row 41): the code that applies (`wordpress_auto_updates`, `woocommerce_auto_updates`, `joomla_auto_updates`, `nextcloud_auto_updates`, `drupal_auto_updates`, `mediawiki_auto_updates` or `phpbb_auto_updates`), the window and the last run's outcome. */
+        /** @description The paid automatic app updates add-on for one site (s1014 row 41): the code that applies (`wordpress_auto_updates`, `woocommerce_auto_updates`, `joomla_auto_updates`, `nextcloud_auto_updates`, `drupal_auto_updates`, `mediawiki_auto_updates`, `phpbb_auto_updates` or `owncloud_auto_updates`), the window and the last run's outcome. */
         SiteAppAutoUpdate: {
             /** @description Whether the add-on is on and in good standing now. */
             active: boolean;
@@ -96008,7 +96034,7 @@ export interface components {
              * @description The app the add-on serves on this site, or null when none is sold for it.
              * @enum {string|null}
              */
-            app_key: "wordpress" | "woocommerce" | "joomla" | "nextcloud" | "phpbb" | "mediawiki" | "drupal" | null;
+            app_key: "wordpress" | "woocommerce" | "joomla" | "nextcloud" | "phpbb" | "owncloud" | "mediawiki" | "drupal" | null;
             can_buy: boolean;
             /** @description The catalogue code to buy (`<app_key>_auto_updates`). */
             code: string | null;
@@ -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.1387",
+  "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>",