adcp 3.1.0__py3-none-any.whl → 3.2.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (242) hide show
  1. adcp/ADCP_VERSION +1 -1
  2. adcp/__init__.py +5 -5
  3. adcp/__main__.py +4 -4
  4. adcp/adagents.py +5 -9
  5. adcp/client.py +14 -12
  6. adcp/protocols/a2a.py +3 -3
  7. adcp/protocols/base.py +2 -2
  8. adcp/protocols/mcp.py +3 -3
  9. adcp/server/base.py +6 -10
  10. adcp/server/content_standards.py +17 -49
  11. adcp/server/governance.py +20 -59
  12. adcp/server/mcp_tools.py +8 -4
  13. adcp/server/proposal.py +1 -3
  14. adcp/server/sponsored_intelligence.py +10 -28
  15. adcp/simple.py +10 -10
  16. adcp/types/__init__.py +10 -6
  17. adcp/types/_generated.py +44 -27
  18. adcp/types/base.py +7 -7
  19. adcp/types/generated_poc/{protocols → a2ui}/__init__.py +1 -1
  20. adcp/types/generated_poc/a2ui/component.py +24 -0
  21. adcp/types/generated_poc/a2ui/surface.py +33 -0
  22. adcp/types/generated_poc/account/__init__.py +3 -0
  23. adcp/types/generated_poc/account/list_accounts_request.py +30 -0
  24. adcp/types/generated_poc/account/list_accounts_response.py +30 -0
  25. adcp/types/generated_poc/adagents.py +192 -195
  26. adcp/types/generated_poc/content_standards/artifact.py +69 -69
  27. adcp/types/generated_poc/content_standards/artifact_webhook_payload.py +13 -13
  28. adcp/types/generated_poc/content_standards/calibrate_content_request.py +2 -2
  29. adcp/types/generated_poc/content_standards/calibrate_content_response.py +17 -17
  30. adcp/types/generated_poc/content_standards/content_standards.py +8 -8
  31. adcp/types/generated_poc/content_standards/create_content_standards_request.py +13 -13
  32. adcp/types/generated_poc/content_standards/create_content_standards_response.py +6 -6
  33. adcp/types/generated_poc/content_standards/get_content_standards_request.py +1 -1
  34. adcp/types/generated_poc/content_standards/get_content_standards_response.py +4 -4
  35. adcp/types/generated_poc/content_standards/get_media_buy_artifacts_request.py +14 -14
  36. adcp/types/generated_poc/content_standards/get_media_buy_artifacts_response.py +30 -30
  37. adcp/types/generated_poc/content_standards/list_content_standards_request.py +4 -4
  38. adcp/types/generated_poc/content_standards/list_content_standards_response.py +5 -5
  39. adcp/types/generated_poc/content_standards/update_content_standards_request.py +14 -14
  40. adcp/types/generated_poc/content_standards/update_content_standards_response.py +4 -4
  41. adcp/types/generated_poc/content_standards/validate_content_delivery_request.py +13 -13
  42. adcp/types/generated_poc/content_standards/validate_content_delivery_response.py +16 -16
  43. adcp/types/generated_poc/core/account.py +54 -0
  44. adcp/types/generated_poc/core/activation_key.py +8 -8
  45. adcp/types/generated_poc/core/assets/audio_asset.py +37 -8
  46. adcp/types/generated_poc/core/assets/css_asset.py +2 -2
  47. adcp/types/generated_poc/core/assets/daast_asset.py +18 -18
  48. adcp/types/generated_poc/core/assets/html_asset.py +2 -2
  49. adcp/types/generated_poc/core/assets/image_asset.py +6 -6
  50. adcp/types/generated_poc/core/assets/javascript_asset.py +3 -3
  51. adcp/types/generated_poc/core/assets/text_asset.py +2 -2
  52. adcp/types/generated_poc/core/assets/url_asset.py +3 -3
  53. adcp/types/generated_poc/core/assets/vast_asset.py +18 -18
  54. adcp/types/generated_poc/core/assets/video_asset.py +126 -10
  55. adcp/types/generated_poc/core/assets/webhook_asset.py +9 -9
  56. adcp/types/generated_poc/core/async_response_data.py +2 -2
  57. adcp/types/generated_poc/core/brand_manifest.py +66 -66
  58. adcp/types/generated_poc/core/brand_manifest_ref.py +9 -9
  59. adcp/types/generated_poc/core/context.py +1 -1
  60. adcp/types/generated_poc/core/creative_asset.py +12 -12
  61. adcp/types/generated_poc/core/creative_assignment.py +3 -3
  62. adcp/types/generated_poc/core/creative_filters.py +23 -17
  63. adcp/types/generated_poc/core/creative_manifest.py +4 -4
  64. adcp/types/generated_poc/core/creative_policy.py +4 -4
  65. adcp/types/generated_poc/core/delivery_metrics.py +32 -32
  66. adcp/types/generated_poc/core/deployment.py +20 -20
  67. adcp/types/generated_poc/core/destination.py +11 -11
  68. adcp/types/generated_poc/core/error.py +6 -6
  69. adcp/types/generated_poc/core/ext.py +1 -1
  70. adcp/types/generated_poc/core/format.py +49 -124
  71. adcp/types/generated_poc/core/format_id.py +5 -5
  72. adcp/types/generated_poc/core/frequency_cap.py +2 -2
  73. adcp/types/generated_poc/core/identifier.py +2 -2
  74. adcp/types/generated_poc/core/mcp_webhook_payload.py +10 -10
  75. adcp/types/generated_poc/core/measurement.py +8 -8
  76. adcp/types/generated_poc/core/media_buy.py +12 -8
  77. adcp/types/generated_poc/core/media_buy_features.py +3 -3
  78. adcp/types/generated_poc/core/offering.py +9 -9
  79. adcp/types/generated_poc/core/package.py +8 -8
  80. adcp/types/generated_poc/core/performance_feedback.py +18 -18
  81. adcp/types/generated_poc/core/placement.py +4 -4
  82. adcp/types/generated_poc/core/pricing_option.py +1 -1
  83. adcp/types/generated_poc/core/product.py +27 -21
  84. adcp/types/generated_poc/core/product_allocation.py +5 -5
  85. adcp/types/generated_poc/core/product_filters.py +27 -27
  86. adcp/types/generated_poc/core/promoted_offerings.py +18 -18
  87. adcp/types/generated_poc/core/promoted_products.py +2 -2
  88. adcp/types/generated_poc/core/property.py +10 -10
  89. adcp/types/generated_poc/core/property_id.py +4 -4
  90. adcp/types/generated_poc/core/property_list_ref.py +4 -4
  91. adcp/types/generated_poc/core/property_tag.py +4 -4
  92. adcp/types/generated_poc/core/proposal.py +13 -13
  93. adcp/types/generated_poc/core/protocol_envelope.py +8 -8
  94. adcp/types/generated_poc/core/publisher_property_selector.py +13 -13
  95. adcp/types/generated_poc/core/push_notification_config.py +5 -5
  96. adcp/types/generated_poc/core/reporting_capabilities.py +8 -8
  97. adcp/types/generated_poc/core/reporting_webhook.py +10 -10
  98. adcp/types/generated_poc/core/response.py +4 -4
  99. adcp/types/generated_poc/core/signal_filters.py +5 -5
  100. adcp/types/generated_poc/core/start_timing.py +3 -3
  101. adcp/types/generated_poc/core/sub_asset.py +14 -14
  102. adcp/types/generated_poc/core/targeting.py +17 -10
  103. adcp/types/generated_poc/creative/list_creative_formats_request.py +20 -20
  104. adcp/types/generated_poc/creative/list_creative_formats_response.py +5 -5
  105. adcp/types/generated_poc/creative/preview_creative_request.py +24 -24
  106. adcp/types/generated_poc/creative/preview_creative_response.py +28 -28
  107. adcp/types/generated_poc/creative/preview_render.py +25 -25
  108. adcp/types/generated_poc/enums/adcp_domain.py +4 -4
  109. adcp/types/generated_poc/enums/asset_content_type.py +13 -13
  110. adcp/types/generated_poc/enums/auth_scheme.py +2 -2
  111. adcp/types/generated_poc/enums/available_metric.py +9 -9
  112. adcp/types/generated_poc/enums/channels.py +19 -19
  113. adcp/types/generated_poc/enums/co_branding_requirement.py +3 -3
  114. adcp/types/generated_poc/enums/creative_action.py +5 -5
  115. adcp/types/generated_poc/enums/creative_agent_capability.py +4 -4
  116. adcp/types/generated_poc/enums/creative_sort_field.py +6 -6
  117. adcp/types/generated_poc/enums/creative_status.py +5 -5
  118. adcp/types/generated_poc/enums/daast_tracking_event.py +11 -11
  119. adcp/types/generated_poc/enums/daast_version.py +2 -2
  120. adcp/types/generated_poc/enums/delivery_type.py +2 -2
  121. adcp/types/generated_poc/enums/dimension_unit.py +4 -4
  122. adcp/types/generated_poc/enums/feed_format.py +3 -3
  123. adcp/types/generated_poc/enums/feedback_source.py +4 -4
  124. adcp/types/generated_poc/enums/format_category.py +7 -7
  125. adcp/types/generated_poc/enums/format_id_parameter.py +2 -2
  126. adcp/types/generated_poc/enums/frequency_cap_scope.py +3 -3
  127. adcp/types/generated_poc/enums/geo_level.py +4 -4
  128. adcp/types/generated_poc/enums/history_entry_type.py +2 -2
  129. adcp/types/generated_poc/enums/http_method.py +2 -2
  130. adcp/types/generated_poc/enums/identifier_types.py +19 -19
  131. adcp/types/generated_poc/enums/javascript_module_type.py +3 -3
  132. adcp/types/generated_poc/enums/landing_page_requirement.py +3 -3
  133. adcp/types/generated_poc/enums/markdown_flavor.py +2 -2
  134. adcp/types/generated_poc/enums/media_buy_status.py +4 -4
  135. adcp/types/generated_poc/enums/metric_type.py +8 -8
  136. adcp/types/generated_poc/enums/metro_system.py +5 -5
  137. adcp/types/generated_poc/enums/notification_type.py +4 -4
  138. adcp/types/generated_poc/enums/pacing.py +3 -3
  139. adcp/types/generated_poc/enums/postal_system.py +9 -9
  140. adcp/types/generated_poc/enums/preview_output_format.py +2 -2
  141. adcp/types/generated_poc/enums/pricing_model.py +7 -7
  142. adcp/types/generated_poc/enums/property_type.py +8 -8
  143. adcp/types/generated_poc/enums/publisher_identifier_types.py +5 -5
  144. adcp/types/generated_poc/enums/reporting_frequency.py +3 -3
  145. adcp/types/generated_poc/enums/signal_catalog_type.py +3 -3
  146. adcp/types/generated_poc/enums/sort_direction.py +2 -2
  147. adcp/types/generated_poc/enums/task_status.py +9 -9
  148. adcp/types/generated_poc/enums/task_type.py +11 -12
  149. adcp/types/generated_poc/enums/update_frequency.py +4 -4
  150. adcp/types/generated_poc/enums/url_asset_type.py +3 -3
  151. adcp/types/generated_poc/enums/validation_mode.py +2 -2
  152. adcp/types/generated_poc/enums/vast_tracking_event.py +16 -16
  153. adcp/types/generated_poc/enums/vast_version.py +5 -5
  154. adcp/types/generated_poc/enums/webhook_response_type.py +4 -4
  155. adcp/types/generated_poc/enums/webhook_security_method.py +3 -3
  156. adcp/types/generated_poc/extensions/extension_meta.py +14 -14
  157. adcp/types/generated_poc/media_buy/build_creative_request.py +4 -4
  158. adcp/types/generated_poc/media_buy/build_creative_response.py +6 -6
  159. adcp/types/generated_poc/media_buy/create_media_buy_async_response_input_required.py +5 -5
  160. adcp/types/generated_poc/media_buy/create_media_buy_async_response_submitted.py +1 -1
  161. adcp/types/generated_poc/media_buy/create_media_buy_async_response_working.py +5 -5
  162. adcp/types/generated_poc/media_buy/create_media_buy_request.py +27 -21
  163. adcp/types/generated_poc/media_buy/create_media_buy_response.py +15 -8
  164. adcp/types/generated_poc/media_buy/get_media_buy_delivery_request.py +8 -8
  165. adcp/types/generated_poc/media_buy/get_media_buy_delivery_response.py +51 -51
  166. adcp/types/generated_poc/media_buy/get_products_async_response_input_required.py +6 -6
  167. adcp/types/generated_poc/media_buy/get_products_async_response_submitted.py +2 -2
  168. adcp/types/generated_poc/media_buy/get_products_async_response_working.py +4 -4
  169. adcp/types/generated_poc/media_buy/get_products_request.py +11 -5
  170. adcp/types/generated_poc/media_buy/get_products_response.py +5 -5
  171. adcp/types/generated_poc/media_buy/list_creative_formats_request.py +9 -9
  172. adcp/types/generated_poc/media_buy/list_creative_formats_response.py +5 -5
  173. adcp/types/generated_poc/media_buy/list_creatives_request.py +23 -23
  174. adcp/types/generated_poc/media_buy/list_creatives_response.py +53 -49
  175. adcp/types/generated_poc/media_buy/package_request.py +8 -8
  176. adcp/types/generated_poc/media_buy/package_update.py +16 -16
  177. adcp/types/generated_poc/media_buy/provide_performance_feedback_request.py +19 -19
  178. adcp/types/generated_poc/media_buy/provide_performance_feedback_response.py +6 -6
  179. adcp/types/generated_poc/media_buy/sync_creatives_async_response_input_required.py +5 -5
  180. adcp/types/generated_poc/media_buy/sync_creatives_async_response_submitted.py +1 -1
  181. adcp/types/generated_poc/media_buy/sync_creatives_async_response_working.py +7 -7
  182. adcp/types/generated_poc/media_buy/sync_creatives_request.py +14 -8
  183. adcp/types/generated_poc/media_buy/sync_creatives_response.py +33 -29
  184. adcp/types/generated_poc/media_buy/update_media_buy_async_response_input_required.py +4 -4
  185. adcp/types/generated_poc/media_buy/update_media_buy_async_response_submitted.py +1 -1
  186. adcp/types/generated_poc/media_buy/update_media_buy_async_response_working.py +5 -5
  187. adcp/types/generated_poc/media_buy/update_media_buy_request.py +14 -14
  188. adcp/types/generated_poc/media_buy/update_media_buy_response.py +7 -7
  189. adcp/types/generated_poc/pricing_options/cpc_option.py +13 -26
  190. adcp/types/generated_poc/pricing_options/cpcv_option.py +13 -26
  191. adcp/types/generated_poc/pricing_options/cpm_option.py +13 -20
  192. adcp/types/generated_poc/pricing_options/cpp_option.py +19 -32
  193. adcp/types/generated_poc/pricing_options/cpv_option.py +19 -32
  194. adcp/types/generated_poc/pricing_options/flat_rate_option.py +23 -36
  195. adcp/types/generated_poc/pricing_options/price_guidance.py +26 -0
  196. adcp/types/generated_poc/pricing_options/vcpm_option.py +13 -26
  197. adcp/types/generated_poc/property/base_property_source.py +15 -15
  198. adcp/types/generated_poc/property/create_property_list_request.py +4 -4
  199. adcp/types/generated_poc/property/create_property_list_response.py +3 -3
  200. adcp/types/generated_poc/property/delete_property_list_request.py +2 -2
  201. adcp/types/generated_poc/property/delete_property_list_response.py +3 -3
  202. adcp/types/generated_poc/property/feature_requirement.py +8 -8
  203. adcp/types/generated_poc/property/get_property_list_request.py +5 -5
  204. adcp/types/generated_poc/property/get_property_list_response.py +11 -11
  205. adcp/types/generated_poc/property/list_property_lists_request.py +5 -5
  206. adcp/types/generated_poc/property/list_property_lists_response.py +8 -8
  207. adcp/types/generated_poc/property/property_error.py +10 -10
  208. adcp/types/generated_poc/property/property_feature.py +4 -4
  209. adcp/types/generated_poc/property/property_feature_definition.py +18 -18
  210. adcp/types/generated_poc/property/property_list.py +11 -11
  211. adcp/types/generated_poc/property/property_list_changed_webhook.py +11 -11
  212. adcp/types/generated_poc/property/property_list_filters.py +7 -7
  213. adcp/types/generated_poc/property/update_property_list_request.py +8 -8
  214. adcp/types/generated_poc/property/update_property_list_response.py +2 -2
  215. adcp/types/generated_poc/protocol/get_adcp_capabilities_request.py +8 -6
  216. adcp/types/generated_poc/protocol/get_adcp_capabilities_response.py +59 -58
  217. adcp/types/generated_poc/signals/activate_signal_request.py +3 -3
  218. adcp/types/generated_poc/signals/activate_signal_response.py +6 -6
  219. adcp/types/generated_poc/signals/get_signals_request.py +8 -8
  220. adcp/types/generated_poc/signals/get_signals_response.py +15 -15
  221. adcp/types/generated_poc/sponsored_intelligence/si_capabilities.py +45 -30
  222. adcp/types/generated_poc/sponsored_intelligence/si_get_offering_request.py +4 -4
  223. adcp/types/generated_poc/sponsored_intelligence/si_get_offering_response.py +23 -23
  224. adcp/types/generated_poc/sponsored_intelligence/si_identity.py +16 -16
  225. adcp/types/generated_poc/sponsored_intelligence/si_initiate_session_request.py +5 -5
  226. adcp/types/generated_poc/sponsored_intelligence/si_initiate_session_response.py +7 -7
  227. adcp/types/generated_poc/sponsored_intelligence/si_send_message_request.py +11 -11
  228. adcp/types/generated_poc/sponsored_intelligence/si_send_message_response.py +37 -23
  229. adcp/types/generated_poc/sponsored_intelligence/si_terminate_session_request.py +17 -17
  230. adcp/types/generated_poc/sponsored_intelligence/si_terminate_session_response.py +15 -15
  231. adcp/types/generated_poc/sponsored_intelligence/si_ui_element.py +11 -11
  232. adcp/utils/format_assets.py +32 -32
  233. {adcp-3.1.0.dist-info → adcp-3.2.0.dist-info}/METADATA +10 -5
  234. adcp-3.2.0.dist-info/RECORD +268 -0
  235. adcp/types/generated_poc/media_buy/list_authorized_properties_request.py +0 -38
  236. adcp/types/generated_poc/media_buy/list_authorized_properties_response.py +0 -84
  237. adcp/types/generated_poc/protocols/adcp_extension.py +0 -50
  238. adcp-3.1.0.dist-info/RECORD +0 -264
  239. {adcp-3.1.0.dist-info → adcp-3.2.0.dist-info}/WHEEL +0 -0
  240. {adcp-3.1.0.dist-info → adcp-3.2.0.dist-info}/entry_points.txt +0 -0
  241. {adcp-3.1.0.dist-info → adcp-3.2.0.dist-info}/licenses/LICENSE +0 -0
  242. {adcp-3.1.0.dist-info → adcp-3.2.0.dist-info}/top_level.txt +0 -0
