@zinn-digital/sdk 0.1.1366 → 0.1.1368

package/dist/generated/schema.d.ts

@@ -1767,6 +1767,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/admin/ads/connections/{connection_id}/measurement-health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * Measurement health of any connection, the house included (za-253).
+         * @description Gated on `campaigns.view`. Staff, any connection, the house included: the same payload as `getAdsMeasurementHealth` (docs/1006 §ADSOPT), read from the stored rows — never a network call in the request. Every read is audited: action `ads.measurement_health_viewed` (platform-wide, metadata: the account's `org_id`).
+         */
+        get: operations["getAdminAdsMeasurementHealth"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/admin/ads/kill-switch": {
         parameters: {
             query?: never;
@@ -17977,6 +17999,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/ads/connections/{connection_id}/measurement-health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * Optimisation score, conversion goals, offline uploads and PMax automation (za-253).
+         * @description Gated on `ads.view`. What the daily audit's measurement-health step stored for the caller's own connection (docs/1006 §ADSOPT), never a network call in the request: Google's optimisation score in basis points (`score_bp`, 9307 = 93.07%) with one point per day (`trend`, last 30 days), each enabled campaign's score, the conversion goals that count nothing because their category has no enabled primary action (`goals.missing`: a campaign with nothing left to bid for, a person must choose one; `goals.suggested`: one click to take a goal out of bidding; `goals.switched_off`: done by the autopilot, with Undo on the findings list), the offline-conversion uploads Google reports failing in the last two days (`uploads`, with Google's error code), and each Performance Max campaign's asset-automation switches (`automation`, read only). `checked_at` is null before the first audit.
+         */
+        get: operations["getAdsMeasurementHealth"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/ads/connections/{connection_id}/merchant-feed": {
         parameters: {
             query?: never;
@@ -62912,6 +62956,69 @@ export interface components {
             /** @description Where this market's ads land (its language's page). */
             url: string;
         };
+        /** @description ADSOPT (za-253, docs/1006 §ADSOPT) — what the audit's measurement-health step stored. */
+        AdsMeasurementHealth: {
+            automation: {
+                campaign: string;
+                campaign_id: string;
+                switches: {
+                    [key: string]: boolean;
+                };
+            }[];
+            campaigns: {
+                campaign: string;
+                campaign_id: string;
+                score_bp: number;
+            }[];
+            /** Format: date-time */
+            checked_at: string | null;
+            /** Format: uuid */
+            connection_id: string;
+            goals: {
+                missing: number;
+                open: {
+                    campaign: string;
+                    campaign_id: string;
+                    goal: string;
+                    goals: string[];
+                    /** Format: uuid */
+                    id: string;
+                    /** Format: date-time */
+                    since: string;
+                    /** @enum {string} */
+                    why: "goal_missing" | "suggest_goal_no_primary";
+                }[];
+                suggested: number;
+                switched_off: {
+                    /** Format: date-time */
+                    at: string | null;
+                    campaign: string;
+                    goal: string;
+                    /** Format: uuid */
+                    id: string;
+                }[];
+            };
+            score_bp: number | null;
+            trend: {
+                /** Format: date */
+                day: string;
+                score_bp: number;
+            }[];
+            uploads: {
+                data: {
+                    action: string;
+                    error: string;
+                    failed: number;
+                    /** Format: uuid */
+                    id: string;
+                    last_upload: string;
+                    /** Format: date-time */
+                    since: string;
+                    total: number;
+                }[];
+                failing: number;
+            };
+        };
         /** @description za-188 (docs/1006 §80): a connection's Shopping feed audit. `result` is the last daily audit (empty before the first): `counts` (whole, never capped), `threshold` (`recommended_micros`, `customer_micros`, `used_micros`, `source`), `issues`, `mismatches`, `out_of_stock`, `waste` (each at most 50 rows, most spend first), `stock_pause_link`, `disapprovals_reported` (false on Microsoft — its Content API reports no serving status), `merchant_api` (`off` · `read` · `refused` · `truncated`). Money in micros of the account's currency. */
         AdsMerchantFeed: {
             /** Format: uuid */
@@ -111634,6 +111741,32 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    getAdminAdsMeasurementHealth: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The measurement health of this connection. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdsMeasurementHealth"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     getAdminAdsKillSwitch: {
         parameters: {
             query?: never;
@@ -137681,6 +137814,32 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    getAdsMeasurementHealth: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                connection_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The measurement health of this connection. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdsMeasurementHealth"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     getAdsMerchantFeed: {
         parameters: {
             query?: never;

package/package.json

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