@zinn-digital/sdk 0.1.1352 → 0.1.1354

package/dist/generated/schema.d.ts

@@ -6288,7 +6288,7 @@ export interface paths {
         put?: never;
         /**
          * Do what an audit finding proposes in the Google Ads account (audited).
-         * @description A wasteful search term is added as an exact negative to its shared list (or, for a search served by two campaigns — `detail.why = "cannibal"` — to the one campaign it does not belong in); a poor keyword is paused; a converting or growing search term (`good_term`, `new_keyword`) is added as a PHRASE keyword to the ad group it was searched in. Every change is first replayed against 30 days of search terms and every keyword (the collision simulator). One write to the account, then the finding is closed as `applied`. 422 for a finding that is closed or has nothing to apply (including a keyword proposal that failed a safety check, `detail.one_click = false`), `refusal.googleAds.wouldBlockKeyword` for a negative that is one of our own keywords (owner decision 133: never) and `refusal.googleAds.wouldCollide` when the change would stop a main, converting or growing search or take one from another ad group (the reasons are saved on `detail.collision`); 503 when Google refuses (the finding stays open). Audit action `google_ads.finding_applied`. Requires `campaigns.manage`. BUDGETMV1 (za-186): a budget-limited finding's body may name `option` — `move` (default, total unchanged) or `increase` (the campaign alone raised, refused with 422 when the monthly ceiling no longer has that room today).
+         * @description A wasteful search term is added as an exact negative to its shared list (or, for a search served by two campaigns — `detail.why = "cannibal"` — to the one campaign it does not belong in); a poor keyword is paused; a converting or growing search term (`good_term`, `new_keyword`) is added as a PHRASE keyword to the ad group it was searched in. Every change is first replayed against 30 days of search terms and every keyword (the collision simulator). One write to the account, then the finding is closed as `applied`. 422 for a finding that is closed or has nothing to apply (including a keyword proposal that failed a safety check, `detail.one_click = false`), `refusal.googleAds.wouldBlockKeyword` for a negative that is one of our own keywords (owner decision 133: never) and `refusal.googleAds.wouldCollide` when the change would stop a main, converting or growing search or take one from another ad group (the reasons are saved on `detail.collision`); 503 when Google refuses (the finding stays open). za-260 (WAVEBUILD): approving a wave's budget twice at once builds it once (the budget and plan rows are locked and re-read); the enable of a wave whose read-back set is no longer what was built is refused with `refusal.googleAds.waveEnableRefused`, the row stays open with the reasons on `detail.enable_refused` (each `market`, `campaign`, `code` — `not_paused`, `bidding`, `target_cpa`, `budget`, `country`, `negatives` with the missing `negatives`, or `set` — and `detail.enable_refused_at`) and the error's `details` carry the same reasons (`field` `campaigns.<market>`, `code`, English `message`). Audit action `google_ads.finding_applied`. Requires `campaigns.manage`. BUDGETMV1 (za-186): a budget-limited finding's body may name `option` — `move` (default, total unchanged) or `increase` (the campaign alone raised, refused with 422 when the monthly ceiling no longer has that room today).
          */
         post: operations["applyAdminGoogleAdsFinding"];
         delete?: never;
@@ -17280,7 +17280,7 @@ export interface paths {
         put?: never;
         /**
          * Buy one tracking number that forwards to the customer's own number (za-160).
-         * @description Gated on `ads.manage`; audit action `ads.call_number_ordered` (no phone number in its metadata). The price is the voice vendor's own answer for that number, re-read now, times the platform margin; the first month is taken from the org's prepaid Zinn® credit BEFORE the order and returned if the vendor refuses it. Refused (422) when call tracking is not open (`callNotOpen`), the CRM source `telnyx` is not set up (`callNoSource`), the forward-to number is not a United States number (`callForwardToNotOffered`), the account holds its cap (`callTooMany`), the account is not in good standing (`callAccountOnHold`), the credit is short (`callNoCredit`), the number was taken (`callNumberGone`) or its price is no longer the `first_month_usd_micros` the customer was shown (`callPriceChanged`, nothing charged). A vendor that does not answer the order leaves the number `ordering`: it is found by its reference, or refunded, within the next sweep.
+         * @description Gated on `ads.manage`; audit action `ads.call_number_ordered` (no phone number in its metadata). The price is the voice vendor's own answer for that number, re-read now, times the platform margin; the first charge (the vendor's upfront fee plus the first month, both taken by the vendor at purchase) is taken from the org's prepaid Zinn® credit BEFORE the order and returned if the vendor refuses it. Refused (422) when call tracking is not open (`callNotOpen`), the CRM source `telnyx` is not set up (`callNoSource`), the forward-to number is not a United States number or is one of our own tracking numbers (a call loop, `callForwardToNotOffered`), the account holds its cap (`callTooMany`), the account is not in good standing (`callAccountOnHold`), the credit is short (`callNoCredit`), the number was taken (`callNumberGone`) or its price is no longer the `first_month_usd_micros` the customer was shown (`callPriceChanged`, nothing charged). An order the vendor has not finished yet leaves the number `ordering` and starts the account's number sweep at once (retried until it completes); a vendor that does not answer the order leaves it `ordering` too: it is found by its reference, or refunded.
          */
         post: operations["orderAdsCallNumber"];
         delete?: never;
@@ -61801,7 +61801,10 @@ export interface components {
             source_id: string | null;
         };
         AdsCallNumberOffer: {
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description What buying it costs now — the vendor's upfront fee plus the first month, with the margin.
+             */
             first_month_usd_micros: number;
             locality: string;
             /** Format: int64 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zinn-digital/sdk",
-  "version": "0.1.1352",
+  "version": "0.1.1354",
   "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>",