@@ -15,73 +15,73 @@ from ..enums import asset_content_type
15
15
 
16
16
  class Asset(AdCPBaseModel):
17
17
  model_config = ConfigDict(
18
- extra='allow',
18
+ extra="allow",
19
19
  )
20
- asset_id: Annotated[str, Field(description='Unique identifier for this asset')]
20
+ asset_id: Annotated[str, Field(description="Unique identifier for this asset")]
21
21
  asset_type: Annotated[
22
22
  asset_content_type.AssetContentType,
23
23
  Field(
24
- description='Type of asset. Note: Brand manifests typically contain basic media assets (image, video, audio, text). Code assets (html, javascript, css) and ad markup (vast, daast) are usually not part of brand asset libraries.'
24
+ description="Type of asset. Note: Brand manifests typically contain basic media assets (image, video, audio, text). Code assets (html, javascript, css) and ad markup (vast, daast) are usually not part of brand asset libraries."
25
25
  ),
26
26
  ]
27
- description: Annotated[str | None, Field(description='Asset description or usage notes')] = None
27
+ description: Annotated[str | None, Field(description="Asset description or usage notes")] = None
28
28
  duration_seconds: Annotated[
29
- float | None, Field(description='Video/audio duration in seconds')
29
+ float | None, Field(description="Video/audio duration in seconds")
30
30
  ] = None
