@trillboards/api-client 3.2.16 → 3.2.17

package/dist/generated.d.mts

@@ -761,9 +761,9 @@ type DataApi_AdSightingRecord = {
     frame_box_y0: number | null;
     frame_box_y1: number | null;
     frame_expires_at: string | null;
-    /** A signed, read-only link to the whole still the ad was read off. */
+    /** A short-lived capability link to the whole still the ad was read off, face-blurred: the still's blurred rendition, never the original. Null until the still is blurred, and for a still the face-blur engine excluded. */
     frame_url: string | null;
-    /** ssr-v1, vlmtext-v1 or edge_ocr_v1. */
+    /** ssr-v2 or ssr-v1 (the still reader), vlmtext-v1 or edge_ocr_v1. */
     instrument_version: string | null;
     /** The face carried no advertiser. */
     is_vacancy: boolean;
@@ -786,10 +786,12 @@ type DataApi_AdSightingRecord = {
     photo_box_y0: number | null;
     photo_box_y1: number | null;
     photo_expires_at: string | null;
-    /** The ad itself: closeup = the capture-resolution close-up a tablet uploaded; crop = the ad cut from the frame at request time (its box padded 50% per side), never stored. */
+    /** The ad itself, face-blurred: closeup = the capture-resolution close-up a tablet uploaded, its blurred rendition whole; crop = the ad cut at request time from the blurred frame (its box padded 50% per side), never stored. Null when no picture of the ad can be shared. */
     photo_kind: "closeup" | "crop" | null | null;
-    /** A short-lived link to the photo (a signed capability for a crop). */
+    /** A short-lived capability link to the photo on our endpoint. It serves the face-blurred rendition only (faces are always blurred in any in-vehicle picture), never the original; null until the still is blurred, and for a still the face-blur engine excluded. */
     photo_url: string | null;
+    /** What kind of placement the reader judged the ad to be (still reader ssr-v2): paid_ad = a third party's ad on space a media owner sells; own_premises = the business's own sign at or by its own place, or its own vehicle livery; other = neither. Null where the reading classified none (ssr-v1, vlmtext-v1, edge_ocr_v1). */
+    placement: "paid_ad" | "own_premises" | "other" | null | null;
     product_as_read: string | null;
     publisher_name: string | null;
     /** The still instant, UTC. */
@@ -4404,7 +4406,7 @@ interface dataApiAdSightingsOperation {
         cursor?: string;
         /** Start (inclusive), YYYY-MM-DD or an ISO-8601 instant. Default: 30 days before `to`. */
         from?: string;
-        /** The reading instrument (ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable. */
+        /** The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable. */
         instrument?: Array<string> | null;
         /** Records per page, 1..500 (default 50). The page limit is reserved; the records returned are billed. */
         limit?: number;

package/dist/generated.d.ts

@@ -761,9 +761,9 @@ type DataApi_AdSightingRecord = {
     frame_box_y0: number | null;
     frame_box_y1: number | null;
     frame_expires_at: string | null;
-    /** A signed, read-only link to the whole still the ad was read off. */
+    /** A short-lived capability link to the whole still the ad was read off, face-blurred: the still's blurred rendition, never the original. Null until the still is blurred, and for a still the face-blur engine excluded. */
     frame_url: string | null;
-    /** ssr-v1, vlmtext-v1 or edge_ocr_v1. */
+    /** ssr-v2 or ssr-v1 (the still reader), vlmtext-v1 or edge_ocr_v1. */
     instrument_version: string | null;
     /** The face carried no advertiser. */
     is_vacancy: boolean;
@@ -786,10 +786,12 @@ type DataApi_AdSightingRecord = {
     photo_box_y0: number | null;
     photo_box_y1: number | null;
     photo_expires_at: string | null;
-    /** The ad itself: closeup = the capture-resolution close-up a tablet uploaded; crop = the ad cut from the frame at request time (its box padded 50% per side), never stored. */
+    /** The ad itself, face-blurred: closeup = the capture-resolution close-up a tablet uploaded, its blurred rendition whole; crop = the ad cut at request time from the blurred frame (its box padded 50% per side), never stored. Null when no picture of the ad can be shared. */
     photo_kind: "closeup" | "crop" | null | null;
-    /** A short-lived link to the photo (a signed capability for a crop). */
+    /** A short-lived capability link to the photo on our endpoint. It serves the face-blurred rendition only (faces are always blurred in any in-vehicle picture), never the original; null until the still is blurred, and for a still the face-blur engine excluded. */
     photo_url: string | null;
+    /** What kind of placement the reader judged the ad to be (still reader ssr-v2): paid_ad = a third party's ad on space a media owner sells; own_premises = the business's own sign at or by its own place, or its own vehicle livery; other = neither. Null where the reading classified none (ssr-v1, vlmtext-v1, edge_ocr_v1). */
+    placement: "paid_ad" | "own_premises" | "other" | null | null;
     product_as_read: string | null;
     publisher_name: string | null;
     /** The still instant, UTC. */
@@ -4404,7 +4406,7 @@ interface dataApiAdSightingsOperation {
         cursor?: string;
         /** Start (inclusive), YYYY-MM-DD or an ISO-8601 instant. Default: 30 days before `to`. */
         from?: string;
-        /** The reading instrument (ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable. */
+        /** The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable. */
         instrument?: Array<string> | null;
         /** Records per page, 1..500 (default 50). The page limit is reserved; the records returned are billed. */
         limit?: number;