adcp 2.18.0__py3-none-any.whl → 2.19.0__py3-none-any.whl

adcp/types/generated_poc/core/package.py

@@ -17,19 +17,19 @@ from . import format_id, targeting
 
 class Package(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     bid_price: Annotated[
         float | None,
         Field(
-            description='Bid price for auction-based CPM pricing (present if using cpm-auction-option)',
+            description="Bid price for auction-based CPM pricing (present if using cpm-auction-option)",
             ge=0.0,
         ),
     ] = None
     budget: Annotated[
         float | None,
         Field(
-            description='Budget allocation for this package in the currency specified by the pricing option',
+            description="Budget allocation for this package in the currency specified by the pricing option",
             ge=0.0,
         ),
     ] = None
@@ -38,22 +38,22 @@ class Package(AdCPBaseModel):
     ] = None
     creative_assignments: Annotated[
         list[creative_assignment.CreativeAssignment] | None,
-        Field(description='Creative assets assigned to this package'),
+        Field(description="Creative assets assigned to this package"),
     ] = None
     ext: ext_1.ExtensionObject | None = None
     format_ids_to_provide: Annotated[
         list[format_id.FormatId] | None,
-        Field(description='Format IDs that creative assets will be provided for this package'),
+        Field(description="Format IDs that creative assets will be provided for this package"),
     ] = None
     impressions: Annotated[
-        float | None, Field(description='Impression goal for this package', ge=0.0)
+        float | None, Field(description="Impression goal for this package", ge=0.0)
     ] = None
     pacing: pacing_1.Pacing | None = None
     package_id: Annotated[str, Field(description="Publisher's unique identifier for the package")]
     paused: Annotated[
         bool | None,
         Field(
-            description='Whether this package is paused by the buyer. Paused packages do not deliver impressions. Defaults to false.'
+            description="Whether this package is paused by the buyer. Paused packages do not deliver impressions. Defaults to false."
         ),
     ] = False
     pricing_option_id: Annotated[
@@ -63,6 +63,6 @@ class Package(AdCPBaseModel):
         ),
     ] = None
     product_id: Annotated[
-        str | None, Field(description='ID of the product this package is based on')
+        str | None, Field(description="ID of the product this package is based on")
     ] = None
     targeting_overlay: targeting.TargetingOverlay | None = None

adcp/types/generated_poc/core/performance_feedback.py