31
- file_size_bytes: Annotated[int | None, Field(description='File size in bytes')] = None
31
+ file_size_bytes: Annotated[int | None, Field(description="File size in bytes")] = None
32
32
  format: Annotated[str | None, Field(description="File format (e.g., 'jpg', 'mp4', 'mp3')")] = (
33
33
  None
34
34
  )
35
- height: Annotated[int | None, Field(description='Image/video height in pixels')] = None
35
+ height: Annotated[int | None, Field(description="Image/video height in pixels")] = None
36
36
  metadata: Annotated[
37
- dict[str, Any] | None, Field(description='Additional asset-specific metadata')
37
+ dict[str, Any] | None, Field(description="Additional asset-specific metadata")
38
38
  ] = None
39
- name: Annotated[str | None, Field(description='Human-readable asset name')] = None
39
+ name: Annotated[str | None, Field(description="Human-readable asset name")] = None
40
40
  tags: Annotated[
41
41
  list[str] | None,
42
42
  Field(
43
43
  description="Tags for asset discovery (e.g., 'holiday', 'lifestyle', 'product_shot')"
44
44
  ),
45
45
  ] = None
46
- url: Annotated[AnyUrl, Field(description='URL to CDN-hosted asset file')]
47
- width: Annotated[int | None, Field(description='Image/video width in pixels')] = None
46
+ url: Annotated[AnyUrl, Field(description="URL to CDN-hosted asset file")]
47
+ width: Annotated[int | None, Field(description="Image/video width in pixels")] = None
48
48
 
