@adcp/sdk 13.0.0-rc.2 → 13.0.0-rc.4

package/dist/lib/types/core.generated.d.mts

@@ -14387,37 +14387,37 @@ export type TasksGetResponse = ProtocolEnvelope & {
  * Valid country-local postal system pairing. Registered countries only accept their registered local systems; countries without a registered local system use postal_code or custom.
  */
 export type PostalCountrySystem = {
-    country?: 'US';
-    system?: 'zip' | 'zip_plus_four';
+    country: 'US';
+    system: 'zip' | 'zip_plus_four';
 } | {
-    country?: 'GB';
-    system?: 'outward' | 'full';
+    country: 'GB';
+    system: 'outward' | 'full';
 } | {
-    country?: 'CA';
-    system?: 'fsa' | 'full';
+    country: 'CA';
+    system: 'fsa' | 'full';
 } | {
-    country?: 'DE' | 'CH' | 'AT';
-    system?: 'plz';
+    country: 'DE' | 'CH' | 'AT';
+    system: 'plz';
 } | {
-    country?: 'FR';
-    system?: 'code_postal';
+    country: 'FR';
+    system: 'code_postal';
 } | {
-    country?: 'AU';
-    system?: 'postcode';
+    country: 'AU';
+    system: 'postcode';
 } | {
-    country?: 'BR';
-    system?: 'cep';
+    country: 'BR';
+    system: 'cep';
 } | {
-    country?: 'IN';
-    system?: 'pin';
+    country: 'IN';
+    system: 'pin';
 } | {
-    country?: 'ZA';
-    system?: 'postal_code';
+    country: 'ZA';
+    system: 'postal_code';
 } | {
-    country?: {
+    country: {
         [k: string]: unknown | undefined;
     };
-    system?: 'postal_code' | 'custom';
+    system: 'postal_code' | 'custom';
 };
 /**
  * Re-export of `PostalArea` under the legacy codegen artifact name.
@@ -18148,7 +18148,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by catalog item within this package. Available for catalog-driven packages when the seller supports item-level reporting.
              */
-            by_catalog_item?: CatalogItemDeliveryMetrics[];
+            by_catalog_item?: GetMediaBuyDeliveryCatalogItemMetrics[];
             /**
              * Metrics broken down by creative within this package. Available when the seller supports creative-level reporting.
              */
@@ -18156,11 +18156,11 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Metrics broken down by keyword within this package. One row per (keyword, match_type) pair — the same keyword with different match types appears as separate rows. Keyword-grain only: rows reflect aggregate performance of each targeted keyword, not individual search queries. Rows may not sum to package totals when a single impression is attributed to the triggering keyword only. Available for search and retail media packages when the seller supports keyword-level reporting.
              */
-            by_keyword?: KeywordDeliveryMetrics[];
+            by_keyword?: GetMediaBuyDeliveryKeywordMetrics[];
             /**
              * Delivery by geographic area within this package. Available when the buyer requests geo breakdown via reporting_dimensions and the seller supports it. Each dimension's rows are independent slices that should sum to the package total.
              */
-            by_geo?: GeoDeliveryMetrics[];
+            by_geo?: GetMediaBuyDeliveryGeoMetrics[];
             /**
              * Whether by_geo was truncated due to the requested limit or a seller-imposed maximum. Sellers MUST return this flag whenever by_geo is present (false means the list is complete).
              */
@@ -18168,9 +18168,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by device form factor within this package. Available when the buyer requests device_type breakdown via reporting_dimensions and the seller supports it.
              */
-            by_device_type?: (DeliveryMetrics & {
-                device_type?: DeviceType;
-            })[];
+            by_device_type?: GetMediaBuyDeliveryDeviceTypeMetrics[];
             /**
              * Whether by_device_type was truncated. Sellers MUST return this flag whenever by_device_type is present (false means the list is complete).
              */
@@ -18178,9 +18176,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by operating system within this package. Available when the buyer requests device_platform breakdown via reporting_dimensions and the seller supports it. Useful for CTV campaigns where tvOS vs Roku OS vs Fire OS matters.
              */
-            by_device_platform?: (DeliveryMetrics & {
-                device_platform?: DevicePlatform;
-            })[];
+            by_device_platform?: GetMediaBuyDeliveryDevicePlatformMetrics[];
             /**
              * Whether by_device_platform was truncated. Sellers MUST return this flag whenever by_device_platform is present (false means the list is complete).
              */
@@ -18188,17 +18184,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by audience segment within this package. Available when the buyer requests audience breakdown via reporting_dimensions and the seller supports it. Only 'synced' audiences are directly targetable via the targeting overlay; other sources are informational.
              */
-            by_audience?: (DeliveryMetrics & {
-                /**
-                 * Audience segment identifier. For 'synced' source, matches audience_id from sync_audiences. For other sources, seller-defined.
-                 */
-                audience_id?: string;
-                audience_source?: AudienceSource;
-                /**
-                 * Human-readable audience segment name
-                 */
-                audience_name?: string;
-            })[];
+            by_audience?: GetMediaBuyDeliveryAudienceMetrics[];
             /**
              * Whether by_audience was truncated. Sellers MUST return this flag whenever by_audience is present (false means the list is complete).
              */
@@ -18206,21 +18192,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by placement within this package. Available when the buyer requests placement breakdown via reporting_dimensions and the seller supports it. Placement IDs reference the product's placements array.
              */
-            by_placement?: (DeliveryMetrics & {
-                /**
-                 * Placement identifier from the product's placements array
-                 */
-                placement_id?: string;
-                /**
-                 * Human-readable placement name
-                 */
-                placement_name?: string;
-                /**
-                 * Canonical publisher domain whose adagents.json namespace this placement belongs to, matching the `publisher_domain` on the product's `placements[]` entry that `placement_id` resolves to (see core/placement.json). Lets buyers attribute delivered impressions to a publisher namespace without re-fetching the product catalog — the common case for multi-publisher buys through a single sales agent. Sellers SHOULD emit it whenever the resolving product placement carries a publisher_domain (always true for `kind: publisher_ref`); sellers MAY omit it only for `seller_inline` placements in a legacy single-publisher context where the seller agent's own domain is the namespace. Single-valued: a placement resolves within exactly one publisher namespace (package-level attribution, where an ad-network product can span publishers, is a separate concern).
-                 * @pattern ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$
-                 */
-                publisher_domain?: string;
-            })[];
+            by_placement?: GetMediaBuyDeliveryPlacementMetrics[];
             /**
              * Whether by_placement was truncated. Sellers MUST return this flag whenever by_placement is present (false means the list is complete).
              */
@@ -18465,7 +18437,7 @@ export type MissingMetric = {
 /**
  * Delivery metrics row for one catalog item within a package.
  */
-export type CatalogItemDeliveryMetrics = DeliveryMetrics & {
+export type GetMediaBuyDeliveryCatalogItemMetrics = DeliveryMetrics & {
     /**
      * Catalog item identifier (e.g., SKU, GTIN, job_id, offering_id)
      */
@@ -18490,7 +18462,7 @@ export type CreativeDeliveryMetrics = DeliveryMetrics & {
 /**
  * Delivery metrics row for one keyword and match-type pair within a package.
  */
-export type KeywordDeliveryMetrics = DeliveryMetrics & {
+export type GetMediaBuyDeliveryKeywordMetrics = DeliveryMetrics & {
     /**
      * The targeted keyword
      */
@@ -18500,7 +18472,7 @@ export type KeywordDeliveryMetrics = DeliveryMetrics & {
 /**
  * Delivery metrics row for one geographic area within a package.
  */
-export type GeoDeliveryMetrics = DeliveryMetrics & {
+export type GetMediaBuyDeliveryGeoMetrics = DeliveryMetrics & {
     geo_level?: GeographicTargetingLevel;
     /**
      * Classification system for metro or postal_area levels. Metro rows use metro-system values. Native postal rows use country-local postal-system values with country; deprecated legacy postal rows may use legacy-postal-system values.
@@ -18520,6 +18492,38 @@ export type GeoDeliveryMetrics = DeliveryMetrics & {
      */
     geo_name?: string;
 };
+export type GetMediaBuyDeliveryDeviceTypeMetrics = DeliveryMetrics & {
+    device_type?: DeviceType;
+};
+export type GetMediaBuyDeliveryDevicePlatformMetrics = DeliveryMetrics & {
+    device_platform?: DevicePlatform;
+};
+export type GetMediaBuyDeliveryAudienceMetrics = DeliveryMetrics & {
+    /**
+     * Audience segment identifier. For 'synced' source, matches audience_id from sync_audiences. For other sources, seller-defined.
+     */
+    audience_id?: string;
+    audience_source?: AudienceSource;
+    /**
+     * Human-readable audience segment name
+     */
+    audience_name?: string;
+};
+export type GetMediaBuyDeliveryPlacementMetrics = DeliveryMetrics & {
+    /**
+     * Placement identifier from the product's placements array
+     */
+    placement_id?: string;
+    /**
+     * Human-readable placement name
+     */
+    placement_name?: string;
+    /**
+     * Canonical publisher domain whose adagents.json namespace this placement belongs to, matching the `publisher_domain` on the product's `placements[]` entry that `placement_id` resolves to (see core/placement.json). Lets buyers attribute delivered impressions to a publisher namespace without re-fetching the product catalog — the common case for multi-publisher buys through a single sales agent. Sellers SHOULD emit it whenever the resolving product placement carries a publisher_domain (always true for `kind: publisher_ref`); sellers MAY omit it only for `seller_inline` placements in a legacy single-publisher context where the seller agent's own domain is the namespace. Single-valued: a placement resolves within exactly one publisher namespace (package-level attribution, where an ad-network product can span publishers, is a separate concern).
+     * @pattern ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$
+     */
+    publisher_domain?: string;
+};
 /**
  * Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots
  */
@@ -24182,6 +24186,16 @@ export interface CanonicalProjectionSlotOverride {
      */
     consumed_for_production?: boolean;
 }
+/**
+ * Delivery metrics row for one catalog item within a package.
+ */
+export type CatalogItemDeliveryMetrics = DeliveryMetrics & {
+    /**
+     * Catalog item identifier (e.g., SKU, GTIN, job_id, offering_id)
+     */
+    content_id: string;
+    content_id_type?: ContentIDType;
+};
 /**
  * A catchment area definition for a store or location. Defines the geographic area from which a store draws customers. Three methods are supported: isochrone inputs (travel time + transport mode, platform resolves the shape), simple radius (distance from location), or pre-computed GeoJSON geometry (buyer provides the exact boundary). Provide exactly one method per catchment.
  */
@@ -25278,6 +25292,29 @@ export interface BaseGroupAsset {
      */
     overlays?: Overlay[];
 }
+/**
+ * Delivery metrics row for one geographic area within a package.
+ */
+export type GeoDeliveryMetrics = DeliveryMetrics & {
+    geo_level: GeographicTargetingLevel;
+    /**
+     * Classification system for metro or postal_area levels. Metro rows use metro-system values. Native postal rows use country-local postal-system values with country; deprecated legacy postal rows may use legacy-postal-system values.
+     */
+    system?: string;
+    /**
+     * ISO 3166-1 alpha-2 country code for native postal_area rows.
+     * @pattern ^[A-Z]{2}$
+     */
+    country?: string;
+    /**
+     * Geographic code within the level and system. Country: ISO 3166-1 alpha-2 ('US'). Region: ISO 3166-2 with country prefix ('US-CA'). Metro/postal: system-specific code ('501', '10001').
+     */
+    geo_code: string;
+    /**
+     * Human-readable geographic name (e.g., 'United States', 'California', 'New York DMA')
+     */
+    geo_name?: string;
+};
 /**
  * A hotel or lodging property within a hotel-type catalog. Carries the property data that platforms use for hotel ads, dynamic remarketing, and travel campaign creatives. Maps to Google Hotel Center feeds, Meta hotel catalogs, and similar platform-native formats.
  */
@@ -25478,6 +25515,16 @@ export interface JobItem {
     assets?: OfferingAssetGroup[];
     ext?: ExtensionObject;
 }
+/**
+ * Delivery metrics row for one keyword and match-type pair within a package.
+ */
+export type KeywordDeliveryMetrics = DeliveryMetrics & {
+    /**
+     * The targeted keyword
+     */
+    keyword: string;
+    match_type: MatchType;
+};
 /**
  * A promotable offering from a brand. Can represent a campaign, product promotion, service, or any other thing the brand wants to make available. Offerings carry structured asset groups for creative assembly and can be promoted via traditional creatives or conversational SI experiences (via the brand's SI agent).
  */

package/dist/lib/types/core.generated.d.ts

@@ -14387,37 +14387,37 @@ export type TasksGetResponse = ProtocolEnvelope & {
  * Valid country-local postal system pairing. Registered countries only accept their registered local systems; countries without a registered local system use postal_code or custom.
  */
 export type PostalCountrySystem = {
-    country?: 'US';
-    system?: 'zip' | 'zip_plus_four';
+    country: 'US';
+    system: 'zip' | 'zip_plus_four';
 } | {
-    country?: 'GB';
-    system?: 'outward' | 'full';
+    country: 'GB';
+    system: 'outward' | 'full';
 } | {
-    country?: 'CA';
-    system?: 'fsa' | 'full';
+    country: 'CA';
+    system: 'fsa' | 'full';
 } | {
-    country?: 'DE' | 'CH' | 'AT';
-    system?: 'plz';
+    country: 'DE' | 'CH' | 'AT';
+    system: 'plz';
 } | {
-    country?: 'FR';
-    system?: 'code_postal';
+    country: 'FR';
+    system: 'code_postal';
 } | {
-    country?: 'AU';
-    system?: 'postcode';
+    country: 'AU';
+    system: 'postcode';
 } | {
-    country?: 'BR';
-    system?: 'cep';
+    country: 'BR';
+    system: 'cep';
 } | {
-    country?: 'IN';
-    system?: 'pin';
+    country: 'IN';
+    system: 'pin';
 } | {
-    country?: 'ZA';
-    system?: 'postal_code';
+    country: 'ZA';
+    system: 'postal_code';
 } | {
-    country?: {
+    country: {
         [k: string]: unknown | undefined;
     };
-    system?: 'postal_code' | 'custom';
+    system: 'postal_code' | 'custom';
 };
 /**
  * Re-export of `PostalArea` under the legacy codegen artifact name.
@@ -18148,7 +18148,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by catalog item within this package. Available for catalog-driven packages when the seller supports item-level reporting.
              */
-            by_catalog_item?: CatalogItemDeliveryMetrics[];
+            by_catalog_item?: GetMediaBuyDeliveryCatalogItemMetrics[];
             /**
              * Metrics broken down by creative within this package. Available when the seller supports creative-level reporting.
              */
@@ -18156,11 +18156,11 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Metrics broken down by keyword within this package. One row per (keyword, match_type) pair — the same keyword with different match types appears as separate rows. Keyword-grain only: rows reflect aggregate performance of each targeted keyword, not individual search queries. Rows may not sum to package totals when a single impression is attributed to the triggering keyword only. Available for search and retail media packages when the seller supports keyword-level reporting.
              */
-            by_keyword?: KeywordDeliveryMetrics[];
+            by_keyword?: GetMediaBuyDeliveryKeywordMetrics[];
             /**
              * Delivery by geographic area within this package. Available when the buyer requests geo breakdown via reporting_dimensions and the seller supports it. Each dimension's rows are independent slices that should sum to the package total.
              */
-            by_geo?: GeoDeliveryMetrics[];
+            by_geo?: GetMediaBuyDeliveryGeoMetrics[];
             /**
              * Whether by_geo was truncated due to the requested limit or a seller-imposed maximum. Sellers MUST return this flag whenever by_geo is present (false means the list is complete).
              */
@@ -18168,9 +18168,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by device form factor within this package. Available when the buyer requests device_type breakdown via reporting_dimensions and the seller supports it.
              */
-            by_device_type?: (DeliveryMetrics & {
-                device_type?: DeviceType;
-            })[];
+            by_device_type?: GetMediaBuyDeliveryDeviceTypeMetrics[];
             /**
              * Whether by_device_type was truncated. Sellers MUST return this flag whenever by_device_type is present (false means the list is complete).
              */
@@ -18178,9 +18176,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by operating system within this package. Available when the buyer requests device_platform breakdown via reporting_dimensions and the seller supports it. Useful for CTV campaigns where tvOS vs Roku OS vs Fire OS matters.
              */
-            by_device_platform?: (DeliveryMetrics & {
-                device_platform?: DevicePlatform;
-            })[];
+            by_device_platform?: GetMediaBuyDeliveryDevicePlatformMetrics[];
             /**
              * Whether by_device_platform was truncated. Sellers MUST return this flag whenever by_device_platform is present (false means the list is complete).
              */
@@ -18188,17 +18184,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by audience segment within this package. Available when the buyer requests audience breakdown via reporting_dimensions and the seller supports it. Only 'synced' audiences are directly targetable via the targeting overlay; other sources are informational.
              */
-            by_audience?: (DeliveryMetrics & {
-                /**
-                 * Audience segment identifier. For 'synced' source, matches audience_id from sync_audiences. For other sources, seller-defined.
-                 */
-                audience_id?: string;
-                audience_source?: AudienceSource;
-                /**
-                 * Human-readable audience segment name
-                 */
-                audience_name?: string;
-            })[];
+            by_audience?: GetMediaBuyDeliveryAudienceMetrics[];
             /**
              * Whether by_audience was truncated. Sellers MUST return this flag whenever by_audience is present (false means the list is complete).
              */
@@ -18206,21 +18192,7 @@ export type GetMediaBuyDeliveryResponse = ProtocolEnvelope & {
             /**
              * Delivery by placement within this package. Available when the buyer requests placement breakdown via reporting_dimensions and the seller supports it. Placement IDs reference the product's placements array.
              */
-            by_placement?: (DeliveryMetrics & {
-                /**
-                 * Placement identifier from the product's placements array
-                 */
-                placement_id?: string;
-                /**
-                 * Human-readable placement name
-                 */
-                placement_name?: string;
-                /**
-                 * Canonical publisher domain whose adagents.json namespace this placement belongs to, matching the `publisher_domain` on the product's `placements[]` entry that `placement_id` resolves to (see core/placement.json). Lets buyers attribute delivered impressions to a publisher namespace without re-fetching the product catalog — the common case for multi-publisher buys through a single sales agent. Sellers SHOULD emit it whenever the resolving product placement carries a publisher_domain (always true for `kind: publisher_ref`); sellers MAY omit it only for `seller_inline` placements in a legacy single-publisher context where the seller agent's own domain is the namespace. Single-valued: a placement resolves within exactly one publisher namespace (package-level attribution, where an ad-network product can span publishers, is a separate concern).
-                 * @pattern ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$
-                 */
-                publisher_domain?: string;
-            })[];
+            by_placement?: GetMediaBuyDeliveryPlacementMetrics[];
             /**
              * Whether by_placement was truncated. Sellers MUST return this flag whenever by_placement is present (false means the list is complete).
              */
@@ -18465,7 +18437,7 @@ export type MissingMetric = {
 /**
  * Delivery metrics row for one catalog item within a package.
  */
-export type CatalogItemDeliveryMetrics = DeliveryMetrics & {
+export type GetMediaBuyDeliveryCatalogItemMetrics = DeliveryMetrics & {
     /**
      * Catalog item identifier (e.g., SKU, GTIN, job_id, offering_id)
      */
@@ -18490,7 +18462,7 @@ export type CreativeDeliveryMetrics = DeliveryMetrics & {
 /**
  * Delivery metrics row for one keyword and match-type pair within a package.
  */
-export type KeywordDeliveryMetrics = DeliveryMetrics & {
+export type GetMediaBuyDeliveryKeywordMetrics = DeliveryMetrics & {
     /**
      * The targeted keyword
      */
@@ -18500,7 +18472,7 @@ export type KeywordDeliveryMetrics = DeliveryMetrics & {
 /**
  * Delivery metrics row for one geographic area within a package.
  */
-export type GeoDeliveryMetrics = DeliveryMetrics & {
+export type GetMediaBuyDeliveryGeoMetrics = DeliveryMetrics & {
     geo_level?: GeographicTargetingLevel;
     /**
      * Classification system for metro or postal_area levels. Metro rows use metro-system values. Native postal rows use country-local postal-system values with country; deprecated legacy postal rows may use legacy-postal-system values.
@@ -18520,6 +18492,38 @@ export type GeoDeliveryMetrics = DeliveryMetrics & {
      */
     geo_name?: string;
 };
+export type GetMediaBuyDeliveryDeviceTypeMetrics = DeliveryMetrics & {
+    device_type?: DeviceType;
+};
+export type GetMediaBuyDeliveryDevicePlatformMetrics = DeliveryMetrics & {
+    device_platform?: DevicePlatform;
+};
+export type GetMediaBuyDeliveryAudienceMetrics = DeliveryMetrics & {
+    /**
+     * Audience segment identifier. For 'synced' source, matches audience_id from sync_audiences. For other sources, seller-defined.
+     */
+    audience_id?: string;
+    audience_source?: AudienceSource;
+    /**
+     * Human-readable audience segment name
+     */
+    audience_name?: string;
+};
+export type GetMediaBuyDeliveryPlacementMetrics = DeliveryMetrics & {
+    /**
+     * Placement identifier from the product's placements array
+     */
+    placement_id?: string;
+    /**
+     * Human-readable placement name
+     */
+    placement_name?: string;
+    /**
+     * Canonical publisher domain whose adagents.json namespace this placement belongs to, matching the `publisher_domain` on the product's `placements[]` entry that `placement_id` resolves to (see core/placement.json). Lets buyers attribute delivered impressions to a publisher namespace without re-fetching the product catalog — the common case for multi-publisher buys through a single sales agent. Sellers SHOULD emit it whenever the resolving product placement carries a publisher_domain (always true for `kind: publisher_ref`); sellers MAY omit it only for `seller_inline` placements in a legacy single-publisher context where the seller agent's own domain is the namespace. Single-valued: a placement resolves within exactly one publisher namespace (package-level attribution, where an ad-network product can span publishers, is a separate concern).
+     * @pattern ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$
+     */
+    publisher_domain?: string;
+};
 /**
  * Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots
  */
@@ -24182,6 +24186,16 @@ export interface CanonicalProjectionSlotOverride {
      */
     consumed_for_production?: boolean;
 }
+/**
+ * Delivery metrics row for one catalog item within a package.
+ */
+export type CatalogItemDeliveryMetrics = DeliveryMetrics & {
+    /**
+     * Catalog item identifier (e.g., SKU, GTIN, job_id, offering_id)
+     */
+    content_id: string;
+    content_id_type?: ContentIDType;
+};
 /**
  * A catchment area definition for a store or location. Defines the geographic area from which a store draws customers. Three methods are supported: isochrone inputs (travel time + transport mode, platform resolves the shape), simple radius (distance from location), or pre-computed GeoJSON geometry (buyer provides the exact boundary). Provide exactly one method per catchment.
  */
@@ -25278,6 +25292,29 @@ export interface BaseGroupAsset {
      */
     overlays?: Overlay[];
 }
+/**
+ * Delivery metrics row for one geographic area within a package.
+ */
+export type GeoDeliveryMetrics = DeliveryMetrics & {
+    geo_level: GeographicTargetingLevel;
+    /**
+     * Classification system for metro or postal_area levels. Metro rows use metro-system values. Native postal rows use country-local postal-system values with country; deprecated legacy postal rows may use legacy-postal-system values.
+     */
+    system?: string;
+    /**
+     * ISO 3166-1 alpha-2 country code for native postal_area rows.
+     * @pattern ^[A-Z]{2}$
+     */
+    country?: string;
+    /**
+     * Geographic code within the level and system. Country: ISO 3166-1 alpha-2 ('US'). Region: ISO 3166-2 with country prefix ('US-CA'). Metro/postal: system-specific code ('501', '10001').
+     */
+    geo_code: string;
+    /**
+     * Human-readable geographic name (e.g., 'United States', 'California', 'New York DMA')
+     */
+    geo_name?: string;
+};
 /**
  * A hotel or lodging property within a hotel-type catalog. Carries the property data that platforms use for hotel ads, dynamic remarketing, and travel campaign creatives. Maps to Google Hotel Center feeds, Meta hotel catalogs, and similar platform-native formats.
  */
@@ -25478,6 +25515,16 @@ export interface JobItem {
     assets?: OfferingAssetGroup[];
     ext?: ExtensionObject;
 }
+/**
+ * Delivery metrics row for one keyword and match-type pair within a package.
+ */
+export type KeywordDeliveryMetrics = DeliveryMetrics & {
+    /**
+     * The targeted keyword
+     */
+    keyword: string;
+    match_type: MatchType;
+};
 /**
  * A promotable offering from a brand. Can represent a campaign, product promotion, service, or any other thing the brand wants to make available. Offerings carry structured asset groups for creative assembly and can be promoted via traditional creatives or conversational SI experiences (via the brand's SI agent).
  */