@@ -16,63 +16,63 @@ from ..enums import metric_type as metric_type_1
 
 class MeasurementPeriod(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     end: Annotated[
-        AwareDatetime, Field(description='ISO 8601 end timestamp for measurement period')
+        AwareDatetime, Field(description="ISO 8601 end timestamp for measurement period")
     ]
     start: Annotated[
-        AwareDatetime, Field(description='ISO 8601 start timestamp for measurement period')
+        AwareDatetime, Field(description="ISO 8601 start timestamp for measurement period")
     ]
 
 
 class Status(Enum):
-    accepted = 'accepted'
-    queued = 'queued'
-    applied = 'applied'
-    rejected = 'rejected'
+    accepted = "accepted"
+    queued = "queued"
+    applied = "applied"
+    rejected = "rejected"
 
 
 class PerformanceFeedback(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     applied_at: Annotated[
         AwareDatetime | None,
         Field(
-            description='ISO 8601 timestamp when feedback was applied to optimization algorithms'
+            description="ISO 8601 timestamp when feedback was applied to optimization algorithms"
         ),
     ] = None
     creative_id: Annotated[
-        str | None, Field(description='Specific creative asset (if feedback is creative-specific)')
+        str | None, Field(description="Specific creative asset (if feedback is creative-specific)")
     ] = None
     feedback_id: Annotated[
-        str, Field(description='Unique identifier for this performance feedback submission')
+        str, Field(description="Unique identifier for this performance feedback submission")
     ]
     feedback_source: Annotated[
-        feedback_source_1.FeedbackSource, Field(description='Source of the performance data')
+        feedback_source_1.FeedbackSource, Field(description="Source of the performance data")
     ]
     measurement_period: Annotated[
-        MeasurementPeriod, Field(description='Time period for performance measurement')
+        MeasurementPeriod, Field(description="Time period for performance measurement")
     ]
     media_buy_id: Annotated[str, Field(description="Publisher's media buy identifier")]
     metric_type: Annotated[
-        metric_type_1.MetricType, Field(description='The business metric being measured')
+        metric_type_1.MetricType, Field(description="The business metric being measured")
     ]
     package_id: Annotated[
         str | None,
         Field(
-            description='Specific package within the media buy (if feedback is package-specific)'
+            description="Specific package within the media buy (if feedback is package-specific)"
         ),
     ] = None
     performance_index: Annotated[
         float,
         Field(
-            description='Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)',
+            description="Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)",
             ge=0.0,
         ),
     ]
-    status: Annotated[Status, Field(description='Processing status of the performance feedback')]
+    status: Annotated[Status, Field(description="Processing status of the performance feedback")]
     submitted_at: Annotated[
-        AwareDatetime, Field(description='ISO 8601 timestamp when feedback was submitted')
+        AwareDatetime, Field(description="ISO 8601 timestamp when feedback was submitted")
     ]

adcp/types/generated_poc/core/placement.py

@@ -14,15 +14,15 @@ from . import format_id
 
 class Placement(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     description: Annotated[
-        str | None, Field(description='Detailed description of where and how the placement appears')
+        str | None, Field(description="Detailed description of where and how the placement appears")
     ] = None
     format_ids: Annotated[
         list[format_id.FormatId] | None,
         Field(
-            description='Format IDs supported by this specific placement. Can include: (1) concrete format_ids (fixed dimensions), (2) template format_ids without parameters (accepts any dimensions/duration), or (3) parameterized format_ids (specific dimension/duration constraints).',
+            description="Format IDs supported by this specific placement. Can include: (1) concrete format_ids (fixed dimensions), (2) template format_ids without parameters (accepts any dimensions/duration), or (3) parameterized format_ids (specific dimension/duration constraints).",
             min_length=1,
         ),
     ] = None
@@ -33,5 +33,5 @@ class Placement(AdCPBaseModel):
         ),
     ]
     placement_id: Annotated[
-        str, Field(description='Unique identifier for the placement within the product')
+        str, Field(description="Unique identifier for the placement within the product")
     ]

adcp/types/generated_poc/core/pricing_option.py

@@ -45,7 +45,7 @@ class PricingOption(
         | cpp_option.CppPricingOption
         | flat_rate_option.FlatRatePricingOption,
         Field(
-            description='A pricing model option offered by a publisher for a product. Each pricing model has its own schema with model-specific requirements.',
-            title='Pricing Option',
+            description="A pricing model option offered by a publisher for a product. Each pricing model has its own schema with model-specific requirements.",
+            title="Pricing Option",
         ),
     ]

adcp/types/generated_poc/core/product.py

@@ -35,100 +35,100 @@ class DeliveryMeasurement(AdCPBaseModel):
 
 class ProductCard(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     format_id: Annotated[
         format_id_1.FormatId,
         Field(
-            description='Creative format defining the card layout (typically product_card_standard)'
+            description="Creative format defining the card layout (typically product_card_standard)"
         ),
     ]
     manifest: Annotated[
         dict[str, Any],
-        Field(description='Asset manifest for rendering the card, structure defined by the format'),
+        Field(description="Asset manifest for rendering the card, structure defined by the format"),
     ]
 
 
 class ProductCardDetailed(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     format_id: Annotated[
         format_id_1.FormatId,
         Field(
-            description='Creative format defining the detailed card layout (typically product_card_detailed)'
+            description="Creative format defining the detailed card layout (typically product_card_detailed)"
         ),
     ]
     manifest: Annotated[
         dict[str, Any],
         Field(
-            description='Asset manifest for rendering the detailed card, structure defined by the format'
+            description="Asset manifest for rendering the detailed card, structure defined by the format"
         ),
     ]
 
 
 class Product(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     brief_relevance: Annotated[
         str | None,
         Field(
-            description='Explanation of why this product matches the brief (only included when brief is provided)'
+            description="Explanation of why this product matches the brief (only included when brief is provided)"
         ),
     ] = None
     creative_policy: creative_policy_1.CreativePolicy | None = None
     delivery_measurement: Annotated[
         DeliveryMeasurement,
         Field(
-            description='Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. REQUIRED for all products.'
+            description="Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. REQUIRED for all products."
         ),
     ]
     delivery_type: delivery_type_1.DeliveryType
     description: Annotated[
-        str, Field(description='Detailed description of the product and its inventory')
+        str, Field(description="Detailed description of the product and its inventory")
     ]
     estimated_exposures: Annotated[
         int | None,
-        Field(description='Estimated exposures/impressions for guaranteed products', ge=0),
+        Field(description="Estimated exposures/impressions for guaranteed products", ge=0),
     ] = None
     expires_at: Annotated[
-        AwareDatetime | None, Field(description='Expiration timestamp for custom products')
+        AwareDatetime | None, Field(description="Expiration timestamp for custom products")
     ] = None
     ext: ext_1.ExtensionObject | None = None
     format_ids: Annotated[
         list[format_id_1.FormatId],
         Field(
-            description='Array of supported creative format IDs - structured format_id objects with agent_url and id'
+            description="Array of supported creative format IDs - structured format_id objects with agent_url and id"
         ),
     ]
-    is_custom: Annotated[bool | None, Field(description='Whether this is a custom product')] = None
+    is_custom: Annotated[bool | None, Field(description="Whether this is a custom product")] = None
     measurement: measurement_1.Measurement | None = None
-    name: Annotated[str, Field(description='Human-readable product name')]
+    name: Annotated[str, Field(description="Human-readable product name")]
     placements: Annotated[
         list[placement.Placement] | None,
         Field(
-            description='Optional array of specific placements within this product. When provided, buyers can target specific placements when assigning creatives.',
+            description="Optional array of specific placements within this product. When provided, buyers can target specific placements when assigning creatives.",
             min_length=1,
         ),
     ] = None
     pricing_options: Annotated[
         list[pricing_option.PricingOption],
-        Field(description='Available pricing models for this product', min_length=1),
+        Field(description="Available pricing models for this product", min_length=1),
     ]
     product_card: Annotated[
         ProductCard | None,
         Field(
-            description='Optional standard visual card (300x400px) for displaying this product in user interfaces. Can be rendered via preview_creative or pre-generated.'
+            description="Optional standard visual card (300x400px) for displaying this product in user interfaces. Can be rendered via preview_creative or pre-generated."
         ),
     ] = None
     product_card_detailed: Annotated[
         ProductCardDetailed | None,
         Field(
-            description='Optional detailed card with carousel and full specifications. Provides rich product presentation similar to media kit pages.'
+            description="Optional detailed card with carousel and full specifications. Provides rich product presentation similar to media kit pages."
         ),
     ] = None
-    product_id: Annotated[str, Field(description='Unique identifier for the product')]
+    product_id: Annotated[str, Field(description="Unique identifier for the product")]
     publisher_properties: Annotated[
         list[publisher_property_selector.PublisherPropertySelector],
         Field(

adcp/types/generated_poc/core/product_filters.py

@@ -18,43 +18,43 @@ from . import format_id
 
 class BudgetRange(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     currency: Annotated[
         str,
         Field(
-            description="ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP')", pattern='^[A-Z]{3}$'
+            description="ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP')", pattern="^[A-Z]{3}$"
         ),
     ]
-    max: Annotated[float | None, Field(description='Maximum budget amount', ge=0.0)] = None
-    min: Annotated[float, Field(description='Minimum budget amount', ge=0.0)]
+    max: Annotated[float | None, Field(description="Maximum budget amount", ge=0.0)] = None
+    min: Annotated[float, Field(description="Minimum budget amount", ge=0.0)]
 
 
 class BudgetRange1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     currency: Annotated[
         str,
         Field(
-            description="ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP')", pattern='^[A-Z]{3}$'
+            description="ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP')", pattern="^[A-Z]{3}$"
         ),
     ]
-    max: Annotated[float, Field(description='Maximum budget amount', ge=0.0)]
-    min: Annotated[float | None, Field(description='Minimum budget amount', ge=0.0)] = None
+    max: Annotated[float, Field(description="Maximum budget amount", ge=0.0)]
+    min: Annotated[float | None, Field(description="Minimum budget amount", ge=0.0)] = None
 
 
 class Country(RootModel[str]):
-    root: Annotated[str, Field(pattern='^[A-Z]{2}$')]
+    root: Annotated[str, Field(pattern="^[A-Z]{2}$")]
 
 
 class ProductFilters(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     budget_range: Annotated[
         BudgetRange | BudgetRange1 | None,
-        Field(description='Budget range to filter appropriate products'),
+        Field(description="Budget range to filter appropriate products"),
     ] = None
     channels: Annotated[
         list[channels_1.AdvertisingChannels] | None,
@@ -70,28 +70,28 @@ class ProductFilters(AdCPBaseModel):
     end_date: Annotated[
         date | None,
         Field(
-            description='Campaign end date (ISO 8601 date format: YYYY-MM-DD) for availability checks'
+            description="Campaign end date (ISO 8601 date format: YYYY-MM-DD) for availability checks"
         ),
     ] = None
     format_ids: Annotated[
-        list[format_id.FormatId] | None, Field(description='Filter by specific format IDs')
+        list[format_id.FormatId] | None, Field(description="Filter by specific format IDs")
     ] = None
     format_types: Annotated[
-        list[format_category.FormatCategory] | None, Field(description='Filter by format types')
+        list[format_category.FormatCategory] | None, Field(description="Filter by format types")
     ] = None
     is_fixed_price: Annotated[
-        bool | None, Field(description='Filter for fixed price vs auction products')
+        bool | None, Field(description="Filter for fixed price vs auction products")
     ] = None
     min_exposures: Annotated[
         int | None,
-        Field(description='Minimum exposures/impressions needed for measurement validity', ge=1),
+        Field(description="Minimum exposures/impressions needed for measurement validity", ge=1),
     ] = None
     standard_formats_only: Annotated[
-        bool | None, Field(description='Only return products accepting IAB standard formats')
+        bool | None, Field(description="Only return products accepting IAB standard formats")
     ] = None
     start_date: Annotated[
         date | None,
         Field(
-            description='Campaign start date (ISO 8601 date format: YYYY-MM-DD) for availability checks'
+            description="Campaign start date (ISO 8601 date format: YYYY-MM-DD) for availability checks"
         ),
     ] = None

adcp/types/generated_poc/core/promoted_offerings.py

@@ -14,28 +14,28 @@ from . import brand_manifest_ref, promoted_products
 
 
 class AssetType(Enum):
-    image = 'image'
-    video = 'video'
-    audio = 'audio'
-    vast = 'vast'
-    daast = 'daast'
-    text = 'text'
-    url = 'url'
-    html = 'html'
-    css = 'css'
-    javascript = 'javascript'
-    webhook = 'webhook'
+    image = "image"
+    video = "video"
+    audio = "audio"
+    vast = "vast"
+    daast = "daast"
+    text = "text"
+    url = "url"
+    html = "html"
+    css = "css"
+    javascript = "javascript"
+    webhook = "webhook"
 
 
 class AssetSelectors(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     asset_types: Annotated[
         list[AssetType] | None, Field(description="Filter by asset type (e.g., ['image', 'video'])")
     ] = None
     exclude_tags: Annotated[
-        list[str] | None, Field(description='Exclude assets with these tags')
+        list[str] | None, Field(description="Exclude assets with these tags")
     ] = None
     tags: Annotated[
         list[str] | None,
@@ -45,10 +45,10 @@ class AssetSelectors(AdCPBaseModel):
 
 class Offering(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     assets: Annotated[
-        list[dict[str, Any]] | None, Field(description='Assets specific to this offering')
+        list[dict[str, Any]] | None, Field(description="Assets specific to this offering")
     ] = None
     description: Annotated[str | None, Field(description="Description of what's being offered")] = (
         None
@@ -60,27 +60,27 @@ class Offering(AdCPBaseModel):
 
 class PromotedOfferings(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     asset_selectors: Annotated[
         AssetSelectors | None,
-        Field(description='Selectors to choose specific assets from the brand manifest'),
+        Field(description="Selectors to choose specific assets from the brand manifest"),
     ] = None
     brand_manifest: Annotated[
         brand_manifest_ref.BrandManifestReference,
         Field(
-            description='Brand information manifest containing assets, themes, and guidelines. Can be provided inline or as a URL reference to a hosted manifest.'
+            description="Brand information manifest containing assets, themes, and guidelines. Can be provided inline or as a URL reference to a hosted manifest."
         ),
     ]
     offerings: Annotated[
         list[Offering] | None,
         Field(
-            description='Inline offerings for campaigns without a product catalog. Each offering has a name, description, and associated assets.'
+            description="Inline offerings for campaigns without a product catalog. Each offering has a name, description, and associated assets."
         ),
     ] = None
     product_selectors: Annotated[
         promoted_products.PromotedProducts | None,
         Field(
-            description='Selectors to choose which products/offerings from the brand manifest product catalog to promote'
+            description="Selectors to choose which products/offerings from the brand manifest product catalog to promote"
         ),
     ] = None

adcp/types/generated_poc/core/promoted_products.py

@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class PromotedProducts(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     manifest_category: Annotated[
         str | None,
@@ -28,7 +28,7 @@ class PromotedProducts(AdCPBaseModel):
     ] = None
     manifest_skus: Annotated[
         list[str] | None,
-        Field(description='Direct product SKU references from the brand manifest product catalog'),
+        Field(description="Direct product SKU references from the brand manifest product catalog"),
     ] = None
     manifest_tags: Annotated[
         list[str] | None,

adcp/types/generated_poc/core/property.py

@@ -17,11 +17,11 @@ from . import property_tag
 
 class Identifier(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     type: Annotated[
         identifier_types.PropertyIdentifierTypes,
-        Field(description='Type of identifier for this property'),
+        Field(description="Type of identifier for this property"),
     ]
     value: Annotated[
         str,
@@ -33,30 +33,30 @@ class Identifier(AdCPBaseModel):
 
 class Property(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     identifiers: Annotated[
-        list[Identifier], Field(description='Array of identifiers for this property', min_length=1)
+        list[Identifier], Field(description="Array of identifiers for this property", min_length=1)
     ]
-    name: Annotated[str, Field(description='Human-readable property name')]
+    name: Annotated[str, Field(description="Human-readable property name")]
     property_id: Annotated[
         property_id_1.PropertyId | None,
         Field(
-            description='Unique identifier for this property (optional). Enables referencing properties by ID instead of repeating full objects.'
+            description="Unique identifier for this property (optional). Enables referencing properties by ID instead of repeating full objects."
         ),
     ] = None
     property_type: Annotated[
-        property_type_1.PropertyType, Field(description='Type of advertising property')
+        property_type_1.PropertyType, Field(description="Type of advertising property")
     ]
     publisher_domain: Annotated[
         str | None,
         Field(
-            description='Domain where adagents.json should be checked for authorization validation. Required for list_authorized_properties response. Optional in adagents.json (file location implies domain).'
+            description="Domain where adagents.json should be checked for authorization validation. Required for list_authorized_properties response. Optional in adagents.json (file location implies domain)."
         ),
     ] = None
     tags: Annotated[
         list[property_tag.PropertyTag] | None,
         Field(
-            description='Tags for categorization and grouping (e.g., network membership, content categories)'
+            description="Tags for categorization and grouping (e.g., network membership, content categories)"
         ),
     ] = None

adcp/types/generated_poc/core/property_id.py

@@ -13,9 +13,9 @@ class PropertyId(RootModel[str]):
     root: Annotated[
         str,
         Field(
-            description='Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.',
-            examples=['cnn_ctv_app', 'homepage', 'mobile_ios', 'instagram'],
-            pattern='^[a-z0-9_]+$',
-            title='Property ID',
+            description="Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.",
+            examples=["cnn_ctv_app", "homepage", "mobile_ios", "instagram"],
+            pattern="^[a-z0-9_]+$",
+            title="Property ID",
         ),
     ]

adcp/types/generated_poc/core/property_list_ref.py

@@ -0,0 +1,26 @@
+# generated by datamodel-codegen:
+#   filename:  core/property_list_ref.json
+#   timestamp: 2026-01-14T17:08:13+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
+
+
+class PropertyListReference(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    agent_url: Annotated[AnyUrl, Field(description="URL of the agent managing the property list")]
+    auth_token: Annotated[
+        str | None,
+        Field(
+            description="JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."
+        ),
+    ] = None
+    list_id: Annotated[
+        str, Field(description="Identifier for the property list within the agent", min_length=1)
+    ]

adcp/types/generated_poc/core/property_tag.py

@@ -13,9 +13,9 @@ class PropertyTag(RootModel[str]):
     root: Annotated[
         str,
         Field(
-            description='Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.',
-            examples=['ctv', 'premium', 'news', 'sports', 'meta_network', 'social_media'],
-            pattern='^[a-z0-9_]+$',
-            title='Property Tag',
+            description="Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.",
+            examples=["ctv", "premium", "news", "sports", "meta_network", "social_media"],
+            pattern="^[a-z0-9_]+$",
+            title="Property Tag",
         ),
     ]