49
49
 
50
50
  class Avatar(AdCPBaseModel):
51
- avatar_id: Annotated[str | None, Field(description='Provider-specific avatar identifier')] = (
51
+ avatar_id: Annotated[str | None, Field(description="Provider-specific avatar identifier")] = (
52
52
  None
53
53
  )
54
54
  provider: Annotated[
55
55
  str | None, Field(description="Avatar provider (e.g., 'd-id', 'heygen', 'synthesia')")
56
56
  ] = None
57
57
  settings: Annotated[
58
- dict[str, Any] | None, Field(description='Provider-specific avatar settings')
58
+ dict[str, Any] | None, Field(description="Provider-specific avatar settings")
59
59
  ] = None
60
60
 
61
61
 
62
62
  class Colors(AdCPBaseModel):
63
63
  accent: Annotated[
64
- str | None, Field(description='Accent color (hex format)', pattern='^#[0-9A-Fa-f]{6}$')
64
+ str | None, Field(description="Accent color (hex format)", pattern="^#[0-9A-Fa-f]{6}$")
65
65
  ] = None
66
66
  background: Annotated[
67
- str | None, Field(description='Background color (hex format)', pattern='^#[0-9A-Fa-f]{6}$')
67
+ str | None, Field(description="Background color (hex format)", pattern="^#[0-9A-Fa-f]{6}$")
68
68
  ] = None
69
69
  primary: Annotated[
70
70
  str | None,
71
- Field(description='Primary brand color (hex format)', pattern='^#[0-9A-Fa-f]{6}$'),
71
+ Field(description="Primary brand color (hex format)", pattern="^#[0-9A-Fa-f]{6}$"),
72
72
  ] = None
73
73
  secondary: Annotated[
74
74
  str | None,
75
- Field(description='Secondary brand color (hex format)', pattern='^#[0-9A-Fa-f]{6}$'),
75
+ Field(description="Secondary brand color (hex format)", pattern="^#[0-9A-Fa-f]{6}$"),
76
76
  ] = None
77
77
  text: Annotated[
78
- str | None, Field(description='Text color (hex format)', pattern='^#[0-9A-Fa-f]{6}$')
78
+ str | None, Field(description="Text color (hex format)", pattern="^#[0-9A-Fa-f]{6}$")
79
79
  ] = None
80
80
 
81
81
 
82
82
  class Contact(AdCPBaseModel):
83
- email: Annotated[EmailStr | None, Field(description='Contact email')] = None
84
- phone: Annotated[str | None, Field(description='Contact phone number')] = None
83
+ email: Annotated[EmailStr | None, Field(description="Contact email")] = None
84
+ phone: Annotated[str | None, Field(description="Contact phone number")] = None
85
85
 
86
86
 
87
87
  class Disclaimer(AdCPBaseModel):
@@ -91,85 +91,85 @@ class Disclaimer(AdCPBaseModel):
91
91
  description="When this disclaimer applies (e.g., 'financial_products', 'health_claims', 'all')"
92
92
  ),
