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

adcp/types/generated_poc/media_buy/package_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/package_request.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-14T17:08:13+00:00
 
 from __future__ import annotations
 
@@ -17,12 +17,12 @@ from ..enums import pacing as pacing_1
 
 class PackageRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     bid_price: Annotated[
         float | None,
         Field(
-            description='Bid price for auction-based CPM pricing (required if using cpm-auction-option)',
+            description="Bid price for auction-based CPM pricing (required if using cpm-auction-option)",
             ge=0.0,
         ),
     ] = None
@@ -34,13 +34,13 @@ class PackageRequest(AdCPBaseModel):
     creative_ids: Annotated[
         list[str] | None,
         Field(
-            description='Creative IDs to assign to this package at creation time (references existing library creatives)'
+            description="Creative IDs to assign to this package at creation time (references existing library creatives)"
         ),
     ] = None
     creatives: Annotated[
         list[creative_asset.CreativeAsset] | None,
         Field(
-            description='Full creative objects to upload and assign to this package at creation time (alternative to creative_ids - creatives will be added to library). Supports both static and generative creatives.',
+            description="Full creative objects to upload and assign to this package at creation time (alternative to creative_ids - creatives will be added to library). Supports both static and generative creatives.",
             max_length=100,
         ),
     ] = None
@@ -48,16 +48,25 @@ class PackageRequest(AdCPBaseModel):
     format_ids: Annotated[
         list[format_id.FormatId] | None,
         Field(
-            description='Array of format IDs that will be used for this package - must be supported by the product. If omitted, defaults to all formats supported by the product.',
+            description="Array of format IDs that will be used for this package - must be supported by the product. If omitted, defaults to all formats supported by the product.",
             min_length=1,
         ),
     ] = None
+    impressions: Annotated[
+        float | None, Field(description="Impression goal for this package", ge=0.0)
+    ] = None
     pacing: pacing_1.Pacing | None = None
+    paused: Annotated[
+        bool | None,
+        Field(
+            description="Whether this package should be created in a paused state. Paused packages do not deliver impressions. Defaults to false."
+        ),
+    ] = False
     pricing_option_id: Annotated[
         str,
         Field(
             description="ID of the selected pricing option from the product's pricing_options array"
         ),
     ]
-    product_id: Annotated[str, Field(description='Product ID for this package')]
+    product_id: Annotated[str, Field(description="Product ID for this package")]
     targeting_overlay: targeting.TargetingOverlay | None = None

adcp/types/generated_poc/media_buy/provide_performance_feedback_request.py

@@ -17,19 +17,19 @@ 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 ProvidePerformanceFeedbackRequest1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     buyer_ref: Annotated[
         str | None, Field(description="Buyer's reference for the media buy", min_length=1)
@@ -38,33 +38,33 @@ class ProvidePerformanceFeedbackRequest1(AdCPBaseModel):
     creative_id: Annotated[
         str | None,
         Field(
-            description='Specific creative asset (if feedback is creative-specific)', min_length=1
+            description="Specific creative asset (if feedback is creative-specific)", min_length=1
         ),
     ] = None
     ext: ext_1.ExtensionObject | None = None
     feedback_source: Annotated[
-        feedback_source_1.FeedbackSource | None, Field(description='Source of the performance data')
+        feedback_source_1.FeedbackSource | None, Field(description="Source of the performance data")
     ] = feedback_source_1.FeedbackSource.buyer_attribution
     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", min_length=1)
     ]
     metric_type: Annotated[
-        metric_type_1.MetricType | None, Field(description='The business metric being measured')
+        metric_type_1.MetricType | None, Field(description="The business metric being measured")
     ] = metric_type_1.MetricType.overall_performance
     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)",
             min_length=1,
         ),
     ] = 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,
         ),
     ]