93
93
  ] = None
94
- required: Annotated[bool | None, Field(description='Whether this disclaimer must appear')] = (
94
+ required: Annotated[bool | None, Field(description="Whether this disclaimer must appear")] = (
95
95
  True
96
96
  )
97
- text: Annotated[str, Field(description='Disclaimer text')]
97
+ text: Annotated[str, Field(description="Disclaimer text")]
98
98
 
99
99
 
100
100
  class Fonts(AdCPBaseModel):
101
101
  font_urls: Annotated[
102
- list[AnyUrl] | None, Field(description='URLs to web font files if using custom fonts')
102
+ list[AnyUrl] | None, Field(description="URLs to web font files if using custom fonts")
103
103
  ] = None
104
- primary: Annotated[str | None, Field(description='Primary font family name')] = None
105
- secondary: Annotated[str | None, Field(description='Secondary font family name')] = None
104
+ primary: Annotated[str | None, Field(description="Primary font family name")] = None
105
+ secondary: Annotated[str | None, Field(description="Secondary font family name")] = None
106
106
 
107
107
 
108
108
  class Logo(AdCPBaseModel):
109
- height: Annotated[int | None, Field(description='Logo height in pixels')] = None
109
+ height: Annotated[int | None, Field(description="Logo height in pixels")] = None
110
110
  tags: Annotated[
111
111
  list[str] | None,
112
112
  Field(
113
113
  description="Semantic tags describing the logo variant (e.g., 'dark', 'light', 'square', 'horizontal', 'icon')"
114
114
  ),
115
115
  ] = None
116
- url: Annotated[AnyUrl, Field(description='URL to the logo asset')]
117
- width: Annotated[int | None, Field(description='Logo width in pixels')] = None
116
+ url: Annotated[AnyUrl, Field(description="URL to the logo asset")]
117
+ width: Annotated[int | None, Field(description="Logo width in pixels")] = None
118
118
 
119
119
 
120
120
  class Metadata(AdCPBaseModel):
121
121
  created_date: Annotated[
122
- AwareDatetime | None, Field(description='When this brand manifest was created')
122
+ AwareDatetime | None, Field(description="When this brand manifest was created")
123
123
  ] = None
124
124
  updated_date: Annotated[
125
- AwareDatetime | None, Field(description='When this brand manifest was last updated')
125
+ AwareDatetime | None, Field(description="When this brand manifest was last updated")
126
126
  ] = None
127
- version: Annotated[str | None, Field(description='Brand card version number')] = None
127
+ version: Annotated[str | None, Field(description="Brand card version number")] = None
128
128
 
129
129
 
130
130
  class AgenticCheckout(AdCPBaseModel):
131
131
  endpoint: Annotated[
132
132
  AnyUrl,
133
133
  Field(
134
- description='Base URL for checkout session API (e.g., https://merchant.com/api/checkout_sessions)'
134
+ description="Base URL for checkout session API (e.g., https://merchant.com/api/checkout_sessions)"
135
135
  ),
136
136
  ]
137
137
  spec: Annotated[
138
- Literal['openai_agentic_checkout_v1'],
139
- Field(description='Checkout API specification implemented by the endpoint'),
138
+ Literal["openai_agentic_checkout_v1"],
139
+ Field(description="Checkout API specification implemented by the endpoint"),
140
140
  ]
141
141
  supported_payment_providers: Annotated[
142
- list[str] | None, Field(description='Payment providers supported by this checkout endpoint')
142
+ list[str] | None, Field(description="Payment providers supported by this checkout endpoint")
143
143
  ] = None
144
144
 
145
145
 
146
146
  class FeedFormat(Enum):
147
- google_merchant_center = 'google_merchant_center'
148
- facebook_catalog = 'facebook_catalog'
149
- openai_product_feed = 'openai_product_feed'
150
- custom = 'custom'
147
+ google_merchant_center = "google_merchant_center"
148
+ facebook_catalog = "facebook_catalog"
149
+ openai_product_feed = "openai_product_feed"
150
+ custom = "custom"
151
151
 
152
152
 
153
153
  class UpdateFrequency(Enum):
154
- realtime = 'realtime'
155
- hourly = 'hourly'
156
- daily = 'daily'
157
- weekly = 'weekly'
154
+ realtime = "realtime"
155
+ hourly = "hourly"
156
+ daily = "daily"
157
+ weekly = "weekly"
158
158
 
159
159
 
160
160
  class ProductCatalog(AdCPBaseModel):
161
161
  model_config = ConfigDict(
162
- extra='allow',
162
+ extra="allow",
163
163
  )
164
164
  agentic_checkout: Annotated[
165
165
  AgenticCheckout | None,
166
166
  Field(
167
- description='Agentic checkout endpoint configuration. Enables AI agents to complete purchases on behalf of users through a structured checkout API.'
167
+ description="Agentic checkout endpoint configuration. Enables AI agents to complete purchases on behalf of users through a structured checkout API."
168
168
  ),
169
169
  ] = None
170
170
  categories: Annotated[
171
171
  list[str] | None,
172
- Field(description='Product categories available in the catalog (for filtering)'),
172
+ Field(description="Product categories available in the catalog (for filtering)"),
173
173
  ] = None
174
174
  feed_format: Annotated[
175
175
  FeedFormat | None,
@@ -177,12 +177,12 @@ class ProductCatalog(AdCPBaseModel):
177
177
  description="Format of the product feed. Use 'openai_product_feed' for feeds conforming to the OpenAI Commerce Product Feed specification."
178
178
  ),
179
179
  ] = FeedFormat.google_merchant_center
180
- feed_url: Annotated[AnyUrl, Field(description='URL to product catalog feed')]
180
+ feed_url: Annotated[AnyUrl, Field(description="URL to product catalog feed")]
181
181
  last_updated: Annotated[
182
- AwareDatetime | None, Field(description='When the product catalog was last updated')
182
+ AwareDatetime | None, Field(description="When the product catalog was last updated")
183
183
  ] = None
184
184
  update_frequency: Annotated[
185
- UpdateFrequency | None, Field(description='How frequently the product catalog is updated')
185
+ UpdateFrequency | None, Field(description="How frequently the product catalog is updated")
186
186
  ] = None
187
187
 
188
188
 
@@ -192,32 +192,32 @@ class Voice(AdCPBaseModel):
192
192
  ] = None
193
193
  settings: Annotated[
194
194
  dict[str, Any] | None,
195
- Field(description='Provider-specific voice settings (speed, pitch, etc.)'),
195
+ Field(description="Provider-specific voice settings (speed, pitch, etc.)"),
196
196
  ] = None
197
- voice_id: Annotated[str | None, Field(description='Provider-specific voice identifier')] = None
197
+ voice_id: Annotated[str | None, Field(description="Provider-specific voice identifier")] = None
198
198
 
199
199
 
200
200
  class BrandManifest(AdCPBaseModel):
201
201
  model_config = ConfigDict(
202
- extra='allow',
202
+ extra="allow",
203
203
  )
204
204
  assets: Annotated[
205
205
  list[Asset] | None,
206
206
  Field(
207
- description='Brand asset library with explicit assets and tags. Assets are referenced inline with URLs pointing to CDN-hosted files.'
207
+ description="Brand asset library with explicit assets and tags. Assets are referenced inline with URLs pointing to CDN-hosted files."
208
208
  ),
209
209
  ] = None
210
210
  avatar: Annotated[
211
211
  Avatar | None,
212
- Field(description='Brand avatar configuration for visual conversational experiences'),
212
+ Field(description="Brand avatar configuration for visual conversational experiences"),
213
213
  ] = None
214
- colors: Annotated[Colors | None, Field(description='Brand color palette')] = None
215
- contact: Annotated[Contact | None, Field(description='Brand contact information')] = None
214
+ colors: Annotated[Colors | None, Field(description="Brand color palette")] = None
215
+ contact: Annotated[Contact | None, Field(description="Brand contact information")] = None
216
216
  disclaimers: Annotated[
217
217
  list[Disclaimer] | None,
218
- Field(description='Legal disclaimers or required text that must appear in creatives'),
218
+ Field(description="Legal disclaimers or required text that must appear in creatives"),
219
219
  ] = None