@@ -72,7 +72,7 @@ class ProvidePerformanceFeedbackRequest1(AdCPBaseModel):
 
 class ProvidePerformanceFeedbackRequest2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     buyer_ref: Annotated[
         str, Field(description="Buyer's reference for the media buy", min_length=1)
@@ -81,33 +81,33 @@ class ProvidePerformanceFeedbackRequest2(AdCPBaseModel):
     creative_id: Annotated[
         str | None,
         Field(
-            description='Specific creative asset (if feedback is creative-specific)', min_length=1
+            description="Specific creative asset (if feedback is creative-specific)", min_length=1
         ),
     ] = None
     ext: ext_1.ExtensionObject | None = None
     feedback_source: Annotated[
-        feedback_source_1.FeedbackSource | None, Field(description='Source of the performance data')
+        feedback_source_1.FeedbackSource | None, Field(description="Source of the performance data")
     ] = feedback_source_1.FeedbackSource.buyer_attribution
     measurement_period: Annotated[
-        MeasurementPeriod, Field(description='Time period for performance measurement')
+        MeasurementPeriod, Field(description="Time period for performance measurement")
     ]
     media_buy_id: Annotated[
         str | None, Field(description="Publisher's media buy identifier", min_length=1)
     ] = None
     metric_type: Annotated[
-        metric_type_1.MetricType | None, Field(description='The business metric being measured')
+        metric_type_1.MetricType | None, Field(description="The business metric being measured")
     ] = metric_type_1.MetricType.overall_performance
     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)",
             min_length=1,
         ),
     ] = 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,
         ),
     ]
@@ -119,7 +119,7 @@ class ProvidePerformanceFeedbackRequest(
     root: Annotated[
         ProvidePerformanceFeedbackRequest1 | ProvidePerformanceFeedbackRequest2,
         Field(
-            description='Request payload for provide_performance_feedback task',
-            title='Provide Performance Feedback Request',
+            description="Request payload for provide_performance_feedback task",
+            title="Provide Performance Feedback Request",
         ),
     ]

adcp/types/generated_poc/media_buy/provide_performance_feedback_response.py

@@ -16,25 +16,25 @@ from ..core import ext as ext_1
 
 class ProvidePerformanceFeedbackResponse1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None
     success: Annotated[
         Literal[True],
-        Field(description='Whether the performance feedback was successfully received'),
+        Field(description="Whether the performance feedback was successfully received"),
     ]
 
 
 class ProvidePerformanceFeedbackResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error],
         Field(
-            description='Array of errors explaining why feedback was rejected (e.g., invalid measurement period, missing campaign data)',
+            description="Array of errors explaining why feedback was rejected (e.g., invalid measurement period, missing campaign data)",
             min_length=1,
         ),
     ]