220
- fonts: Annotated[Fonts | None, Field(description='Brand typography guidelines')] = None
220
+ fonts: Annotated[Fonts | None, Field(description="Brand typography guidelines")] = None
221
221
  industry: Annotated[
222
222
  str | None,
223
223
  Field(
@@ -226,10 +226,10 @@ class BrandManifest(AdCPBaseModel):
226
226
  ] = None
227
227
  logos: Annotated[
228
228
  list[Logo] | None,
229
- Field(description='Brand logo assets with semantic tags for different use cases'),
229
+ Field(description="Brand logo assets with semantic tags for different use cases"),
230
230
  ] = None
231
- metadata: Annotated[Metadata | None, Field(description='Additional brand metadata')] = None
232
- name: Annotated[str, Field(description='Brand or business name')]
231
+ metadata: Annotated[Metadata | None, Field(description="Additional brand metadata")] = None
232
+ name: Annotated[str, Field(description="Brand or business name")]
233
233
  privacy_policy_url: Annotated[
234
234
  AnyUrl | None,
235
235
  Field(
@@ -239,12 +239,12 @@ class BrandManifest(AdCPBaseModel):
239
239
  product_catalog: Annotated[
240
240
  ProductCatalog | None,
241
241
  Field(
242
- description='Product catalog information for e-commerce advertisers. Enables SKU-level creative generation and product selection.'
242
+ description="Product catalog information for e-commerce advertisers. Enables SKU-level creative generation and product selection."
243
243
  ),
244
244
  ] = None
245
- tagline: Annotated[str | None, Field(description='Brand tagline or slogan')] = None
245
+ tagline: Annotated[str | None, Field(description="Brand tagline or slogan")] = None
246
246
  target_audience: Annotated[
247
- str | None, Field(description='Primary target audience description')
247
+ str | None, Field(description="Primary target audience description")
248
248
  ] = None
249
249
  tone: Annotated[
250
250
  str | None,
@@ -255,10 +255,10 @@ class BrandManifest(AdCPBaseModel):
255
255
  url: Annotated[
256
256
  AnyUrl | None,
257
257
  Field(
258
- description='Primary brand URL for context and asset discovery. Creative agents can infer brand information from this URL.'
258
+ description="Primary brand URL for context and asset discovery. Creative agents can infer brand information from this URL."
259
259
  ),
260
260
  ] = None
261
261
  voice: Annotated[
262
262
  Voice | None,
263
- Field(description='Brand voice configuration for audio/conversational experiences'),
263
+ Field(description="Brand voice configuration for audio/conversational experiences"),
264
264
  ] = None
@@ -15,21 +15,21 @@ class BrandManifestReference(RootModel[brand_manifest.BrandManifest | AnyUrl]):
15
15
  root: Annotated[
16
16
  brand_manifest.BrandManifest | AnyUrl,
17
17
  Field(
18
- description='Brand manifest provided either as an inline object or a URL string pointing to a hosted manifest',
18
+ description="Brand manifest provided either as an inline object or a URL string pointing to a hosted manifest",
19
19
  examples=[
20
20
  {
21
- 'data': {
22
- 'colors': {'primary': '#FF6B35'},
23
- 'name': 'ACME Corporation',
24
- 'url': 'https://acmecorp.com',
21
+ "data": {
22
+ "colors": {"primary": "#FF6B35"},
23
+ "name": "ACME Corporation",
24
+ "url": "https://acmecorp.com",
25
25
  },
26
- 'description': 'Inline brand manifest',
26
+ "description": "Inline brand manifest",
27
27
  },
28
28
  {
29
- 'data': 'https://cdn.acmecorp.com/brand-manifest.json',
30
- 'description': 'URL string reference to hosted manifest',
29
+ "data": "https://cdn.acmecorp.com/brand-manifest.json",
30
+ "description": "URL string reference to hosted manifest",
31
31
  },
32
32
  ],
33
- title='Brand Manifest Reference',
33
+ title="Brand Manifest Reference",
34
34
  ),
35
35
  ]
@@ -10,5 +10,5 @@ from pydantic import ConfigDict
10
10
 
11
11
  class ContextObject(AdCPBaseModel):
12
12
  model_config = ConfigDict(
13
- extra='allow',
13
+ extra="allow",
14
14
  )
@@ -28,21 +28,21 @@ from .assets import (
28
28
 
29
29
  class Input(AdCPBaseModel):
30
30
  model_config = ConfigDict(
31
- extra='allow',
31
+ extra="allow",
32
32
  )
33
33
  context_description: Annotated[
34
34
  str | None,
35
- Field(description='Natural language description of the context for AI-generated content'),
35
+ Field(description="Natural language description of the context for AI-generated content"),
36
36
  ] = None
37
37
  macros: Annotated[
38
- dict[str, str] | None, Field(description='Macro values to apply for this preview')
38
+ dict[str, str] | None, Field(description="Macro values to apply for this preview")
39
39
  ] = None
40
- name: Annotated[str, Field(description='Human-readable name for this preview variant')]
40
+ name: Annotated[str, Field(description="Human-readable name for this preview variant")]
41
41
 
42
42
 
43
43
  class CreativeAsset(AdCPBaseModel):
44
44
  model_config = ConfigDict(
45
- extra='allow',
45
+ extra="allow",
46
46
  )
47
47
  assets: Annotated[
48
48
  dict[
@@ -59,22 +59,22 @@ class CreativeAsset(AdCPBaseModel):
59
59
  | promoted_offerings.PromotedOfferings
60
60
  | url_asset.UrlAsset,
61
61
  ],
62
- Field(description='Assets required by the format, keyed by asset_role'),
62
+ Field(description="Assets required by the format, keyed by asset_role"),
63
63
  ]
64
- creative_id: Annotated[str, Field(description='Unique identifier for the creative')]
64
+ creative_id: Annotated[str, Field(description="Unique identifier for the creative")]
65
65
  format_id: Annotated[
66
66
  format_id_1.FormatId,
67
67
  Field(
68
- description='Format identifier specifying which format this creative conforms to. Can be: (1) concrete format_id referencing a format with fixed dimensions, (2) template format_id referencing a template format, or (3) parameterized format_id with dimensions/duration parameters for template formats.'
68
+ description="Format identifier specifying which format this creative conforms to. Can be: (1) concrete format_id referencing a format with fixed dimensions, (2) template format_id referencing a template format, or (3) parameterized format_id with dimensions/duration parameters for template formats."
69
69
  ),
70
70
  ]
71
71
  inputs: Annotated[
72
72
  list[Input] | None,
73
73
  Field(
74
- description='Preview contexts for generative formats - defines what scenarios to generate previews for'
74
+ description="Preview contexts for generative formats - defines what scenarios to generate previews for"
75
75
  ),
76
76
  ] = None
77
- name: Annotated[str, Field(description='Human-readable creative name')]
77
+ name: Annotated[str, Field(description="Human-readable creative name")]
78
78
  placement_ids: Annotated[
79
79
  list[str] | None,
80
80
  Field(
@@ -89,12 +89,12 @@ class CreativeAsset(AdCPBaseModel):
89
89
  ),
90
90
  ] = None
91
91
  tags: Annotated[
92
- list[str] | None, Field(description='User-defined tags for organization and searchability')
92
+ list[str] | None, Field(description="User-defined tags for organization and searchability")
93
93
  ] = None
94
94
  weight: Annotated[
95
95
  float | None,
96
96
  Field(
97
- description='Optional delivery weight for creative rotation when uploading via create_media_buy or update_media_buy (0-100). If omitted, platform determines rotation. Only used during upload to media buy - not stored in creative library.',
97
+ description="Optional delivery weight for creative rotation when uploading via create_media_buy or update_media_buy (0-100). If omitted, platform determines rotation. Only used during upload to media buy - not stored in creative library.",
98
98
  ge=0.0,
99
99
  le=100.0,
100
100
  ),
@@ -12,9 +12,9 @@ from pydantic import ConfigDict, Field
12
12
 
13
13
  class CreativeAssignment(AdCPBaseModel):
14
14
  model_config = ConfigDict(
15
- extra='allow',
15
+ extra="allow",
16
16
  )
17
- creative_id: Annotated[str, Field(description='Unique identifier for the creative')]
17
+ creative_id: Annotated[str, Field(description="Unique identifier for the creative")]
18
18
  placement_ids: Annotated[
19
19
  list[str] | None,
20
20
  Field(
@@ -23,5 +23,5 @@ class CreativeAssignment(AdCPBaseModel):
23
23
  ),
24
24
  ] = None
25
25
  weight: Annotated[
26
- float | None, Field(description='Delivery weight for this creative', ge=0.0, le=100.0)
26
+ float | None, Field(description="Delivery weight for this creative", ge=0.0, le=100.0)
27
27
  ] = None
@@ -1,6 +1,6 @@
1
1
  # generated by datamodel-codegen:
2
2
  # filename: core/creative_filters.json
3
- # timestamp: 2026-01-25T21:17:54+00:00
3
+ # timestamp: 2026-02-02T17:45:21+00:00
4
4
 
5
5
  from __future__ import annotations
6
6
 
@@ -14,63 +14,69 @@ from ..enums import creative_status
14
14
 
15
15
  class CreativeFilters(AdCPBaseModel):
16
16
  model_config = ConfigDict(
17
- extra='allow',
17
+ extra="allow",
18
18
  )
19
+ account_ids: Annotated[
20
+ list[str] | None,
21
+ Field(
22
+ description="Filter creatives by owning accounts. Useful for agencies managing multiple client accounts."
23
+ ),
24
+ ] = None
19
25
  assigned_to_packages: Annotated[
20
- list[str] | None, Field(description='Filter creatives assigned to any of these packages')
26
+ list[str] | None, Field(description="Filter creatives assigned to any of these packages")
21
27
  ] = None
22
28
  buyer_refs: Annotated[
23
29
  list[str] | None,
24
30
  Field(
25
- description='Filter creatives assigned to media buys with any of these buyer references'
31
+ description="Filter creatives assigned to media buys with any of these buyer references"
26
32
  ),
27
33
  ] = None
28
34
  created_after: Annotated[
29
35
  AwareDatetime | None,
30
- Field(description='Filter creatives created after this date (ISO 8601)'),
36
+ Field(description="Filter creatives created after this date (ISO 8601)"),
31
37
  ] = None
32
38
  created_before: Annotated[
33
39
  AwareDatetime | None,
34
- Field(description='Filter creatives created before this date (ISO 8601)'),
40
+ Field(description="Filter creatives created before this date (ISO 8601)"),
35
41
  ] = None
36
42
  creative_ids: Annotated[
37
- list[str] | None, Field(description='Filter by specific creative IDs', max_length=100)
43
+ list[str] | None, Field(description="Filter by specific creative IDs", max_length=100)
38
44
  ] = None
39
45
  formats: Annotated[
40
46
  list[str] | None,
41
- Field(description='Filter by creative format types (e.g., video, audio, display)'),
47
+ Field(description="Filter by creative format types (e.g., video, audio, display)"),
42
48
  ] = None
43
49
  has_performance_data: Annotated[
44
- bool | None, Field(description='Filter creatives that have performance data when true')
50
+ bool | None, Field(description="Filter creatives that have performance data when true")
45
51
  ] = None
46
52
  media_buy_ids: Annotated[
47
- list[str] | None, Field(description='Filter creatives assigned to any of these media buys')
53
+ list[str] | None, Field(description="Filter creatives assigned to any of these media buys")
48
54
  ] = None
49
55
  name_contains: Annotated[
50
56
  str | None,
51
- Field(description='Filter by creative names containing this text (case-insensitive)'),
57
+ Field(description="Filter by creative names containing this text (case-insensitive)"),
52
58
  ] = None
53
59
  statuses: Annotated[
54
60
  list[creative_status.CreativeStatus] | None,
55
- Field(description='Filter by creative approval statuses'),
61
+ Field(description="Filter by creative approval statuses"),
56
62
  ] = None
57
63
  tags: Annotated[
58
- list[str] | None, Field(description='Filter by creative tags (all tags must match)')
64
+ list[str] | None, Field(description="Filter by creative tags (all tags must match)")
59
65
  ] = None
60
66
  tags_any: Annotated[
61
- list[str] | None, Field(description='Filter by creative tags (any tag must match)')
67
+ list[str] | None, Field(description="Filter by creative tags (any tag must match)")
62
68
  ] = None
63
69
  unassigned: Annotated[
64
70
  bool | None,
65
71
  Field(
66
- description='Filter for unassigned creatives when true, assigned creatives when false'
72
+ description="Filter for unassigned creatives when true, assigned creatives when false"
67
73
  ),
68
74
  ] = None
69
75
  updated_after: Annotated[
70
76
  AwareDatetime | None,
71
- Field(description='Filter creatives last updated after this date (ISO 8601)'),
77
+ Field(description="Filter creatives last updated after this date (ISO 8601)"),
72
78
  ] = None
73
79
  updated_before: Annotated[
74
80
  AwareDatetime | None,
75
- Field(description='Filter creatives last updated before this date (ISO 8601)'),
81
+ Field(description="Filter creatives last updated before this date (ISO 8601)"),
76
82
  ] = None
@@ -1,6 +1,6 @@
1
1
  # generated by datamodel-codegen:
2
2
  # filename: core/creative_manifest.json
3
- # timestamp: 2026-01-25T21:17:54+00:00
3
+ # timestamp: 2026-02-02T17:45:21+00:00
4
4
 
5
5
  from __future__ import annotations
6
6
 
@@ -29,7 +29,7 @@ from .assets import (
29
29
 
30
30
  class CreativeManifest(AdCPBaseModel):
31
31
  model_config = ConfigDict(
32
- extra='allow',
32
+ extra="allow",
33
33
  )
34
34
  assets: Annotated[
35
35
  dict[
@@ -48,7 +48,7 @@ class CreativeManifest(AdCPBaseModel):
48
48
  | promoted_offerings.PromotedOfferings,
49
49
  ],
50
50
  Field(
51
- description="Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets_required array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). The asset_id is the technical identifier used to match assets to format requirements.\n\nIMPORTANT: Creative manifest validation MUST be performed in the context of the format specification. The format defines what type each asset_id should be, which eliminates any validation ambiguity."
51
+ description="Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). The asset_id is the technical identifier used to match assets to format requirements.\n\nIMPORTANT: Creative manifest validation MUST be performed in the context of the format specification. The format defines what type each asset_id should be, which eliminates any validation ambiguity."
52
52
  ),
53
53
  ]
54
54
  ext: ext_1.ExtensionObject | None = None
@@ -61,6 +61,6 @@ class CreativeManifest(AdCPBaseModel):
61
61
  promoted_offering: Annotated[
62
62
  str | None,
63
63
  Field(
64
- description='Product name or offering being advertised. Maps to promoted_offerings in create_media_buy request to associate creative with the product being promoted.'
64
+ description="Product name or offering being advertised. Maps to promoted_offerings in create_media_buy request to associate creative with the product being promoted."
65
65
  ),
66
66
  ] = None
@@ -14,15 +14,15 @@ from ..enums import co_branding_requirement, landing_page_requirement
14
14
 
15
15
  class CreativePolicy(AdCPBaseModel):
16
16
  model_config = ConfigDict(
17
- extra='allow',
17
+ extra="allow",
18
18
  )
19
19
  co_branding: Annotated[
20
- co_branding_requirement.CoBrandingRequirement, Field(description='Co-branding requirement')
20
+ co_branding_requirement.CoBrandingRequirement, Field(description="Co-branding requirement")
21
21
  ]
22
22
  landing_page: Annotated[
23
23
  landing_page_requirement.LandingPageRequirement,
24
- Field(description='Landing page requirements'),
24
+ Field(description="Landing page requirements"),
25
25
  ]
26
26
  templates_available: Annotated[
27
- bool, Field(description='Whether creative templates are provided')
27
+ bool, Field(description="Whether creative templates are provided")
28
28
  ]