@@ -47,7 +47,7 @@ class ProvidePerformanceFeedbackResponse(
     root: Annotated[
         ProvidePerformanceFeedbackResponse1 | ProvidePerformanceFeedbackResponse2,
         Field(
-            description='Response payload for provide_performance_feedback task. Returns either success confirmation OR error information, never both.',
-            title='Provide Performance Feedback Response',
+            description="Response payload for provide_performance_feedback task. Returns either success confirmation OR error information, never both.",
+            title="Provide Performance Feedback Response",
         ),
     ]

adcp/types/generated_poc/media_buy/sync_creatives_async_response_input_required.py

@@ -15,17 +15,17 @@ from ..core import ext as ext_1
 
 
 class Reason(Enum):
-    APPROVAL_REQUIRED = 'APPROVAL_REQUIRED'
-    ASSET_CONFIRMATION = 'ASSET_CONFIRMATION'
-    FORMAT_CLARIFICATION = 'FORMAT_CLARIFICATION'
+    APPROVAL_REQUIRED = "APPROVAL_REQUIRED"
+    ASSET_CONFIRMATION = "ASSET_CONFIRMATION"
+    FORMAT_CLARIFICATION = "FORMAT_CLARIFICATION"
 
 
 class SyncCreativesInputRequired(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None
     reason: Annotated[
-        Reason | None, Field(description='Reason code indicating why buyer input is needed')
+        Reason | None, Field(description="Reason code indicating why buyer input is needed")
     ] = None

adcp/types/generated_poc/media_buy/sync_creatives_async_response_submitted.py

@@ -13,7 +13,7 @@ from ..core import ext as ext_1
 
 class SyncCreativesSubmitted(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None

adcp/types/generated_poc/media_buy/sync_creatives_async_response_working.py

@@ -15,23 +15,23 @@ from ..core import ext as ext_1
 
 class SyncCreativesWorking(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     creatives_processed: Annotated[
-        int | None, Field(description='Number of creatives processed so far', ge=0)
+        int | None, Field(description="Number of creatives processed so far", ge=0)
     ] = None
     creatives_total: Annotated[
-        int | None, Field(description='Total number of creatives to process', ge=0)
+        int | None, Field(description="Total number of creatives to process", ge=0)
     ] = None
     current_step: Annotated[
-        str | None, Field(description='Current step or phase of the operation')
+        str | None, Field(description="Current step or phase of the operation")
     ] = None
     ext: ext_1.ExtensionObject | None = None
     percentage: Annotated[
-        float | None, Field(description='Completion percentage (0-100)', ge=0.0, le=100.0)
+        float | None, Field(description="Completion percentage (0-100)", ge=0.0, le=100.0)
     ] = None
-    step_number: Annotated[int | None, Field(description='Current step number', ge=1)] = None
+    step_number: Annotated[int | None, Field(description="Current step number", ge=1)] = None
     total_steps: Annotated[
-        int | None, Field(description='Total number of steps in the operation', ge=1)
+        int | None, Field(description="Total number of steps in the operation", ge=1)
     ] = None

adcp/types/generated_poc/media_buy/sync_creatives_request.py

@@ -18,41 +18,41 @@ from ..enums import validation_mode as validation_mode_1
 
 class SyncCreativesRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     assignments: Annotated[
         dict[str, list[str]] | None,
-        Field(description='Optional bulk assignment of creatives to packages'),
+        Field(description="Optional bulk assignment of creatives to packages"),
     ] = None
     context: context_1.ContextObject | None = None
     creative_ids: Annotated[
         list[str] | None,
         Field(
-            description='Optional filter to limit sync scope to specific creative IDs. When provided, only these creatives will be created/updated. Other creatives in the library are unaffected. Useful for partial updates and error recovery.',
+            description="Optional filter to limit sync scope to specific creative IDs. When provided, only these creatives will be created/updated. Other creatives in the library are unaffected. Useful for partial updates and error recovery.",
             max_length=100,
         ),
     ] = None
     creatives: Annotated[
         list[creative_asset.CreativeAsset],
-        Field(description='Array of creative assets to sync (create or update)', max_length=100),
+        Field(description="Array of creative assets to sync (create or update)", max_length=100),
     ]
     delete_missing: Annotated[
         bool | None,
         Field(
-            description='When true, creatives not included in this sync will be archived. Use with caution for full library replacement.'
+            description="When true, creatives not included in this sync will be archived. Use with caution for full library replacement."
         ),
     ] = False
     dry_run: Annotated[
         bool | None,
         Field(
-            description='When true, preview changes without applying them. Returns what would be created/updated/deleted.'
+            description="When true, preview changes without applying them. Returns what would be created/updated/deleted."
         ),
     ] = False
     ext: ext_1.ExtensionObject | None = None
     push_notification_config: Annotated[
         push_notification_config_1.PushNotificationConfig | None,
         Field(
-            description='Optional webhook configuration for async sync notifications. Publisher will send webhook when sync completes if operation takes longer than immediate response time (typically for large bulk operations or manual approval/HITL).'
+            description="Optional webhook configuration for async sync notifications. Publisher will send webhook when sync completes if operation takes longer than immediate response time (typically for large bulk operations or manual approval/HITL)."
         ),
     ] = None
     validation_mode: Annotated[

adcp/types/generated_poc/media_buy/sync_creatives_response.py

@@ -17,28 +17,28 @@ from ..enums import creative_action
 
 class Creative(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     action: Annotated[
-        creative_action.CreativeAction, Field(description='Action taken for this creative')
+        creative_action.CreativeAction, Field(description="Action taken for this creative")
     ]
     assigned_to: Annotated[
         list[str] | None,
         Field(
-            description='Package IDs this creative was successfully assigned to (only present when assignments were requested)'
+            description="Package IDs this creative was successfully assigned to (only present when assignments were requested)"
         ),
     ] = None
     assignment_errors: Annotated[
         dict[str, str] | None,
         Field(
-            description='Assignment errors by package ID (only present when assignment failures occurred)'
+            description="Assignment errors by package ID (only present when assignment failures occurred)"
         ),
     ] = None
     changes: Annotated[
         list[str] | None,
         Field(description="Field names that were modified (only present when action='updated')"),
     ] = None
-    creative_id: Annotated[str, Field(description='Creative ID from the request')]
+    creative_id: Annotated[str, Field(description="Creative ID from the request")]
     errors: Annotated[
         list[str] | None,
         Field(description="Validation or processing errors (only present when action='failed')"),
@@ -46,26 +46,26 @@ class Creative(AdCPBaseModel):
     expires_at: Annotated[
         AwareDatetime | None,
         Field(
-            description='ISO 8601 timestamp when preview link expires (only present when preview_url exists)'
+            description="ISO 8601 timestamp when preview link expires (only present when preview_url exists)"
         ),
     ] = None
     platform_id: Annotated[
-        str | None, Field(description='Platform-specific ID assigned to the creative')
+        str | None, Field(description="Platform-specific ID assigned to the creative")
     ] = None
     preview_url: Annotated[
         AnyUrl | None,
         Field(
-            description='Preview URL for generative creatives (only present for generative formats)'
+            description="Preview URL for generative creatives (only present for generative formats)"
         ),
     ] = None
     warnings: Annotated[
-        list[str] | None, Field(description='Non-fatal warnings about this creative')
+        list[str] | None, Field(description="Non-fatal warnings about this creative")
     ] = None
 
 
 class SyncCreativesResponse1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     creatives: Annotated[
@@ -75,20 +75,20 @@ class SyncCreativesResponse1(AdCPBaseModel):
         ),
     ]
     dry_run: Annotated[
-        bool | None, Field(description='Whether this was a dry run (no actual changes made)')
+        bool | None, Field(description="Whether this was a dry run (no actual changes made)")
     ] = None
     ext: ext_1.ExtensionObject | None = None
 
 
 class SyncCreativesResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error],
         Field(
-            description='Operation-level errors that prevented processing any creatives (e.g., authentication failure, service unavailable, invalid request format)',
+            description="Operation-level errors that prevented processing any creatives (e.g., authentication failure, service unavailable, invalid request format)",
             min_length=1,
         ),
     ]
@@ -99,7 +99,7 @@ class SyncCreativesResponse(RootModel[SyncCreativesResponse1 | SyncCreativesResp
     root: Annotated[
         SyncCreativesResponse1 | SyncCreativesResponse2,
         Field(
-            description='Response from creative sync operation. Returns either per-creative results (best-effort processing) OR operation-level errors (complete failure). This enforces atomic semantics at the operation level while allowing per-item failures within successful operations.',
-            title='Sync Creatives Response',
+            description="Response from creative sync operation. Returns either per-creative results (best-effort processing) OR operation-level errors (complete failure). This enforces atomic semantics at the operation level while allowing per-item failures within successful operations.",
+            title="Sync Creatives Response",
         ),
     ]

adcp/types/generated_poc/media_buy/update_media_buy_async_response_input_required.py

@@ -15,16 +15,16 @@ from ..core import ext as ext_1
 
 
 class Reason(Enum):
-    APPROVAL_REQUIRED = 'APPROVAL_REQUIRED'
-    CHANGE_CONFIRMATION = 'CHANGE_CONFIRMATION'
+    APPROVAL_REQUIRED = "APPROVAL_REQUIRED"
+    CHANGE_CONFIRMATION = "CHANGE_CONFIRMATION"
 
 
 class UpdateMediaBuyInputRequired(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None
     reason: Annotated[
-        Reason | None, Field(description='Reason code indicating why input is needed')
+        Reason | None, Field(description="Reason code indicating why input is needed")
     ] = None

adcp/types/generated_poc/media_buy/update_media_buy_async_response_submitted.py

@@ -13,7 +13,7 @@ from ..core import ext as ext_1
 
 class UpdateMediaBuySubmitted(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None

adcp/types/generated_poc/media_buy/update_media_buy_async_response_working.py

@@ -15,17 +15,17 @@ from ..core import ext as ext_1
 
 class UpdateMediaBuyWorking(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     current_step: Annotated[
-        str | None, Field(description='Current step or phase of the operation')
+        str | None, Field(description="Current step or phase of the operation")
     ] = None
     ext: ext_1.ExtensionObject | None = None
     percentage: Annotated[
-        float | None, Field(description='Completion percentage (0-100)', ge=0.0, le=100.0)
+        float | None, Field(description="Completion percentage (0-100)", ge=0.0, le=100.0)
     ] = None
-    step_number: Annotated[int | None, Field(description='Current step number', ge=1)] = None
+    step_number: Annotated[int | None, Field(description="Current step number", ge=1)] = None
     total_steps: Annotated[
-        int | None, Field(description='Total number of steps in the operation', ge=1)
+        int | None, Field(description="Total number of steps in the operation", ge=1)
     ] = None