@adcp/sdk 17.0.0-beta.12 → 17.0.0-beta.13

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 (1655) hide show
  1. package/compliance/cache/{3.2.7 → 3.2.8}/index.json +3 -3
  2. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/creative_lifecycle_webhooks.yaml +2 -0
  3. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/creative_fate_after_cancellation.yaml +2 -4
  4. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/dependency_impairment.yaml +2 -4
  5. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/dependency_impairment_cardinality.yaml +2 -4
  6. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/invalid_transitions.yaml +2 -4
  7. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/measurement_terms_rejected.yaml +6 -7
  8. package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-broadcast-tv/index.yaml +7 -1
  9. package/compliance/cache/{3.2.7 → 3.2.8}/universal/stale-response-advisory.yaml +77 -69
  10. package/compliance/cache/{3.2.7 → 3.2.8}/universal/storyboard-schema.yaml +7 -0
  11. package/dist/lib/adapters/version/schema-projection.js +37 -2
  12. package/dist/lib/adapters/version/schema-projection.mjs +37 -2
  13. package/dist/lib/core/SingleAgentClient.js +3 -3
  14. package/dist/lib/core/SingleAgentClient.mjs +4 -3
  15. package/dist/lib/negotiation/commercial-terms-semantics.js +11 -0
  16. package/dist/lib/negotiation/commercial-terms-semantics.mjs +11 -0
  17. package/dist/lib/schemas-data/3.2/a2ui/bound-value.json +1 -1
  18. package/dist/lib/schemas-data/3.2/a2ui/component.json +1 -1
  19. package/dist/lib/schemas-data/3.2/a2ui/si-catalog.json +25 -25
  20. package/dist/lib/schemas-data/3.2/a2ui/surface.json +2 -2
  21. package/dist/lib/schemas-data/3.2/a2ui/user-action.json +1 -1
  22. package/dist/lib/schemas-data/3.2/aao/agent-publishers.json +1 -1
  23. package/dist/lib/schemas-data/3.2/account/get-account-financials-request.json +6 -6
  24. package/dist/lib/schemas-data/3.2/account/get-account-financials-response.json +12 -12
  25. package/dist/lib/schemas-data/3.2/account/list-account-changes-request.json +7 -7
  26. package/dist/lib/schemas-data/3.2/account/list-account-changes-response.json +7 -7
  27. package/dist/lib/schemas-data/3.2/account/list-accounts-request.json +6 -6
  28. package/dist/lib/schemas-data/3.2/account/list-accounts-response.json +8 -8
  29. package/dist/lib/schemas-data/3.2/account/report-usage-request.json +6 -6
  30. package/dist/lib/schemas-data/3.2/account/report-usage-response.json +6 -6
  31. package/dist/lib/schemas-data/3.2/account/sync-accounts-request.json +16 -16
  32. package/dist/lib/schemas-data/3.2/account/sync-accounts-response.json +21 -21
  33. package/dist/lib/schemas-data/3.2/account/sync-governance-request.json +5 -5
  34. package/dist/lib/schemas-data/3.2/account/sync-governance-response.json +10 -10
  35. package/dist/lib/schemas-data/3.2/adagents.json +30 -30
  36. package/dist/lib/schemas-data/3.2/brand/acquire-rights-request.json +12 -12
  37. package/dist/lib/schemas-data/3.2/brand/acquire-rights-response.json +16 -16
  38. package/dist/lib/schemas-data/3.2/brand/creative-approval-request.json +5 -5
  39. package/dist/lib/schemas-data/3.2/brand/creative-approval-response.json +12 -12
  40. package/dist/lib/schemas-data/3.2/brand/get-brand-identity-request.json +4 -4
  41. package/dist/lib/schemas-data/3.2/brand/get-brand-identity-response.json +10 -10
  42. package/dist/lib/schemas-data/3.2/brand/get-rights-request.json +8 -8
  43. package/dist/lib/schemas-data/3.2/brand/get-rights-response.json +11 -11
  44. package/dist/lib/schemas-data/3.2/brand/revocation-notification.json +4 -4
  45. package/dist/lib/schemas-data/3.2/brand/rights-pricing-option.json +5 -5
  46. package/dist/lib/schemas-data/3.2/brand/rights-terms.json +3 -3
  47. package/dist/lib/schemas-data/3.2/brand/search-brands-request.json +6 -6
  48. package/dist/lib/schemas-data/3.2/brand/search-brands-response.json +11 -11
  49. package/dist/lib/schemas-data/3.2/brand/update-rights-request.json +6 -6
  50. package/dist/lib/schemas-data/3.2/brand/update-rights-response.json +11 -11
  51. package/dist/lib/schemas-data/3.2/brand/verification-status.json +1 -1
  52. package/dist/lib/schemas-data/3.2/brand/verify-brand-claim-request.json +3 -3
  53. package/dist/lib/schemas-data/3.2/brand/verify-brand-claim-response.json +13 -13
  54. package/dist/lib/schemas-data/3.2/brand/verify-brand-claims-request.json +3 -3
  55. package/dist/lib/schemas-data/3.2/brand/verify-brand-claims-response.json +13 -13
  56. package/dist/lib/schemas-data/3.2/brand.json +23 -23
  57. package/dist/lib/schemas-data/3.2/bundled.schemas.br +0 -0
  58. package/dist/lib/schemas-data/3.2/collection/base-collection-source.json +3 -3
  59. package/dist/lib/schemas-data/3.2/collection/collection-list-changed-webhook.json +2 -2
  60. package/dist/lib/schemas-data/3.2/collection/collection-list-filters.json +7 -7
  61. package/dist/lib/schemas-data/3.2/collection/collection-list.json +5 -5
  62. package/dist/lib/schemas-data/3.2/collection/create-collection-list-request.json +8 -8
  63. package/dist/lib/schemas-data/3.2/collection/create-collection-list-response.json +6 -6
  64. package/dist/lib/schemas-data/3.2/collection/delete-collection-list-request.json +5 -5
  65. package/dist/lib/schemas-data/3.2/collection/delete-collection-list-response.json +5 -5
  66. package/dist/lib/schemas-data/3.2/collection/get-collection-list-request.json +5 -5
  67. package/dist/lib/schemas-data/3.2/collection/get-collection-list-response.json +12 -12
  68. package/dist/lib/schemas-data/3.2/collection/list-collection-lists-request.json +6 -6
  69. package/dist/lib/schemas-data/3.2/collection/list-collection-lists-response.json +7 -7
  70. package/dist/lib/schemas-data/3.2/collection/update-collection-list-request.json +8 -8
  71. package/dist/lib/schemas-data/3.2/collection/update-collection-list-response.json +6 -6
  72. package/dist/lib/schemas-data/3.2/content-standards/artifact-webhook-payload.json +3 -3
  73. package/dist/lib/schemas-data/3.2/content-standards/artifact.json +8 -8
  74. package/dist/lib/schemas-data/3.2/content-standards/calibrate-content-request.json +5 -5
  75. package/dist/lib/schemas-data/3.2/content-standards/calibrate-content-response.json +10 -10
  76. package/dist/lib/schemas-data/3.2/content-standards/content-standards.json +7 -7
  77. package/dist/lib/schemas-data/3.2/content-standards/create-content-standards-request.json +8 -8
  78. package/dist/lib/schemas-data/3.2/content-standards/create-content-standards-response.json +8 -8
  79. package/dist/lib/schemas-data/3.2/content-standards/get-content-standards-request.json +4 -4
  80. package/dist/lib/schemas-data/3.2/content-standards/get-content-standards-response.json +9 -9
  81. package/dist/lib/schemas-data/3.2/content-standards/get-media-buy-artifacts-request.json +5 -5
  82. package/dist/lib/schemas-data/3.2/content-standards/get-media-buy-artifacts-response.json +10 -10
  83. package/dist/lib/schemas-data/3.2/content-standards/list-content-standards-request.json +6 -6
  84. package/dist/lib/schemas-data/3.2/content-standards/list-content-standards-response.json +10 -10
  85. package/dist/lib/schemas-data/3.2/content-standards/update-content-standards-request.json +8 -8
  86. package/dist/lib/schemas-data/3.2/content-standards/update-content-standards-response.json +8 -8
  87. package/dist/lib/schemas-data/3.2/content-standards/validate-content-delivery-request.json +5 -5
  88. package/dist/lib/schemas-data/3.2/content-standards/validate-content-delivery-response.json +10 -10
  89. package/dist/lib/schemas-data/3.2/core/acceptance-policy-profile-ids.json +1 -1
  90. package/dist/lib/schemas-data/3.2/core/account-authorization.json +1 -1
  91. package/dist/lib/schemas-data/3.2/core/account-change-recorded-webhook.json +2 -2
  92. package/dist/lib/schemas-data/3.2/core/account-change.json +2 -2
  93. package/dist/lib/schemas-data/3.2/core/account-identity-change-preview.json +4 -4
  94. package/dist/lib/schemas-data/3.2/core/account-identity-change.json +3 -3
  95. package/dist/lib/schemas-data/3.2/core/account-ref.json +3 -3
  96. package/dist/lib/schemas-data/3.2/core/account-status-changed-webhook.json +4 -4
  97. package/dist/lib/schemas-data/3.2/core/account-timezone-capability.json +1 -1
  98. package/dist/lib/schemas-data/3.2/core/account-with-authorization.json +3 -3
  99. package/dist/lib/schemas-data/3.2/core/account.json +14 -14
  100. package/dist/lib/schemas-data/3.2/core/activation-key.json +1 -1
  101. package/dist/lib/schemas-data/3.2/core/ad-inventory-config.json +1 -1
  102. package/dist/lib/schemas-data/3.2/core/agent-encryption-key.json +1 -1
  103. package/dist/lib/schemas-data/3.2/core/agent-notification-config-state.json +4 -4
  104. package/dist/lib/schemas-data/3.2/core/agent-notification-config.json +4 -4
  105. package/dist/lib/schemas-data/3.2/core/agent-reporting-destination-state.json +4 -4
  106. package/dist/lib/schemas-data/3.2/core/agent-reporting-destination.json +8 -8
  107. package/dist/lib/schemas-data/3.2/core/agent-signing-key.json +1 -1
  108. package/dist/lib/schemas-data/3.2/core/agent-webhook-challenge.json +1 -1
  109. package/dist/lib/schemas-data/3.2/core/app-item.json +4 -4
  110. package/dist/lib/schemas-data/3.2/core/applicable-package-id.json +1 -1
  111. package/dist/lib/schemas-data/3.2/core/asset-group-vocabulary.json +1 -1
  112. package/dist/lib/schemas-data/3.2/core/assets/asset-union.json +22 -22
  113. package/dist/lib/schemas-data/3.2/core/assets/audio-asset.json +3 -3
  114. package/dist/lib/schemas-data/3.2/core/assets/brief-asset.json +2 -2
  115. package/dist/lib/schemas-data/3.2/core/assets/card-asset.json +6 -6
  116. package/dist/lib/schemas-data/3.2/core/assets/catalog-asset.json +2 -2
  117. package/dist/lib/schemas-data/3.2/core/assets/css-asset.json +2 -2
  118. package/dist/lib/schemas-data/3.2/core/assets/daast-asset.json +6 -6
  119. package/dist/lib/schemas-data/3.2/core/assets/daast-tracker-asset.json +5 -5
  120. package/dist/lib/schemas-data/3.2/core/assets/display-tag-asset.json +12 -12
  121. package/dist/lib/schemas-data/3.2/core/assets/html-asset.json +2 -2
  122. package/dist/lib/schemas-data/3.2/core/assets/image-asset.json +2 -2
  123. package/dist/lib/schemas-data/3.2/core/assets/javascript-asset.json +3 -3
  124. package/dist/lib/schemas-data/3.2/core/assets/markdown-asset.json +2 -2
  125. package/dist/lib/schemas-data/3.2/core/assets/pixel-tracker-asset.json +5 -5
  126. package/dist/lib/schemas-data/3.2/core/assets/published-post-asset.json +2 -2
  127. package/dist/lib/schemas-data/3.2/core/assets/text-asset.json +2 -2
  128. package/dist/lib/schemas-data/3.2/core/assets/url-asset.json +5 -5
  129. package/dist/lib/schemas-data/3.2/core/assets/vast-asset.json +6 -6
  130. package/dist/lib/schemas-data/3.2/core/assets/vast-tracker-asset.json +5 -5
  131. package/dist/lib/schemas-data/3.2/core/assets/video-asset.json +7 -7
  132. package/dist/lib/schemas-data/3.2/core/assets/webhook-asset.json +7 -7
  133. package/dist/lib/schemas-data/3.2/core/assets/zip-asset.json +2 -2
  134. package/dist/lib/schemas-data/3.2/core/async-response-data.json +43 -43
  135. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/get-creative-features-async-response-submitted.json +3 -3
  136. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/sync-creatives-async-response-input-required.json +3 -3
  137. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/sync-creatives-async-response-submitted.json +4 -4
  138. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/sync-creatives-async-response-working.json +3 -3
  139. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/accept-proposal-async-response-input-required.json +2 -2
  140. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/accept-proposal-async-response-submitted.json +2 -2
  141. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/accept-proposal-async-response-working.json +2 -2
  142. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/build-creative-async-response-input-required.json +4 -4
  143. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/build-creative-async-response-submitted.json +4 -4
  144. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/build-creative-async-response-working.json +3 -3
  145. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/buy-products-async-response-input-required.json +2 -2
  146. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/buy-products-async-response-submitted.json +2 -2
  147. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/buy-products-async-response-working.json +2 -2
  148. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/control-media-buy-async-response-input-required.json +2 -2
  149. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/control-media-buy-async-response-submitted.json +2 -2
  150. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/control-media-buy-async-response-working.json +2 -2
  151. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/create-media-buy-async-response-input-required.json +4 -4
  152. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/create-media-buy-async-response-submitted.json +4 -4
  153. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/create-media-buy-async-response-working.json +3 -3
  154. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/decline-proposals-async-response-input-required.json +2 -2
  155. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/decline-proposals-async-response-submitted.json +2 -2
  156. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/decline-proposals-async-response-working.json +2 -2
  157. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/get-products-async-response-input-required.json +4 -4
  158. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/get-products-async-response-submitted.json +4 -4
  159. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/get-products-async-response-working.json +3 -3
  160. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/refine-proposals-async-response-input-required.json +2 -2
  161. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/refine-proposals-async-response-submitted.json +2 -2
  162. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/refine-proposals-async-response-working.json +2 -2
  163. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/request-proposals-async-response-input-required.json +2 -2
  164. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/request-proposals-async-response-submitted.json +2 -2
  165. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/request-proposals-async-response-working.json +2 -2
  166. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/sync-catalogs-async-response-input-required.json +3 -3
  167. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/sync-catalogs-async-response-submitted.json +4 -4
  168. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/sync-catalogs-async-response-working.json +3 -3
  169. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/update-media-buy-async-response-input-required.json +3 -3
  170. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/update-media-buy-async-response-submitted.json +4 -4
  171. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/update-media-buy-async-response-working.json +3 -3
  172. package/dist/lib/schemas-data/3.2/core/async-response-refs/signals/get-signals-async-response-submitted.json +4 -4
  173. package/dist/lib/schemas-data/3.2/core/async-response-refs/signals/get-signals-async-response-working.json +3 -3
  174. package/dist/lib/schemas-data/3.2/core/attestation-capabilities.json +5 -5
  175. package/dist/lib/schemas-data/3.2/core/attestation-evaluation.json +2 -2
  176. package/dist/lib/schemas-data/3.2/core/attestation-issuer.json +5 -5
  177. package/dist/lib/schemas-data/3.2/core/attestation-reference.json +7 -7
  178. package/dist/lib/schemas-data/3.2/core/attestation-subject.json +5 -5
  179. package/dist/lib/schemas-data/3.2/core/attribution-window.json +4 -4
  180. package/dist/lib/schemas-data/3.2/core/audience-activation-method.json +6 -6
  181. package/dist/lib/schemas-data/3.2/core/audience-characteristic.json +1 -1
  182. package/dist/lib/schemas-data/3.2/core/audience-evidence-pin.json +2 -2
  183. package/dist/lib/schemas-data/3.2/core/audience-evidence-requirements.json +10 -10
  184. package/dist/lib/schemas-data/3.2/core/audience-evidence-selection.json +5 -5
  185. package/dist/lib/schemas-data/3.2/core/audience-evidence.json +10 -10
  186. package/dist/lib/schemas-data/3.2/core/audience-member.json +3 -3
  187. package/dist/lib/schemas-data/3.2/core/audience-selector.json +7 -7
  188. package/dist/lib/schemas-data/3.2/core/audience-source.json +3 -3
  189. package/dist/lib/schemas-data/3.2/core/authorized-agent-base.json +3 -3
  190. package/dist/lib/schemas-data/3.2/core/bidding-policy-capability.json +1 -1
  191. package/dist/lib/schemas-data/3.2/core/bidding-policy.json +1 -1
  192. package/dist/lib/schemas-data/3.2/core/brand-id.json +1 -1
  193. package/dist/lib/schemas-data/3.2/core/brand-key.json +2 -2
  194. package/dist/lib/schemas-data/3.2/core/brand-ref.json +3 -3
  195. package/dist/lib/schemas-data/3.2/core/brand-response-authorization-result.json +1 -1
  196. package/dist/lib/schemas-data/3.2/core/budget-allocation.json +2 -2
  197. package/dist/lib/schemas-data/3.2/core/budget-range.json +1 -1
  198. package/dist/lib/schemas-data/3.2/core/business-entity.json +2 -2
  199. package/dist/lib/schemas-data/3.2/core/cancellation-policy.json +2 -2
  200. package/dist/lib/schemas-data/3.2/core/canonical-account-ref.json +3 -3
  201. package/dist/lib/schemas-data/3.2/core/canonical-audience-evidence-selection.json +3 -3
  202. package/dist/lib/schemas-data/3.2/core/canonical-audience-evidence.json +8 -8
  203. package/dist/lib/schemas-data/3.2/core/canonical-budget-allocation.json +2 -2
  204. package/dist/lib/schemas-data/3.2/core/canonical-delivery-forecast.json +7 -7
  205. package/dist/lib/schemas-data/3.2/core/canonical-forecast-point.json +12 -12
  206. package/dist/lib/schemas-data/3.2/core/canonical-forecast-vendor-metric-value.json +5 -5
  207. package/dist/lib/schemas-data/3.2/core/canonical-format-kind.json +1 -1
  208. package/dist/lib/schemas-data/3.2/core/canonical-format-option.json +6 -6
  209. package/dist/lib/schemas-data/3.2/core/canonical-measurement-terms.json +3 -3
  210. package/dist/lib/schemas-data/3.2/core/canonical-media-buy-action-fields.json +6 -6
  211. package/dist/lib/schemas-data/3.2/core/canonical-media-buy-action.json +4 -4
  212. package/dist/lib/schemas-data/3.2/core/canonical-media-buy-features.json +2 -2
  213. package/dist/lib/schemas-data/3.2/core/canonical-metric-qualifier.json +6 -6
  214. package/dist/lib/schemas-data/3.2/core/canonical-optimization-goal.json +9 -9
  215. package/dist/lib/schemas-data/3.2/core/canonical-performance-standard.json +4 -4
  216. package/dist/lib/schemas-data/3.2/core/canonical-placement.json +9 -9
  217. package/dist/lib/schemas-data/3.2/core/canonical-pricing-option.json +5 -5
  218. package/dist/lib/schemas-data/3.2/core/canonical-product-action.json +6 -6
  219. package/dist/lib/schemas-data/3.2/core/canonical-product.json +141 -32
  220. package/dist/lib/schemas-data/3.2/core/canonical-projection-ref.json +3 -3
  221. package/dist/lib/schemas-data/3.2/core/canonical-projection-slot-override.json +1 -1
  222. package/dist/lib/schemas-data/3.2/core/canonical-proposal.json +6 -6
  223. package/dist/lib/schemas-data/3.2/core/canonical-reporting-capabilities.json +11 -11
  224. package/dist/lib/schemas-data/3.2/core/canonical-reporting-commitment.json +6 -6
  225. package/dist/lib/schemas-data/3.2/core/canvas-constraint.json +1 -1
  226. package/dist/lib/schemas-data/3.2/core/capabilities-changed-webhook.json +2 -2
  227. package/dist/lib/schemas-data/3.2/core/catalog-field-mapping.json +2 -2
  228. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-error.json +3 -3
  229. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-ref.json +1 -1
  230. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-state.json +4 -4
  231. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-update-result.json +4 -4
  232. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-update.json +2 -2
  233. package/dist/lib/schemas-data/3.2/core/catalog-item-delivery-metrics.json +3 -3
  234. package/dist/lib/schemas-data/3.2/core/catalog-item-reference-not-found-error.json +1 -1
  235. package/dist/lib/schemas-data/3.2/core/catalog-selection.json +7 -7
  236. package/dist/lib/schemas-data/3.2/core/catalog.json +7 -7
  237. package/dist/lib/schemas-data/3.2/core/catchment.json +5 -5
  238. package/dist/lib/schemas-data/3.2/core/collection-delivery-metrics.json +3 -3
  239. package/dist/lib/schemas-data/3.2/core/collection-distribution.json +3 -3
  240. package/dist/lib/schemas-data/3.2/core/collection-list-ref.json +1 -1
  241. package/dist/lib/schemas-data/3.2/core/collection-property-delivery-metrics.json +5 -5
  242. package/dist/lib/schemas-data/3.2/core/collection-ref.json +1 -1
  243. package/dist/lib/schemas-data/3.2/core/collection-selection.json +4 -4
  244. package/dist/lib/schemas-data/3.2/core/collection-selector.json +1 -1
  245. package/dist/lib/schemas-data/3.2/core/collection.json +13 -13
  246. package/dist/lib/schemas-data/3.2/core/committed-metric.json +14 -14
  247. package/dist/lib/schemas-data/3.2/core/compact-task-input-required.json +4 -4
  248. package/dist/lib/schemas-data/3.2/core/compact-task-submitted.json +6 -6
  249. package/dist/lib/schemas-data/3.2/core/compact-task-working.json +3 -3
  250. package/dist/lib/schemas-data/3.2/core/content-rating.json +2 -2
  251. package/dist/lib/schemas-data/3.2/core/context.json +1 -1
  252. package/dist/lib/schemas-data/3.2/core/creative-approval-scope.json +3 -3
  253. package/dist/lib/schemas-data/3.2/core/creative-asset.json +13 -13
  254. package/dist/lib/schemas-data/3.2/core/creative-assets.json +3 -3
  255. package/dist/lib/schemas-data/3.2/core/creative-assignment.json +2 -2
  256. package/dist/lib/schemas-data/3.2/core/creative-brief.json +4 -4
  257. package/dist/lib/schemas-data/3.2/core/creative-consumption.json +1 -1
  258. package/dist/lib/schemas-data/3.2/core/creative-delivery-metrics.json +2 -2
  259. package/dist/lib/schemas-data/3.2/core/creative-filters.json +8 -8
  260. package/dist/lib/schemas-data/3.2/core/creative-item.json +1 -1
  261. package/dist/lib/schemas-data/3.2/core/creative-locale-policy.json +2 -2
  262. package/dist/lib/schemas-data/3.2/core/creative-localization-readback.json +6 -6
  263. package/dist/lib/schemas-data/3.2/core/creative-localization.json +6 -6
  264. package/dist/lib/schemas-data/3.2/core/creative-manifest.json +13 -13
  265. package/dist/lib/schemas-data/3.2/core/creative-operation-format-declaration.json +7 -7
  266. package/dist/lib/schemas-data/3.2/core/creative-policy.json +3 -3
  267. package/dist/lib/schemas-data/3.2/core/creative-representation-set.json +4 -4
  268. package/dist/lib/schemas-data/3.2/core/creative-representation.json +2 -2
  269. package/dist/lib/schemas-data/3.2/core/creative-revision-id.json +1 -1
  270. package/dist/lib/schemas-data/3.2/core/creative-variable.json +1 -1
  271. package/dist/lib/schemas-data/3.2/core/creative-variant.json +6 -6
  272. package/dist/lib/schemas-data/3.2/core/daast-tracker-constraints.json +2 -2
  273. package/dist/lib/schemas-data/3.2/core/data-provider-signal-selector.json +1 -1
  274. package/dist/lib/schemas-data/3.2/core/date-range.json +1 -1
  275. package/dist/lib/schemas-data/3.2/core/datetime-range.json +1 -1
  276. package/dist/lib/schemas-data/3.2/core/daypart-target.json +3 -3
  277. package/dist/lib/schemas-data/3.2/core/deadline-policy.json +1 -1
  278. package/dist/lib/schemas-data/3.2/core/delivery-breakdown-controls.json +3 -3
  279. package/dist/lib/schemas-data/3.2/core/delivery-forecast.json +7 -7
  280. package/dist/lib/schemas-data/3.2/core/delivery-metric-aggregate.json +14 -14
  281. package/dist/lib/schemas-data/3.2/core/delivery-metrics.json +11 -11
  282. package/dist/lib/schemas-data/3.2/core/delivery-provider.json +1 -1
  283. package/dist/lib/schemas-data/3.2/core/delivery-recipient.json +2 -2
  284. package/dist/lib/schemas-data/3.2/core/demographic-age-range.json +1 -1
  285. package/dist/lib/schemas-data/3.2/core/demographic-predicate.json +2 -2
  286. package/dist/lib/schemas-data/3.2/core/demographic-reporting-capability.json +4 -4
  287. package/dist/lib/schemas-data/3.2/core/demographic-targeting-capability.json +4 -4
  288. package/dist/lib/schemas-data/3.2/core/demographic-targeting-intent.json +4 -4
  289. package/dist/lib/schemas-data/3.2/core/demographic-targeting-resolution.json +10 -10
  290. package/dist/lib/schemas-data/3.2/core/deployment.json +3 -3
  291. package/dist/lib/schemas-data/3.2/core/destination-item.json +4 -4
  292. package/dist/lib/schemas-data/3.2/core/destination.json +1 -1
  293. package/dist/lib/schemas-data/3.2/core/diagnostic-issue.json +1 -1
  294. package/dist/lib/schemas-data/3.2/core/downstream-connection-requirement.json +1 -1
  295. package/dist/lib/schemas-data/3.2/core/duration.json +1 -1
  296. package/dist/lib/schemas-data/3.2/core/education-item.json +4 -4
  297. package/dist/lib/schemas-data/3.2/core/error.json +1 -1
  298. package/dist/lib/schemas-data/3.2/core/evaluator-spec.json +5 -5
  299. package/dist/lib/schemas-data/3.2/core/event-custom-data.json +2 -2
  300. package/dist/lib/schemas-data/3.2/core/event-source-health.json +3 -3
  301. package/dist/lib/schemas-data/3.2/core/event-surface.json +2 -2
  302. package/dist/lib/schemas-data/3.2/core/event.json +8 -8
  303. package/dist/lib/schemas-data/3.2/core/experimental-feature-id.json +1 -1
  304. package/dist/lib/schemas-data/3.2/core/ext.json +1 -1
  305. package/dist/lib/schemas-data/3.2/core/feature-requirement.json +1 -1
  306. package/dist/lib/schemas-data/3.2/core/flight-item.json +4 -4
  307. package/dist/lib/schemas-data/3.2/core/forecast-dimension-audience.json +2 -2
  308. package/dist/lib/schemas-data/3.2/core/forecast-dimension-device-platform.json +2 -2
  309. package/dist/lib/schemas-data/3.2/core/forecast-dimension-device-type.json +2 -2
  310. package/dist/lib/schemas-data/3.2/core/forecast-dimension-geo.json +5 -5
  311. package/dist/lib/schemas-data/3.2/core/forecast-dimension-placement.json +2 -2
  312. package/dist/lib/schemas-data/3.2/core/forecast-dimension-signal.json +2 -2
  313. package/dist/lib/schemas-data/3.2/core/forecast-dimension-time.json +1 -1
  314. package/dist/lib/schemas-data/3.2/core/forecast-point-dimensions.json +8 -8
  315. package/dist/lib/schemas-data/3.2/core/forecast-point.json +28 -28
  316. package/dist/lib/schemas-data/3.2/core/forecast-range.json +1 -1
  317. package/dist/lib/schemas-data/3.2/core/forecast-rate-range.json +2 -2
  318. package/dist/lib/schemas-data/3.2/core/forecast-vendor-metric-value.json +7 -7
  319. package/dist/lib/schemas-data/3.2/core/format-id.json +1 -1
  320. package/dist/lib/schemas-data/3.2/core/format-option-ref.json +1 -1
  321. package/dist/lib/schemas-data/3.2/core/format-shape-vocabulary.json +1 -1
  322. package/dist/lib/schemas-data/3.2/core/format.json +45 -45
  323. package/dist/lib/schemas-data/3.2/core/frequency-cap-constraints.json +8 -8
  324. package/dist/lib/schemas-data/3.2/core/frequency-cap-duration-unit.json +1 -1
  325. package/dist/lib/schemas-data/3.2/core/frequency-cap-impression-constraints.json +2 -2
  326. package/dist/lib/schemas-data/3.2/core/frequency-cap-interval-constraints.json +3 -3
  327. package/dist/lib/schemas-data/3.2/core/frequency-cap-requirements.json +6 -6
  328. package/dist/lib/schemas-data/3.2/core/frequency-cap.json +4 -4
  329. package/dist/lib/schemas-data/3.2/core/generation-credential.json +3 -3
  330. package/dist/lib/schemas-data/3.2/core/geo-breakdown-support.json +3 -3
  331. package/dist/lib/schemas-data/3.2/core/geo-delivery-metrics.json +6 -6
  332. package/dist/lib/schemas-data/3.2/core/geo-metro.json +2 -2
  333. package/dist/lib/schemas-data/3.2/core/geo-place-area.json +4 -4
  334. package/dist/lib/schemas-data/3.2/core/geo-place-catalog-capability.json +2 -2
  335. package/dist/lib/schemas-data/3.2/core/geo-place-catalog-entry.json +3 -3
  336. package/dist/lib/schemas-data/3.2/core/geo-place-requirement.json +3 -3
  337. package/dist/lib/schemas-data/3.2/core/geo-place-resolver.json +1 -1
  338. package/dist/lib/schemas-data/3.2/core/geo-place-support.json +3 -3
  339. package/dist/lib/schemas-data/3.2/core/geo-place-system.json +1 -1
  340. package/dist/lib/schemas-data/3.2/core/geo-place-type.json +1 -1
  341. package/dist/lib/schemas-data/3.2/core/geo-region-requirement.json +1 -1
  342. package/dist/lib/schemas-data/3.2/core/geo-region-support.json +2 -2
  343. package/dist/lib/schemas-data/3.2/core/get-geo-place-resolution-request.json +3 -3
  344. package/dist/lib/schemas-data/3.2/core/get-geo-place-resolution-response.json +4 -4
  345. package/dist/lib/schemas-data/3.2/core/hotel-item.json +4 -4
  346. package/dist/lib/schemas-data/3.2/core/iana-timezone.json +1 -1
  347. package/dist/lib/schemas-data/3.2/core/identifier.json +2 -2
  348. package/dist/lib/schemas-data/3.2/core/impairment.json +3 -3
  349. package/dist/lib/schemas-data/3.2/core/indicator-bearing.json +4 -4
  350. package/dist/lib/schemas-data/3.2/core/indicator-scope.json +1 -1
  351. package/dist/lib/schemas-data/3.2/core/indicator.json +4 -4
  352. package/dist/lib/schemas-data/3.2/core/indicators-changed-webhook.json +3 -3
  353. package/dist/lib/schemas-data/3.2/core/industry-identifier.json +2 -2
  354. package/dist/lib/schemas-data/3.2/core/insertion-order.json +1 -1
  355. package/dist/lib/schemas-data/3.2/core/installment-deadlines.json +2 -2
  356. package/dist/lib/schemas-data/3.2/core/installment-delivery-metrics.json +3 -3
  357. package/dist/lib/schemas-data/3.2/core/installment-property-delivery-metrics.json +5 -5
  358. package/dist/lib/schemas-data/3.2/core/installment-ref.json +2 -2
  359. package/dist/lib/schemas-data/3.2/core/installment.json +10 -10
  360. package/dist/lib/schemas-data/3.2/core/inventory-list-application.json +1 -1
  361. package/dist/lib/schemas-data/3.2/core/job-item.json +3 -3
  362. package/dist/lib/schemas-data/3.2/core/keyword-delivery-metrics.json +3 -3
  363. package/dist/lib/schemas-data/3.2/core/keyword-target.json +2 -2
  364. package/dist/lib/schemas-data/3.2/core/limited-series.json +1 -1
  365. package/dist/lib/schemas-data/3.2/core/locale-tag.json +1 -1
  366. package/dist/lib/schemas-data/3.2/core/localized-creative-asset.json +3 -3
  367. package/dist/lib/schemas-data/3.2/core/macro-bearing-url.json +1 -1
  368. package/dist/lib/schemas-data/3.2/core/macro-declaration.json +10 -10
  369. package/dist/lib/schemas-data/3.2/core/macro-encoding.json +1 -1
  370. package/dist/lib/schemas-data/3.2/core/macro-resolution-capability.json +8 -8
  371. package/dist/lib/schemas-data/3.2/core/macro-resolution-result.json +10 -10
  372. package/dist/lib/schemas-data/3.2/core/macro-translation-target.json +7 -7
  373. package/dist/lib/schemas-data/3.2/core/material-deadline.json +1 -1
  374. package/dist/lib/schemas-data/3.2/core/mcp-webhook-payload.json +6 -6
  375. package/dist/lib/schemas-data/3.2/core/measurement-readiness.json +5 -5
  376. package/dist/lib/schemas-data/3.2/core/measurement-terms.json +3 -3
  377. package/dist/lib/schemas-data/3.2/core/measurement-window.json +1 -1
  378. package/dist/lib/schemas-data/3.2/core/media-buy-available-action-id.json +2 -2
  379. package/dist/lib/schemas-data/3.2/core/media-buy-available-action.json +7 -7
  380. package/dist/lib/schemas-data/3.2/core/media-buy-change-term-id.json +1 -1
  381. package/dist/lib/schemas-data/3.2/core/media-buy-features.json +2 -2
  382. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap-capability.json +3 -3
  383. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap-requirement.json +3 -3
  384. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap-support.json +3 -3
  385. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap.json +2 -2
  386. package/dist/lib/schemas-data/3.2/core/media-buy-legacy-terms-ref.json +1 -1
  387. package/dist/lib/schemas-data/3.2/core/media-buy-support-requirements.json +2 -2
  388. package/dist/lib/schemas-data/3.2/core/media-buy-support.json +3 -3
  389. package/dist/lib/schemas-data/3.2/core/media-buy.json +14 -14
  390. package/dist/lib/schemas-data/3.2/core/missing-metric.json +14 -14
  391. package/dist/lib/schemas-data/3.2/core/negative-keyword.json +2 -2
  392. package/dist/lib/schemas-data/3.2/core/notification-config.json +3 -3
  393. package/dist/lib/schemas-data/3.2/core/offering-asset-group.json +16 -16
  394. package/dist/lib/schemas-data/3.2/core/offering.json +5 -5
  395. package/dist/lib/schemas-data/3.2/core/operator-identity.json +2 -2
  396. package/dist/lib/schemas-data/3.2/core/operator-unit.json +1 -1
  397. package/dist/lib/schemas-data/3.2/core/opportunity-context.json +3 -3
  398. package/dist/lib/schemas-data/3.2/core/optimization-goal.json +9 -9
  399. package/dist/lib/schemas-data/3.2/core/outcome-measurement.json +2 -2
  400. package/dist/lib/schemas-data/3.2/core/outcome-target-cost-per.json +2 -2
  401. package/dist/lib/schemas-data/3.2/core/overlay.json +1 -1
  402. package/dist/lib/schemas-data/3.2/core/package-delivery-metric-value.json +2 -2
  403. package/dist/lib/schemas-data/3.2/core/package-format-snapshot.json +5 -5
  404. package/dist/lib/schemas-data/3.2/core/package-signal-targeting-group.json +2 -2
  405. package/dist/lib/schemas-data/3.2/core/package-signal-targeting-groups.json +2 -2
  406. package/dist/lib/schemas-data/3.2/core/package-signal-targeting.json +3 -3
  407. package/dist/lib/schemas-data/3.2/core/package-targeting-resolution.json +3 -3
  408. package/dist/lib/schemas-data/3.2/core/package.json +23 -23
  409. package/dist/lib/schemas-data/3.2/core/pagination-request.json +1 -1
  410. package/dist/lib/schemas-data/3.2/core/pagination-response.json +1 -1
  411. package/dist/lib/schemas-data/3.2/core/performance-feedback-assertion.json +8 -8
  412. package/dist/lib/schemas-data/3.2/core/performance-feedback-metric.json +14 -14
  413. package/dist/lib/schemas-data/3.2/core/performance-feedback.json +17 -17
  414. package/dist/lib/schemas-data/3.2/core/performance-standard.json +4 -4
  415. package/dist/lib/schemas-data/3.2/core/placement-definition.json +15 -15
  416. package/dist/lib/schemas-data/3.2/core/placement-delivery-metrics.json +3 -3
  417. package/dist/lib/schemas-data/3.2/core/placement-evidence.json +1 -1
  418. package/dist/lib/schemas-data/3.2/core/placement-identity.json +2 -2
  419. package/dist/lib/schemas-data/3.2/core/placement-presentation.json +1 -1
  420. package/dist/lib/schemas-data/3.2/core/placement-property-delivery-metrics.json +5 -5
  421. package/dist/lib/schemas-data/3.2/core/placement-ref.json +1 -1
  422. package/dist/lib/schemas-data/3.2/core/placement-selection.json +5 -5
  423. package/dist/lib/schemas-data/3.2/core/placement.json +10 -10
  424. package/dist/lib/schemas-data/3.2/core/planned-delivery.json +8 -8
  425. package/dist/lib/schemas-data/3.2/core/platform-extension-ref.json +1 -1
  426. package/dist/lib/schemas-data/3.2/core/positive-postal-area-support.json +2 -2
  427. package/dist/lib/schemas-data/3.2/core/postal-area-support.json +2 -2
  428. package/dist/lib/schemas-data/3.2/core/postal-area.json +4 -4
  429. package/dist/lib/schemas-data/3.2/core/postal-country-system.json +2 -2
  430. package/dist/lib/schemas-data/3.2/core/presentation-ref.json +1 -1
  431. package/dist/lib/schemas-data/3.2/core/preview-provider.json +1 -1
  432. package/dist/lib/schemas-data/3.2/core/preview-renderer-metadata.json +1 -1
  433. package/dist/lib/schemas-data/3.2/core/price.json +1 -1
  434. package/dist/lib/schemas-data/3.2/core/pricing-option.json +11 -11
  435. package/dist/lib/schemas-data/3.2/core/principal-changed-webhook.json +2 -2
  436. package/dist/lib/schemas-data/3.2/core/principal-declarations-state.json +3 -3
  437. package/dist/lib/schemas-data/3.2/core/principal-declarations.json +2 -2
  438. package/dist/lib/schemas-data/3.2/core/principal-state.json +4 -4
  439. package/dist/lib/schemas-data/3.2/core/product-allocation.json +5 -5
  440. package/dist/lib/schemas-data/3.2/core/product-allowed-action.json +6 -6
  441. package/dist/lib/schemas-data/3.2/core/product-audience-evidence-requirements.json +13 -13
  442. package/dist/lib/schemas-data/3.2/core/product-card-reference-asset.json +5 -5
  443. package/dist/lib/schemas-data/3.2/core/product-change-map.json +1 -1
  444. package/dist/lib/schemas-data/3.2/core/product-execution-requirement.json +7 -7
  445. package/dist/lib/schemas-data/3.2/core/product-filters.json +36 -36
  446. package/dist/lib/schemas-data/3.2/core/product-format-declaration.json +22 -22
  447. package/dist/lib/schemas-data/3.2/core/product-identity.json +1 -1
  448. package/dist/lib/schemas-data/3.2/core/product-offer-filters.json +26 -26
  449. package/dist/lib/schemas-data/3.2/core/product-signal-targeting-option.json +3 -3
  450. package/dist/lib/schemas-data/3.2/core/product-targeting-resolution.json +3 -3
  451. package/dist/lib/schemas-data/3.2/core/product.json +54 -54
  452. package/dist/lib/schemas-data/3.2/core/property-delivery-metrics.json +4 -4
  453. package/dist/lib/schemas-data/3.2/core/property-id.json +1 -1
  454. package/dist/lib/schemas-data/3.2/core/property-list-ref.json +1 -1
  455. package/dist/lib/schemas-data/3.2/core/property-ref.json +2 -2
  456. package/dist/lib/schemas-data/3.2/core/property-tag.json +1 -1
  457. package/dist/lib/schemas-data/3.2/core/property.json +6 -6
  458. package/dist/lib/schemas-data/3.2/core/proposal.json +9 -9
  459. package/dist/lib/schemas-data/3.2/core/protocol-envelope.json +5 -5
  460. package/dist/lib/schemas-data/3.2/core/provenance.json +9 -9
  461. package/dist/lib/schemas-data/3.2/core/publisher-property-selector.json +3 -3
  462. package/dist/lib/schemas-data/3.2/core/push-notification-config.json +2 -2
  463. package/dist/lib/schemas-data/3.2/core/real-estate-item.json +4 -4
  464. package/dist/lib/schemas-data/3.2/core/reference-asset.json +1 -1
  465. package/dist/lib/schemas-data/3.2/core/reference-renderer.json +1 -1
  466. package/dist/lib/schemas-data/3.2/core/registry-event.json +15 -15
  467. package/dist/lib/schemas-data/3.2/core/registry-feed-response.json +2 -2
  468. package/dist/lib/schemas-data/3.2/core/reporting-adjustment-receipt.json +1 -1
  469. package/dist/lib/schemas-data/3.2/core/reporting-adjustment.json +2 -2
  470. package/dist/lib/schemas-data/3.2/core/reporting-canonical-content-digest.json +1 -1
  471. package/dist/lib/schemas-data/3.2/core/reporting-canonicalization-contract.json +1 -1
  472. package/dist/lib/schemas-data/3.2/core/reporting-capabilities.json +12 -12
  473. package/dist/lib/schemas-data/3.2/core/reporting-consumer-status.json +1 -1
  474. package/dist/lib/schemas-data/3.2/core/reporting-control-total.json +1 -1
  475. package/dist/lib/schemas-data/3.2/core/reporting-coverage.json +1 -1
  476. package/dist/lib/schemas-data/3.2/core/reporting-dataset-share-destination.json +1 -1
  477. package/dist/lib/schemas-data/3.2/core/reporting-delivery-capabilities.json +3 -3
  478. package/dist/lib/schemas-data/3.2/core/reporting-delivery-config-state.json +4 -4
  479. package/dist/lib/schemas-data/3.2/core/reporting-delivery-config.json +7 -7
  480. package/dist/lib/schemas-data/3.2/core/reporting-delivery-method.json +4 -4
  481. package/dist/lib/schemas-data/3.2/core/reporting-delivery-offering-id.json +1 -1
  482. package/dist/lib/schemas-data/3.2/core/reporting-delivery-offering.json +8 -8
  483. package/dist/lib/schemas-data/3.2/core/reporting-delivery-ready-webhook.json +3 -3
  484. package/dist/lib/schemas-data/3.2/core/reporting-file-compression.json +1 -1
  485. package/dist/lib/schemas-data/3.2/core/reporting-file-entry.json +3 -3
  486. package/dist/lib/schemas-data/3.2/core/reporting-file-manifest.json +4 -4
  487. package/dist/lib/schemas-data/3.2/core/reporting-file-object-ref.json +1 -1
  488. package/dist/lib/schemas-data/3.2/core/reporting-ledger-changed-webhook.json +3 -3
  489. package/dist/lib/schemas-data/3.2/core/reporting-materialization.json +4 -4
  490. package/dist/lib/schemas-data/3.2/core/reporting-native-version-ref.json +1 -1
  491. package/dist/lib/schemas-data/3.2/core/reporting-obligation.json +9 -9
  492. package/dist/lib/schemas-data/3.2/core/reporting-receipt.json +5 -5
  493. package/dist/lib/schemas-data/3.2/core/reporting-reconciliation-mode.json +1 -1
  494. package/dist/lib/schemas-data/3.2/core/reporting-reliability-statistics.json +1 -1
  495. package/dist/lib/schemas-data/3.2/core/reporting-report-definition.json +1 -1
  496. package/dist/lib/schemas-data/3.2/core/reporting-resource.json +2 -2
  497. package/dist/lib/schemas-data/3.2/core/reporting-revision.json +6 -6
  498. package/dist/lib/schemas-data/3.2/core/reporting-schedule-offering.json +2 -2
  499. package/dist/lib/schemas-data/3.2/core/reporting-schedule.json +1 -1
  500. package/dist/lib/schemas-data/3.2/core/reporting-status-changed-webhook.json +5 -5
  501. package/dist/lib/schemas-data/3.2/core/reporting-status-issue.json +4 -4
  502. package/dist/lib/schemas-data/3.2/core/reporting-verification-profile-set.json +1 -1
  503. package/dist/lib/schemas-data/3.2/core/reporting-verification-profile.json +1 -1
  504. package/dist/lib/schemas-data/3.2/core/reporting-verification.json +7 -7
  505. package/dist/lib/schemas-data/3.2/core/reporting-webhook.json +3 -3
  506. package/dist/lib/schemas-data/3.2/core/reporting-write-destination.json +1 -1
  507. package/dist/lib/schemas-data/3.2/core/representation-destination.json +5 -5
  508. package/dist/lib/schemas-data/3.2/core/representation-rejection.json +1 -1
  509. package/dist/lib/schemas-data/3.2/core/representation-selection.json +5 -5
  510. package/dist/lib/schemas-data/3.2/core/requirements/asset-requirements.json +13 -13
  511. package/dist/lib/schemas-data/3.2/core/requirements/audio-asset-requirements.json +1 -1
  512. package/dist/lib/schemas-data/3.2/core/requirements/catalog-field-binding.json +4 -4
  513. package/dist/lib/schemas-data/3.2/core/requirements/catalog-requirements.json +5 -5
  514. package/dist/lib/schemas-data/3.2/core/requirements/css-asset-requirements.json +1 -1
  515. package/dist/lib/schemas-data/3.2/core/requirements/daast-asset-requirements.json +3 -3
  516. package/dist/lib/schemas-data/3.2/core/requirements/html-asset-requirements.json +1 -1
  517. package/dist/lib/schemas-data/3.2/core/requirements/image-asset-requirements.json +2 -2
  518. package/dist/lib/schemas-data/3.2/core/requirements/javascript-asset-requirements.json +1 -1
  519. package/dist/lib/schemas-data/3.2/core/requirements/markdown-asset-requirements.json +1 -1
  520. package/dist/lib/schemas-data/3.2/core/requirements/offering-asset-constraint.json +4 -4
  521. package/dist/lib/schemas-data/3.2/core/requirements/text-asset-requirements.json +1 -1
  522. package/dist/lib/schemas-data/3.2/core/requirements/url-asset-requirements.json +1 -1
  523. package/dist/lib/schemas-data/3.2/core/requirements/vast-asset-requirements.json +4 -4
  524. package/dist/lib/schemas-data/3.2/core/requirements/video-asset-requirements.json +6 -6
  525. package/dist/lib/schemas-data/3.2/core/requirements/webhook-asset-requirements.json +1 -1
  526. package/dist/lib/schemas-data/3.2/core/response-payload-jws-envelope.json +1 -1
  527. package/dist/lib/schemas-data/3.2/core/response.json +1 -1
  528. package/dist/lib/schemas-data/3.2/core/rights-attestation-evaluation.json +5 -5
  529. package/dist/lib/schemas-data/3.2/core/rights-constraint.json +7 -7
  530. package/dist/lib/schemas-data/3.2/core/seller-agent-ref.json +1 -1
  531. package/dist/lib/schemas-data/3.2/core/signal-coverage-forecast.json +5 -5
  532. package/dist/lib/schemas-data/3.2/core/signal-definition-enrichment.json +5 -5
  533. package/dist/lib/schemas-data/3.2/core/signal-definition.json +8 -8
  534. package/dist/lib/schemas-data/3.2/core/signal-filters.json +3 -3
  535. package/dist/lib/schemas-data/3.2/core/signal-id.json +1 -1
  536. package/dist/lib/schemas-data/3.2/core/signal-listing.json +6 -6
  537. package/dist/lib/schemas-data/3.2/core/signal-modeling-disclosure.json +1 -1
  538. package/dist/lib/schemas-data/3.2/core/signal-pricing-option.json +2 -2
  539. package/dist/lib/schemas-data/3.2/core/signal-pricing.json +6 -6
  540. package/dist/lib/schemas-data/3.2/core/signal-ref.json +1 -1
  541. package/dist/lib/schemas-data/3.2/core/signal-selection-group-rule.json +1 -1
  542. package/dist/lib/schemas-data/3.2/core/signal-targeting-expression.json +4 -4
  543. package/dist/lib/schemas-data/3.2/core/signal-targeting-rules.json +2 -2
  544. package/dist/lib/schemas-data/3.2/core/signal-targeting.json +7 -7
  545. package/dist/lib/schemas-data/3.2/core/sla-window.json +1 -1
  546. package/dist/lib/schemas-data/3.2/core/special.json +2 -2
  547. package/dist/lib/schemas-data/3.2/core/spot-reporting-capability.json +2 -2
  548. package/dist/lib/schemas-data/3.2/core/start-timing.json +1 -1
  549. package/dist/lib/schemas-data/3.2/core/store-item.json +3 -3
  550. package/dist/lib/schemas-data/3.2/core/talent.json +2 -2
  551. package/dist/lib/schemas-data/3.2/core/targeting-input.json +40 -40
  552. package/dist/lib/schemas-data/3.2/core/targeting-modification.json +3 -3
  553. package/dist/lib/schemas-data/3.2/core/targeting-overlay-requirements.json +15 -15
  554. package/dist/lib/schemas-data/3.2/core/targeting-overlay-support.json +25 -25
  555. package/dist/lib/schemas-data/3.2/core/targeting-unknown-age-eligibility-constraint.json +1 -1
  556. package/dist/lib/schemas-data/3.2/core/targeting-verified-age-basis-constraint.json +1 -1
  557. package/dist/lib/schemas-data/3.2/core/targeting.json +34 -34
  558. package/dist/lib/schemas-data/3.2/core/tasks-get-request.json +5 -5
  559. package/dist/lib/schemas-data/3.2/core/tasks-get-response.json +10 -10
  560. package/dist/lib/schemas-data/3.2/core/tasks-list-request.json +13 -13
  561. package/dist/lib/schemas-data/3.2/core/tasks-list-response.json +8 -8
  562. package/dist/lib/schemas-data/3.2/core/tracker-execution-contract.json +2 -2
  563. package/dist/lib/schemas-data/3.2/core/tracker-execution-selector.json +18 -18
  564. package/dist/lib/schemas-data/3.2/core/transformer-param.json +1 -1
  565. package/dist/lib/schemas-data/3.2/core/transformer.json +6 -6
  566. package/dist/lib/schemas-data/3.2/core/truncation-sentinel.json +1 -1
  567. package/dist/lib/schemas-data/3.2/core/user-match.json +3 -3
  568. package/dist/lib/schemas-data/3.2/core/vast-media-file-requirements.json +2 -2
  569. package/dist/lib/schemas-data/3.2/core/vast-tracker-constraints.json +2 -2
  570. package/dist/lib/schemas-data/3.2/core/vehicle-item.json +4 -4
  571. package/dist/lib/schemas-data/3.2/core/vendor-metric-id.json +1 -1
  572. package/dist/lib/schemas-data/3.2/core/vendor-metric-optimization-supported-metric.json +3 -3
  573. package/dist/lib/schemas-data/3.2/core/vendor-metric-optimization.json +2 -2
  574. package/dist/lib/schemas-data/3.2/core/vendor-metric-value.json +9 -9
  575. package/dist/lib/schemas-data/3.2/core/vendor-pricing-option.json +3 -3
  576. package/dist/lib/schemas-data/3.2/core/verification-token-claims.json +1 -1
  577. package/dist/lib/schemas-data/3.2/core/version-envelope.json +1 -1
  578. package/dist/lib/schemas-data/3.2/core/warning-resource.json +1 -1
  579. package/dist/lib/schemas-data/3.2/core/warning.json +4 -4
  580. package/dist/lib/schemas-data/3.2/core/webhook-activity-record.json +3 -3
  581. package/dist/lib/schemas-data/3.2/core/webhook-challenge-response.json +1 -1
  582. package/dist/lib/schemas-data/3.2/core/webhook-challenge.json +2 -2
  583. package/dist/lib/schemas-data/3.2/core/wholesale-feed-event.json +20 -20
  584. package/dist/lib/schemas-data/3.2/core/wholesale-feed-webhook.json +3 -3
  585. package/dist/lib/schemas-data/3.2/core/x-entity-types.json +1 -1
  586. package/dist/lib/schemas-data/3.2/creative/asset-types/index.json +6 -6
  587. package/dist/lib/schemas-data/3.2/creative/audit-observation.json +2 -2
  588. package/dist/lib/schemas-data/3.2/creative/creative-assignment-changed-webhook.json +2 -2
  589. package/dist/lib/schemas-data/3.2/creative/creative-feature-result.json +2 -2
  590. package/dist/lib/schemas-data/3.2/creative/creative-purged-webhook.json +3 -3
  591. package/dist/lib/schemas-data/3.2/creative/creative-status-changed-webhook.json +5 -5
  592. package/dist/lib/schemas-data/3.2/creative/get-creative-delivery-request.json +6 -6
  593. package/dist/lib/schemas-data/3.2/creative/get-creative-delivery-response.json +11 -11
  594. package/dist/lib/schemas-data/3.2/creative/get-creative-features-async-response-submitted.json +3 -3
  595. package/dist/lib/schemas-data/3.2/creative/get-creative-features-request.json +7 -7
  596. package/dist/lib/schemas-data/3.2/creative/get-creative-features-response.json +9 -9
  597. package/dist/lib/schemas-data/3.2/creative/get-creative-features-terminal-success.json +6 -6
  598. package/dist/lib/schemas-data/3.2/creative/list-creative-formats-request.json +13 -13
  599. package/dist/lib/schemas-data/3.2/creative/list-creative-formats-response.json +9 -9
  600. package/dist/lib/schemas-data/3.2/creative/list-creatives-request.json +9 -9
  601. package/dist/lib/schemas-data/3.2/creative/list-creatives-response.json +34 -34
  602. package/dist/lib/schemas-data/3.2/creative/list-transformers-request.json +9 -9
  603. package/dist/lib/schemas-data/3.2/creative/list-transformers-response.json +8 -8
  604. package/dist/lib/schemas-data/3.2/creative/preview-creative-request.json +13 -13
  605. package/dist/lib/schemas-data/3.2/creative/preview-creative-response.json +18 -18
  606. package/dist/lib/schemas-data/3.2/creative/preview-render.json +4 -4
  607. package/dist/lib/schemas-data/3.2/creative/sync-creatives-async-response-input-required.json +3 -3
  608. package/dist/lib/schemas-data/3.2/creative/sync-creatives-async-response-submitted.json +4 -4
  609. package/dist/lib/schemas-data/3.2/creative/sync-creatives-async-response-working.json +3 -3
  610. package/dist/lib/schemas-data/3.2/creative/sync-creatives-request.json +10 -10
  611. package/dist/lib/schemas-data/3.2/creative/sync-creatives-response.json +18 -18
  612. package/dist/lib/schemas-data/3.2/creative/validate-input-request.json +4 -4
  613. package/dist/lib/schemas-data/3.2/creative/validate-input-response.json +4 -4
  614. package/dist/lib/schemas-data/3.2/creative/validate-input-result.json +2 -2
  615. package/dist/lib/schemas-data/3.2/creative/video-brief.json +1 -1
  616. package/dist/lib/schemas-data/3.2/enums/account-currency-mode.json +1 -1
  617. package/dist/lib/schemas-data/3.2/enums/account-scope.json +1 -1
  618. package/dist/lib/schemas-data/3.2/enums/account-status.json +1 -1
  619. package/dist/lib/schemas-data/3.2/enums/action-not-allowed-reason.json +1 -1
  620. package/dist/lib/schemas-data/3.2/enums/action-source.json +1 -1
  621. package/dist/lib/schemas-data/3.2/enums/activation-method.json +1 -1
  622. package/dist/lib/schemas-data/3.2/enums/adcp-protocol.json +1 -1
  623. package/dist/lib/schemas-data/3.2/enums/adjustment-kind.json +1 -1
  624. package/dist/lib/schemas-data/3.2/enums/advertiser-industry.json +1 -1
  625. package/dist/lib/schemas-data/3.2/enums/age-determination-basis.json +1 -1
  626. package/dist/lib/schemas-data/3.2/enums/age-verification-method.json +1 -1
  627. package/dist/lib/schemas-data/3.2/enums/assessment-status.json +1 -1
  628. package/dist/lib/schemas-data/3.2/enums/asset-content-type.json +1 -1
  629. package/dist/lib/schemas-data/3.2/enums/attestation-claim.json +1 -1
  630. package/dist/lib/schemas-data/3.2/enums/attribution-methodology.json +1 -1
  631. package/dist/lib/schemas-data/3.2/enums/attribution-model.json +1 -1
  632. package/dist/lib/schemas-data/3.2/enums/audience-evidence-methodology.json +1 -1
  633. package/dist/lib/schemas-data/3.2/enums/audience-resolution-method.json +1 -1
  634. package/dist/lib/schemas-data/3.2/enums/audience-source.json +1 -1
  635. package/dist/lib/schemas-data/3.2/enums/audience-status.json +1 -1
  636. package/dist/lib/schemas-data/3.2/enums/audience-subject-type.json +1 -1
  637. package/dist/lib/schemas-data/3.2/enums/audio-channel-layout.json +1 -1
  638. package/dist/lib/schemas-data/3.2/enums/audio-distribution-type.json +1 -1
  639. package/dist/lib/schemas-data/3.2/enums/auth-scheme.json +1 -1
  640. package/dist/lib/schemas-data/3.2/enums/availability-status.json +1 -1
  641. package/dist/lib/schemas-data/3.2/enums/available-metric.json +1 -1
  642. package/dist/lib/schemas-data/3.2/enums/billing-party.json +1 -1
  643. package/dist/lib/schemas-data/3.2/enums/binary-verdict.json +1 -1
  644. package/dist/lib/schemas-data/3.2/enums/brand-agent-type.json +1 -1
  645. package/dist/lib/schemas-data/3.2/enums/browser-family.json +1 -1
  646. package/dist/lib/schemas-data/3.2/enums/c2pa-watermark-action.json +1 -1
  647. package/dist/lib/schemas-data/3.2/enums/canceled-by.json +1 -1
  648. package/dist/lib/schemas-data/3.2/enums/canonical-media-buy-action-mode.json +1 -1
  649. package/dist/lib/schemas-data/3.2/enums/canonical-media-buy-action.json +1 -1
  650. package/dist/lib/schemas-data/3.2/enums/catalog-action.json +1 -1
  651. package/dist/lib/schemas-data/3.2/enums/catalog-item-status.json +1 -1
  652. package/dist/lib/schemas-data/3.2/enums/catalog-type.json +1 -1
  653. package/dist/lib/schemas-data/3.2/enums/channels.json +1 -1
  654. package/dist/lib/schemas-data/3.2/enums/cloud-storage-protocol.json +1 -1
  655. package/dist/lib/schemas-data/3.2/enums/co-branding-requirement.json +1 -1
  656. package/dist/lib/schemas-data/3.2/enums/collection-cadence.json +1 -1
  657. package/dist/lib/schemas-data/3.2/enums/collection-kind.json +1 -1
  658. package/dist/lib/schemas-data/3.2/enums/collection-relationship.json +1 -1
  659. package/dist/lib/schemas-data/3.2/enums/collection-status.json +1 -1
  660. package/dist/lib/schemas-data/3.2/enums/completion-source.json +1 -1
  661. package/dist/lib/schemas-data/3.2/enums/consent-basis.json +1 -1
  662. package/dist/lib/schemas-data/3.2/enums/content-id-type.json +1 -1
  663. package/dist/lib/schemas-data/3.2/enums/content-rating-system.json +1 -1
  664. package/dist/lib/schemas-data/3.2/enums/creative-action.json +1 -1
  665. package/dist/lib/schemas-data/3.2/enums/creative-agent-capability.json +1 -1
  666. package/dist/lib/schemas-data/3.2/enums/creative-approval-status.json +1 -1
  667. package/dist/lib/schemas-data/3.2/enums/creative-event-reason-code.json +1 -1
  668. package/dist/lib/schemas-data/3.2/enums/creative-identifier-type.json +1 -1
  669. package/dist/lib/schemas-data/3.2/enums/creative-quality.json +1 -1
  670. package/dist/lib/schemas-data/3.2/enums/creative-selection-strategy.json +1 -1
  671. package/dist/lib/schemas-data/3.2/enums/creative-sort-field.json +1 -1
  672. package/dist/lib/schemas-data/3.2/enums/creative-status.json +1 -1
  673. package/dist/lib/schemas-data/3.2/enums/ctv-ad-experience.json +1 -1
  674. package/dist/lib/schemas-data/3.2/enums/daast-tracking-event.json +1 -1
  675. package/dist/lib/schemas-data/3.2/enums/daast-version.json +1 -1
  676. package/dist/lib/schemas-data/3.2/enums/day-of-week.json +1 -1
  677. package/dist/lib/schemas-data/3.2/enums/daypart-timezone-mode.json +1 -1
  678. package/dist/lib/schemas-data/3.2/enums/delegation-authority.json +1 -1
  679. package/dist/lib/schemas-data/3.2/enums/delivery-recipient-cloud.json +1 -1
  680. package/dist/lib/schemas-data/3.2/enums/delivery-status.json +1 -1
  681. package/dist/lib/schemas-data/3.2/enums/delivery-type.json +1 -1
  682. package/dist/lib/schemas-data/3.2/enums/demographic-system.json +1 -1
  683. package/dist/lib/schemas-data/3.2/enums/derivative-type.json +1 -1
  684. package/dist/lib/schemas-data/3.2/enums/device-platform.json +1 -1
  685. package/dist/lib/schemas-data/3.2/enums/device-type.json +1 -1
  686. package/dist/lib/schemas-data/3.2/enums/digital-source-type.json +1 -1
  687. package/dist/lib/schemas-data/3.2/enums/dimension-unit.json +1 -1
  688. package/dist/lib/schemas-data/3.2/enums/disclosure-persistence.json +1 -1
  689. package/dist/lib/schemas-data/3.2/enums/disclosure-position.json +1 -1
  690. package/dist/lib/schemas-data/3.2/enums/distance-unit.json +1 -1
  691. package/dist/lib/schemas-data/3.2/enums/distribution-identifier-type.json +1 -1
  692. package/dist/lib/schemas-data/3.2/enums/dooh-motion-type.json +1 -1
  693. package/dist/lib/schemas-data/3.2/enums/embedded-provenance-method.json +1 -1
  694. package/dist/lib/schemas-data/3.2/enums/error-code.json +1 -1
  695. package/dist/lib/schemas-data/3.2/enums/error-scope.json +1 -1
  696. package/dist/lib/schemas-data/3.2/enums/escalation-severity.json +1 -1
  697. package/dist/lib/schemas-data/3.2/enums/event-type.json +1 -1
  698. package/dist/lib/schemas-data/3.2/enums/exclusivity.json +1 -1
  699. package/dist/lib/schemas-data/3.2/enums/feature-check-status.json +1 -1
  700. package/dist/lib/schemas-data/3.2/enums/feed-format.json +1 -1
  701. package/dist/lib/schemas-data/3.2/enums/feedback-source.json +1 -1
  702. package/dist/lib/schemas-data/3.2/enums/forecast-method.json +1 -1
  703. package/dist/lib/schemas-data/3.2/enums/forecast-range-unit.json +1 -1
  704. package/dist/lib/schemas-data/3.2/enums/forecastable-metric.json +1 -1
  705. package/dist/lib/schemas-data/3.2/enums/format-id-parameter.json +1 -1
  706. package/dist/lib/schemas-data/3.2/enums/frame-rate-type.json +1 -1
  707. package/dist/lib/schemas-data/3.2/enums/frequency-cap-control-mode.json +1 -1
  708. package/dist/lib/schemas-data/3.2/enums/frequency-cap-mutable-field.json +1 -1
  709. package/dist/lib/schemas-data/3.2/enums/frequency-cap-scope.json +1 -1
  710. package/dist/lib/schemas-data/3.2/enums/genre-taxonomy.json +1 -1
  711. package/dist/lib/schemas-data/3.2/enums/geo-level.json +1 -1
  712. package/dist/lib/schemas-data/3.2/enums/gop-type.json +1 -1
  713. package/dist/lib/schemas-data/3.2/enums/governance-decision.json +1 -1
  714. package/dist/lib/schemas-data/3.2/enums/governance-domain.json +1 -1
  715. package/dist/lib/schemas-data/3.2/enums/governance-mode.json +1 -1
  716. package/dist/lib/schemas-data/3.2/enums/governance-phase.json +1 -1
  717. package/dist/lib/schemas-data/3.2/enums/history-entry-type.json +1 -1
  718. package/dist/lib/schemas-data/3.2/enums/http-method.json +1 -1
  719. package/dist/lib/schemas-data/3.2/enums/identifier-types.json +1 -1
  720. package/dist/lib/schemas-data/3.2/enums/impairment-offline-state.json +1 -1
  721. package/dist/lib/schemas-data/3.2/enums/impairment-reason-code.json +1 -1
  722. package/dist/lib/schemas-data/3.2/enums/indicator-type.json +1 -1
  723. package/dist/lib/schemas-data/3.2/enums/installment-status.json +1 -1
  724. package/dist/lib/schemas-data/3.2/enums/javascript-module-type.json +1 -1
  725. package/dist/lib/schemas-data/3.2/enums/landing-page-requirement.json +1 -1
  726. package/dist/lib/schemas-data/3.2/enums/legacy-postal-system.json +1 -1
  727. package/dist/lib/schemas-data/3.2/enums/lift-dimension.json +1 -1
  728. package/dist/lib/schemas-data/3.2/enums/logo-slot.json +1 -1
  729. package/dist/lib/schemas-data/3.2/enums/macro-dialect.json +1 -1
  730. package/dist/lib/schemas-data/3.2/enums/macro-mapping-status.json +1 -1
  731. package/dist/lib/schemas-data/3.2/enums/macro-processing-operation.json +1 -1
  732. package/dist/lib/schemas-data/3.2/enums/macro-resolution-reason.json +1 -1
  733. package/dist/lib/schemas-data/3.2/enums/macro-resolver.json +1 -1
  734. package/dist/lib/schemas-data/3.2/enums/macro-value-context.json +1 -1
  735. package/dist/lib/schemas-data/3.2/enums/makegood-remedy.json +1 -1
  736. package/dist/lib/schemas-data/3.2/enums/markdown-flavor.json +1 -1
  737. package/dist/lib/schemas-data/3.2/enums/match-id-type.json +1 -1
  738. package/dist/lib/schemas-data/3.2/enums/match-type.json +1 -1
  739. package/dist/lib/schemas-data/3.2/enums/media-buy-action-mode.json +1 -1
  740. package/dist/lib/schemas-data/3.2/enums/media-buy-frequency-cap-control-mode.json +1 -1
  741. package/dist/lib/schemas-data/3.2/enums/media-buy-health.json +1 -1
  742. package/dist/lib/schemas-data/3.2/enums/media-buy-status.json +1 -1
  743. package/dist/lib/schemas-data/3.2/enums/media-buy-valid-action.json +1 -1
  744. package/dist/lib/schemas-data/3.2/enums/metric-scope.json +1 -1
  745. package/dist/lib/schemas-data/3.2/enums/metric-type.json +1 -1
  746. package/dist/lib/schemas-data/3.2/enums/metro-system.json +1 -1
  747. package/dist/lib/schemas-data/3.2/enums/moov-atom-position.json +1 -1
  748. package/dist/lib/schemas-data/3.2/enums/motion-level.json +1 -1
  749. package/dist/lib/schemas-data/3.2/enums/notification-type.json +1 -1
  750. package/dist/lib/schemas-data/3.2/enums/offering-availability-status.json +1 -1
  751. package/dist/lib/schemas-data/3.2/enums/outcome-target-cost-strength.json +1 -1
  752. package/dist/lib/schemas-data/3.2/enums/outcome-type.json +1 -1
  753. package/dist/lib/schemas-data/3.2/enums/pacing.json +1 -1
  754. package/dist/lib/schemas-data/3.2/enums/payment-terms.json +1 -1
  755. package/dist/lib/schemas-data/3.2/enums/performance-baseline.json +1 -1
  756. package/dist/lib/schemas-data/3.2/enums/performance-standard-metric.json +1 -1
  757. package/dist/lib/schemas-data/3.2/enums/pixel-tracking-event.json +1 -1
  758. package/dist/lib/schemas-data/3.2/enums/policy-category.json +1 -1
  759. package/dist/lib/schemas-data/3.2/enums/policy-enforcement.json +1 -1
  760. package/dist/lib/schemas-data/3.2/enums/postal-system.json +1 -1
  761. package/dist/lib/schemas-data/3.2/enums/preview-output-format.json +1 -1
  762. package/dist/lib/schemas-data/3.2/enums/pricing-model.json +1 -1
  763. package/dist/lib/schemas-data/3.2/enums/pricing-structure.json +1 -1
  764. package/dist/lib/schemas-data/3.2/enums/principal-kind.json +1 -1
  765. package/dist/lib/schemas-data/3.2/enums/production-quality.json +1 -1
  766. package/dist/lib/schemas-data/3.2/enums/property-type.json +1 -1
  767. package/dist/lib/schemas-data/3.2/enums/proposal-decline-reason.json +1 -1
  768. package/dist/lib/schemas-data/3.2/enums/proposal-refinement-reason.json +1 -1
  769. package/dist/lib/schemas-data/3.2/enums/proposal-status.json +1 -1
  770. package/dist/lib/schemas-data/3.2/enums/publisher-identifier-types.json +1 -1
  771. package/dist/lib/schemas-data/3.2/enums/purchase-type.json +1 -1
  772. package/dist/lib/schemas-data/3.2/enums/reach-aggregation.json +1 -1
  773. package/dist/lib/schemas-data/3.2/enums/reach-unit.json +1 -1
  774. package/dist/lib/schemas-data/3.2/enums/reporting-destination-setup-state.json +1 -1
  775. package/dist/lib/schemas-data/3.2/enums/reporting-finality.json +1 -1
  776. package/dist/lib/schemas-data/3.2/enums/reporting-frequency.json +1 -1
  777. package/dist/lib/schemas-data/3.2/enums/reporting-health.json +1 -1
  778. package/dist/lib/schemas-data/3.2/enums/representation-selection-strategy.json +1 -1
  779. package/dist/lib/schemas-data/3.2/enums/request-signing-error-code.json +1 -1
  780. package/dist/lib/schemas-data/3.2/enums/response-type.json +1 -1
  781. package/dist/lib/schemas-data/3.2/enums/restricted-attribute.json +1 -1
  782. package/dist/lib/schemas-data/3.2/enums/right-type.json +1 -1
  783. package/dist/lib/schemas-data/3.2/enums/right-use.json +1 -1
  784. package/dist/lib/schemas-data/3.2/enums/rights-billing-period.json +1 -1
  785. package/dist/lib/schemas-data/3.2/enums/scan-type.json +1 -1
  786. package/dist/lib/schemas-data/3.2/enums/seller-policy-decline-reason.json +1 -1
  787. package/dist/lib/schemas-data/3.2/enums/si-session-status.json +1 -1
  788. package/dist/lib/schemas-data/3.2/enums/signal-catalog-type.json +1 -1
  789. package/dist/lib/schemas-data/3.2/enums/signal-source.json +1 -1
  790. package/dist/lib/schemas-data/3.2/enums/signal-value-type.json +1 -1
  791. package/dist/lib/schemas-data/3.2/enums/snapshot-unavailable-reason.json +1 -1
  792. package/dist/lib/schemas-data/3.2/enums/social-placement-surface.json +1 -1
  793. package/dist/lib/schemas-data/3.2/enums/sort-direction.json +1 -1
  794. package/dist/lib/schemas-data/3.2/enums/sort-metric.json +1 -1
  795. package/dist/lib/schemas-data/3.2/enums/special-category.json +1 -1
  796. package/dist/lib/schemas-data/3.2/enums/specialism.json +1 -1
  797. package/dist/lib/schemas-data/3.2/enums/sponsored-placement-type.json +1 -1
  798. package/dist/lib/schemas-data/3.2/enums/talent-role.json +1 -1
  799. package/dist/lib/schemas-data/3.2/enums/task-status.json +1 -1
  800. package/dist/lib/schemas-data/3.2/enums/task-type.json +1 -1
  801. package/dist/lib/schemas-data/3.2/enums/tracker-execution-actor.json +1 -1
  802. package/dist/lib/schemas-data/3.2/enums/tracker-firing-path.json +1 -1
  803. package/dist/lib/schemas-data/3.2/enums/transport-mode.json +1 -1
  804. package/dist/lib/schemas-data/3.2/enums/travel-time-unit.json +1 -1
  805. package/dist/lib/schemas-data/3.2/enums/uid-type.json +1 -1
  806. package/dist/lib/schemas-data/3.2/enums/universal-macro.json +1 -1
  807. package/dist/lib/schemas-data/3.2/enums/update-frequency.json +1 -1
  808. package/dist/lib/schemas-data/3.2/enums/url-asset-type.json +1 -1
  809. package/dist/lib/schemas-data/3.2/enums/validation-mode.json +1 -1
  810. package/dist/lib/schemas-data/3.2/enums/vast-media-delivery-method.json +1 -1
  811. package/dist/lib/schemas-data/3.2/enums/vast-tracking-event.json +1 -1
  812. package/dist/lib/schemas-data/3.2/enums/vast-version.json +1 -1
  813. package/dist/lib/schemas-data/3.2/enums/vendor-relationship.json +1 -1
  814. package/dist/lib/schemas-data/3.2/enums/video-placement-type.json +1 -1
  815. package/dist/lib/schemas-data/3.2/enums/view-threshold-basis.json +1 -1
  816. package/dist/lib/schemas-data/3.2/enums/viewability-standard.json +1 -1
  817. package/dist/lib/schemas-data/3.2/enums/warning-code.json +1 -1
  818. package/dist/lib/schemas-data/3.2/enums/watermark-media-type.json +1 -1
  819. package/dist/lib/schemas-data/3.2/enums/wcag-level.json +1 -1
  820. package/dist/lib/schemas-data/3.2/enums/webhook-response-type.json +1 -1
  821. package/dist/lib/schemas-data/3.2/enums/webhook-security-method.json +1 -1
  822. package/dist/lib/schemas-data/3.2/error-details/accessibility-violation.json +1 -1
  823. package/dist/lib/schemas-data/3.2/error-details/account-moved.json +2 -2
  824. package/dist/lib/schemas-data/3.2/error-details/account-setup-required.json +1 -1
  825. package/dist/lib/schemas-data/3.2/error-details/action-not-allowed.json +5 -5
  826. package/dist/lib/schemas-data/3.2/error-details/agent-permission-denied.json +1 -1
  827. package/dist/lib/schemas-data/3.2/error-details/audience-too-small.json +1 -1
  828. package/dist/lib/schemas-data/3.2/error-details/authorization-required.json +3 -3
  829. package/dist/lib/schemas-data/3.2/error-details/billing-not-permitted-for-agent.json +3 -3
  830. package/dist/lib/schemas-data/3.2/error-details/billing-not-supported.json +2 -2
  831. package/dist/lib/schemas-data/3.2/error-details/budget-too-low.json +1 -1
  832. package/dist/lib/schemas-data/3.2/error-details/conflict.json +1 -1
  833. package/dist/lib/schemas-data/3.2/error-details/creative-rejected.json +1 -1
  834. package/dist/lib/schemas-data/3.2/error-details/creative-representation-unresolved.json +2 -2
  835. package/dist/lib/schemas-data/3.2/error-details/creative-revision-content-mismatch.json +2 -2
  836. package/dist/lib/schemas-data/3.2/error-details/execution-requirement-unmet.json +2 -2
  837. package/dist/lib/schemas-data/3.2/error-details/governance-agent-not-accepted.json +2 -2
  838. package/dist/lib/schemas-data/3.2/error-details/macro-resolution-failed.json +2 -2
  839. package/dist/lib/schemas-data/3.2/error-details/policy-violation.json +1 -1
  840. package/dist/lib/schemas-data/3.2/error-details/rate-limited.json +1 -1
  841. package/dist/lib/schemas-data/3.2/error-details/requote-required.json +3 -3
  842. package/dist/lib/schemas-data/3.2/error-details/stale-response.json +1 -1
  843. package/dist/lib/schemas-data/3.2/error-details/unsupported-refinement-dimension.json +1 -1
  844. package/dist/lib/schemas-data/3.2/error-details/vast-version-mismatch.json +6 -6
  845. package/dist/lib/schemas-data/3.2/error-details/vendor-error-codes.json +1 -1
  846. package/dist/lib/schemas-data/3.2/error-details/version-unsupported.json +2 -2
  847. package/dist/lib/schemas-data/3.2/extensions/extension-meta.json +1 -1
  848. package/dist/lib/schemas-data/3.2/extensions/index.json +2 -2
  849. package/dist/lib/schemas-data/3.2/formats/canonical/_base.json +5 -5
  850. package/dist/lib/schemas-data/3.2/formats/canonical/agent_placement.json +2 -2
  851. package/dist/lib/schemas-data/3.2/formats/canonical/audio_daast.json +4 -4
  852. package/dist/lib/schemas-data/3.2/formats/canonical/audio_hosted.json +2 -2
  853. package/dist/lib/schemas-data/3.2/formats/canonical/audio_vast.json +5 -5
  854. package/dist/lib/schemas-data/3.2/formats/canonical/coordinated_placements.json +18 -18
  855. package/dist/lib/schemas-data/3.2/formats/canonical/display_tag.json +2 -2
  856. package/dist/lib/schemas-data/3.2/formats/canonical/html5.json +2 -2
  857. package/dist/lib/schemas-data/3.2/formats/canonical/image.json +5 -5
  858. package/dist/lib/schemas-data/3.2/formats/canonical/image_carousel.json +2 -2
  859. package/dist/lib/schemas-data/3.2/formats/canonical/native_in_feed.json +5 -5
  860. package/dist/lib/schemas-data/3.2/formats/canonical/responsive_creative.json +2 -2
  861. package/dist/lib/schemas-data/3.2/formats/canonical/seller_rendered_stateful_display.json +3 -3
  862. package/dist/lib/schemas-data/3.2/formats/canonical/sponsored_placement.json +4 -4
  863. package/dist/lib/schemas-data/3.2/formats/canonical/video_hosted.json +3 -3
  864. package/dist/lib/schemas-data/3.2/formats/canonical/video_vast.json +8 -8
  865. package/dist/lib/schemas-data/3.2/governance/accepted-governance-agents.json +1 -1
  866. package/dist/lib/schemas-data/3.2/governance/attribute-definition.json +1 -1
  867. package/dist/lib/schemas-data/3.2/governance/audience-constraints.json +3 -3
  868. package/dist/lib/schemas-data/3.2/governance/check-governance-request.json +10 -10
  869. package/dist/lib/schemas-data/3.2/governance/check-governance-response.json +8 -8
  870. package/dist/lib/schemas-data/3.2/governance/get-plan-audit-logs-request.json +5 -5
  871. package/dist/lib/schemas-data/3.2/governance/get-plan-audit-logs-response.json +14 -14
  872. package/dist/lib/schemas-data/3.2/governance/policy-category-definition.json +2 -2
  873. package/dist/lib/schemas-data/3.2/governance/policy-entry.json +7 -7
  874. package/dist/lib/schemas-data/3.2/governance/policy-ref.json +1 -1
  875. package/dist/lib/schemas-data/3.2/governance/report-plan-adjustment-request.json +4 -4
  876. package/dist/lib/schemas-data/3.2/governance/report-plan-adjustment-response.json +4 -4
  877. package/dist/lib/schemas-data/3.2/governance/report-plan-outcome-request.json +8 -8
  878. package/dist/lib/schemas-data/3.2/governance/report-plan-outcome-response.json +5 -5
  879. package/dist/lib/schemas-data/3.2/governance/reported-outcome-error.json +1 -1
  880. package/dist/lib/schemas-data/3.2/governance/sync-plans-request.json +14 -14
  881. package/dist/lib/schemas-data/3.2/governance/sync-plans-response.json +6 -6
  882. package/dist/lib/schemas-data/3.2/index.json +639 -639
  883. package/dist/lib/schemas-data/3.2/manifest.json +3 -3
  884. package/dist/lib/schemas-data/3.2/manifest.schema.json +1 -1
  885. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/get-account-financials-request.json +1 -1
  886. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/list-account-changes-request.json +1 -1
  887. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/list-accounts-request.json +1 -1
  888. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/report-usage-request.json +1 -1
  889. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/sync-accounts-request.json +1 -1
  890. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/sync-governance-request.json +1 -1
  891. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/acquire-rights-request.json +1 -1
  892. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/get-brand-identity-request.json +1 -1
  893. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/get-rights-request.json +1 -1
  894. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/search-brands-request.json +1 -1
  895. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/update-rights-request.json +1 -1
  896. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/verify-brand-claim-request.json +1 -1
  897. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/verify-brand-claims-request.json +1 -1
  898. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/create-collection-list-request.json +1 -1
  899. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/delete-collection-list-request.json +1 -1
  900. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/get-collection-list-request.json +1 -1
  901. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/list-collection-lists-request.json +1 -1
  902. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/update-collection-list-request.json +1 -1
  903. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/compliance/comply-test-controller-request.json +1 -1
  904. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/calibrate-content-request.json +1 -1
  905. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/create-content-standards-request.json +1 -1
  906. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/get-content-standards-request.json +1 -1
  907. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/get-media-buy-artifacts-request.json +1 -1
  908. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/list-content-standards-request.json +1 -1
  909. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/update-content-standards-request.json +1 -1
  910. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/validate-content-delivery-request.json +1 -1
  911. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/get-creative-delivery-request.json +1 -1
  912. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/get-creative-features-request.json +1 -1
  913. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/list-creatives-request.json +1 -1
  914. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/list-transformers-request.json +1 -1
  915. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/preview-creative-request.json +1 -1
  916. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/sync-creatives-request.json +1 -1
  917. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/validate-input-request.json +1 -1
  918. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/check-governance-request.json +1 -1
  919. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/get-plan-audit-logs-request.json +1 -1
  920. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/report-plan-adjustment-request.json +1 -1
  921. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/report-plan-outcome-request.json +1 -1
  922. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/sync-plans-request.json +1 -1
  923. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/accept-proposal-request.json +1 -1
  924. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/build-creative-request.json +1 -1
  925. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/buy-products-request.json +1 -1
  926. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/control-media-buy-request.json +1 -1
  927. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/create-media-buy-request.json +1 -1
  928. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/decline-proposals-request.json +1 -1
  929. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-media-buy-delivery-request.json +1 -1
  930. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-media-buys-request.json +1 -1
  931. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-products-request.json +1 -1
  932. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-reporting-status-request.json +1 -1
  933. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/list-creative-formats-request.json +1 -1
  934. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/list-products-request.json +1 -1
  935. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/log-event-request.json +1 -1
  936. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/provide-performance-feedback-request.json +1 -1
  937. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/refine-proposals-request.json +1 -1
  938. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/request-proposals-request.json +1 -1
  939. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-audiences-request.json +1 -1
  940. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-catalogs-request.json +1 -1
  941. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-event-sources-request.json +1 -1
  942. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-reporting-receipts-request.json +1 -1
  943. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-reporting-status-request.json +1 -1
  944. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/update-media-buy-request.json +1 -1
  945. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/get-account-financials-request.json +1 -1
  946. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/list-accounts-request.json +1 -1
  947. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/report-usage-request.json +1 -1
  948. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/sync-accounts-request.json +1 -1
  949. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/sync-governance-request.json +1 -1
  950. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/creative/list-creatives-request.json +1 -1
  951. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/creative/sync-creatives-request.json +1 -1
  952. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/manifest.json +1 -1
  953. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/accept-proposal-request.json +1 -1
  954. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/buy-products-request.json +1 -1
  955. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/control-media-buy-request.json +1 -1
  956. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/decline-proposals-request.json +1 -1
  957. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/get-media-buy-delivery-request.json +1 -1
  958. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/get-media-buys-request.json +1 -1
  959. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/get-reporting-status-request.json +1 -1
  960. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/list-products-request.json +1 -1
  961. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/log-event-request.json +1 -1
  962. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/provide-performance-feedback-request.json +1 -1
  963. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/refine-proposals-request.json +1 -1
  964. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/request-proposals-request.json +1 -1
  965. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-audiences-request.json +1 -1
  966. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-catalogs-request.json +1 -1
  967. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-event-sources-request.json +1 -1
  968. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-reporting-receipts-request.json +1 -1
  969. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-reporting-status-request.json +1 -1
  970. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/get-adcp-capabilities-request.json +1 -1
  971. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/get-principal-request.json +1 -1
  972. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/get-task-status-request.json +1 -1
  973. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/list-tasks-request.json +1 -1
  974. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/sync-principal-request.json +1 -1
  975. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/create-property-list-request.json +1 -1
  976. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/delete-property-list-request.json +1 -1
  977. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/get-property-list-request.json +1 -1
  978. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/list-property-lists-request.json +1 -1
  979. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/update-property-list-request.json +1 -1
  980. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/validate-property-delivery-request.json +1 -1
  981. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/get-adcp-capabilities-request.json +1 -1
  982. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/get-principal-request.json +1 -1
  983. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/get-task-status-request.json +1 -1
  984. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/list-tasks-request.json +1 -1
  985. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/sync-agent-notification-configs-request.json +1 -1
  986. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/sync-principal-request.json +1 -1
  987. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/signals/activate-signal-request.json +1 -1
  988. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/signals/get-signals-request.json +1 -1
  989. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-get-offering-request.json +1 -1
  990. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-initiate-session-request.json +1 -1
  991. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-send-message-request.json +1 -1
  992. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-terminate-session-request.json +1 -1
  993. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-async-response-input-required.json +2 -2
  994. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-async-response-submitted.json +2 -2
  995. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-async-response-working.json +2 -2
  996. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-request.json +11 -11
  997. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-response.json +2 -2
  998. package/dist/lib/schemas-data/3.2/media-buy/acceptance-context.json +3 -3
  999. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-catalog.json +4 -4
  1000. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-profile-ref.json +1 -1
  1001. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-profile.json +3 -3
  1002. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-requirement.json +3 -3
  1003. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-rule.json +3 -3
  1004. package/dist/lib/schemas-data/3.2/media-buy/build-creative-async-response-input-required.json +4 -4
  1005. package/dist/lib/schemas-data/3.2/media-buy/build-creative-async-response-submitted.json +4 -4
  1006. package/dist/lib/schemas-data/3.2/media-buy/build-creative-async-response-working.json +3 -3
  1007. package/dist/lib/schemas-data/3.2/media-buy/build-creative-request.json +19 -19
  1008. package/dist/lib/schemas-data/3.2/media-buy/build-creative-response.json +35 -35
  1009. package/dist/lib/schemas-data/3.2/media-buy/buy-products-async-response-input-required.json +2 -2
  1010. package/dist/lib/schemas-data/3.2/media-buy/buy-products-async-response-submitted.json +2 -2
  1011. package/dist/lib/schemas-data/3.2/media-buy/buy-products-async-response-working.json +2 -2
  1012. package/dist/lib/schemas-data/3.2/media-buy/buy-products-request.json +20 -20
  1013. package/dist/lib/schemas-data/3.2/media-buy/buy-products-response.json +2 -2
  1014. package/dist/lib/schemas-data/3.2/media-buy/change-term-constraints.json +4 -4
  1015. package/dist/lib/schemas-data/3.2/media-buy/change-term.json +6 -6
  1016. package/dist/lib/schemas-data/3.2/media-buy/commercial-terms.json +12 -12
  1017. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-async-response-input-required.json +2 -2
  1018. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-async-response-submitted.json +2 -2
  1019. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-async-response-working.json +2 -2
  1020. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-request.json +15 -15
  1021. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-response.json +37 -19
  1022. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-async-response-input-required.json +4 -4
  1023. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-async-response-submitted.json +4 -4
  1024. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-async-response-working.json +3 -3
  1025. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-request.json +19 -19
  1026. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-response.json +23 -23
  1027. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-async-response-input-required.json +2 -2
  1028. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-async-response-submitted.json +2 -2
  1029. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-async-response-working.json +2 -2
  1030. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-request.json +9 -9
  1031. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-response.json +6 -6
  1032. package/dist/lib/schemas-data/3.2/media-buy/get-media-buy-delivery-request.json +47 -47
  1033. package/dist/lib/schemas-data/3.2/media-buy/get-media-buy-delivery-response.json +81 -81
  1034. package/dist/lib/schemas-data/3.2/media-buy/get-media-buys-request.json +9 -9
  1035. package/dist/lib/schemas-data/3.2/media-buy/get-media-buys-response.json +52 -52
  1036. package/dist/lib/schemas-data/3.2/media-buy/get-products-async-response-input-required.json +4 -4
  1037. package/dist/lib/schemas-data/3.2/media-buy/get-products-async-response-submitted.json +4 -4
  1038. package/dist/lib/schemas-data/3.2/media-buy/get-products-async-response-working.json +3 -3
  1039. package/dist/lib/schemas-data/3.2/media-buy/get-products-rejected.json +5 -5
  1040. package/dist/lib/schemas-data/3.2/media-buy/get-products-request.json +19 -19
  1041. package/dist/lib/schemas-data/3.2/media-buy/get-products-response.json +13 -13
  1042. package/dist/lib/schemas-data/3.2/media-buy/get-products-targeting-resolution.json +3 -3
  1043. package/dist/lib/schemas-data/3.2/media-buy/get-reporting-status-request.json +10 -10
  1044. package/dist/lib/schemas-data/3.2/media-buy/get-reporting-status-response.json +27 -27
  1045. package/dist/lib/schemas-data/3.2/media-buy/legacy-purchase-continuation-input.json +2 -2
  1046. package/dist/lib/schemas-data/3.2/media-buy/list-creative-formats-request.json +14 -14
  1047. package/dist/lib/schemas-data/3.2/media-buy/list-creative-formats-response.json +9 -9
  1048. package/dist/lib/schemas-data/3.2/media-buy/list-products-request.json +11 -11
  1049. package/dist/lib/schemas-data/3.2/media-buy/list-products-response.json +6 -6
  1050. package/dist/lib/schemas-data/3.2/media-buy/log-event-request.json +5 -5
  1051. package/dist/lib/schemas-data/3.2/media-buy/log-event-response.json +8 -8
  1052. package/dist/lib/schemas-data/3.2/media-buy/media-buy-commitment-response.json +38 -20
  1053. package/dist/lib/schemas-data/3.2/media-buy/media-buy-delivery-webhook-result.json +11 -11
  1054. package/dist/lib/schemas-data/3.2/media-buy/outcome-target.json +4 -4
  1055. package/dist/lib/schemas-data/3.2/media-buy/package-control.json +10 -10
  1056. package/dist/lib/schemas-data/3.2/media-buy/package-request.json +31 -31
  1057. package/dist/lib/schemas-data/3.2/media-buy/package-update.json +14 -14
  1058. package/dist/lib/schemas-data/3.2/media-buy/product-discovery-criteria.json +10 -10
  1059. package/dist/lib/schemas-data/3.2/media-buy/product-fields.json +1 -1
  1060. package/dist/lib/schemas-data/3.2/media-buy/product-purchase-input.json +22 -22
  1061. package/dist/lib/schemas-data/3.2/media-buy/product-purchase.json +13 -13
  1062. package/dist/lib/schemas-data/3.2/media-buy/product-refinement.json +1 -1
  1063. package/dist/lib/schemas-data/3.2/media-buy/proposal-budget-constraint.json +1 -1
  1064. package/dist/lib/schemas-data/3.2/media-buy/proposal-decline.json +2 -2
  1065. package/dist/lib/schemas-data/3.2/media-buy/proposal-refinement.json +5 -5
  1066. package/dist/lib/schemas-data/3.2/media-buy/provide-performance-feedback-request.json +5 -5
  1067. package/dist/lib/schemas-data/3.2/media-buy/provide-performance-feedback-response.json +8 -8
  1068. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-async-response-input-required.json +2 -2
  1069. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-async-response-submitted.json +2 -2
  1070. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-async-response-working.json +2 -2
  1071. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-request.json +8 -8
  1072. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-response.json +14 -14
  1073. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-async-response-input-required.json +2 -2
  1074. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-async-response-submitted.json +2 -2
  1075. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-async-response-working.json +2 -2
  1076. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-request.json +11 -11
  1077. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-response.json +21 -11
  1078. package/dist/lib/schemas-data/3.2/media-buy/sync-audiences-request.json +9 -9
  1079. package/dist/lib/schemas-data/3.2/media-buy/sync-audiences-response.json +15 -15
  1080. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-async-response-input-required.json +3 -3
  1081. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-async-response-submitted.json +4 -4
  1082. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-async-response-working.json +3 -3
  1083. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-request.json +10 -10
  1084. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-response.json +20 -20
  1085. package/dist/lib/schemas-data/3.2/media-buy/sync-event-sources-request.json +8 -8
  1086. package/dist/lib/schemas-data/3.2/media-buy/sync-event-sources-response.json +14 -14
  1087. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-receipts-request.json +9 -9
  1088. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-receipts-response.json +10 -10
  1089. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-status-request.json +8 -8
  1090. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-status-response.json +8 -8
  1091. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-async-response-input-required.json +3 -3
  1092. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-async-response-submitted.json +4 -4
  1093. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-async-response-working.json +3 -3
  1094. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-request.json +15 -15
  1095. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-response.json +21 -21
  1096. package/dist/lib/schemas-data/3.2/pricing-options/cpa-option.json +4 -4
  1097. package/dist/lib/schemas-data/3.2/pricing-options/cpc-option.json +4 -4
  1098. package/dist/lib/schemas-data/3.2/pricing-options/cpcv-option.json +4 -4
  1099. package/dist/lib/schemas-data/3.2/pricing-options/cpm-option.json +4 -4
  1100. package/dist/lib/schemas-data/3.2/pricing-options/cpp-option.json +5 -5
  1101. package/dist/lib/schemas-data/3.2/pricing-options/cpv-option.json +4 -4
  1102. package/dist/lib/schemas-data/3.2/pricing-options/flat-rate-option.json +4 -4
  1103. package/dist/lib/schemas-data/3.2/pricing-options/price-breakdown.json +2 -2
  1104. package/dist/lib/schemas-data/3.2/pricing-options/price-guidance.json +1 -1
  1105. package/dist/lib/schemas-data/3.2/pricing-options/revenue-share-option.json +2 -2
  1106. package/dist/lib/schemas-data/3.2/pricing-options/time-option.json +4 -4
  1107. package/dist/lib/schemas-data/3.2/pricing-options/vcpm-option.json +4 -4
  1108. package/dist/lib/schemas-data/3.2/property/authorization-result.json +1 -1
  1109. package/dist/lib/schemas-data/3.2/property/base-property-source.json +4 -4
  1110. package/dist/lib/schemas-data/3.2/property/create-property-list-request.json +8 -8
  1111. package/dist/lib/schemas-data/3.2/property/create-property-list-response.json +6 -6
  1112. package/dist/lib/schemas-data/3.2/property/delete-property-list-request.json +5 -5
  1113. package/dist/lib/schemas-data/3.2/property/delete-property-list-response.json +5 -5
  1114. package/dist/lib/schemas-data/3.2/property/delivery-record.json +3 -3
  1115. package/dist/lib/schemas-data/3.2/property/get-property-list-request.json +5 -5
  1116. package/dist/lib/schemas-data/3.2/property/get-property-list-response.json +9 -9
  1117. package/dist/lib/schemas-data/3.2/property/list-property-lists-request.json +6 -6
  1118. package/dist/lib/schemas-data/3.2/property/list-property-lists-response.json +7 -7
  1119. package/dist/lib/schemas-data/3.2/property/property-error.json +2 -2
  1120. package/dist/lib/schemas-data/3.2/property/property-feature-definition.json +2 -2
  1121. package/dist/lib/schemas-data/3.2/property/property-feature-result.json +4 -4
  1122. package/dist/lib/schemas-data/3.2/property/property-feature-value.json +2 -2
  1123. package/dist/lib/schemas-data/3.2/property/property-feature.json +1 -1
  1124. package/dist/lib/schemas-data/3.2/property/property-list-changed-webhook.json +2 -2
  1125. package/dist/lib/schemas-data/3.2/property/property-list-filters.json +5 -5
  1126. package/dist/lib/schemas-data/3.2/property/property-list.json +6 -6
  1127. package/dist/lib/schemas-data/3.2/property/update-property-list-request.json +8 -8
  1128. package/dist/lib/schemas-data/3.2/property/update-property-list-response.json +6 -6
  1129. package/dist/lib/schemas-data/3.2/property/validate-property-delivery-request.json +6 -6
  1130. package/dist/lib/schemas-data/3.2/property/validate-property-delivery-response.json +6 -6
  1131. package/dist/lib/schemas-data/3.2/property/validation-result.json +5 -5
  1132. package/dist/lib/schemas-data/3.2/protocol/get-adcp-capabilities-request.json +4 -4
  1133. package/dist/lib/schemas-data/3.2/protocol/get-adcp-capabilities-response.json +53 -53
  1134. package/dist/lib/schemas-data/3.2/protocol/get-principal-request.json +4 -4
  1135. package/dist/lib/schemas-data/3.2/protocol/get-principal-response.json +9 -9
  1136. package/dist/lib/schemas-data/3.2/protocol/get-task-status-request.json +5 -5
  1137. package/dist/lib/schemas-data/3.2/protocol/get-task-status-response.json +10 -10
  1138. package/dist/lib/schemas-data/3.2/protocol/list-tasks-request.json +13 -13
  1139. package/dist/lib/schemas-data/3.2/protocol/list-tasks-response.json +8 -8
  1140. package/dist/lib/schemas-data/3.2/protocol/sync-agent-notification-configs-request.json +5 -5
  1141. package/dist/lib/schemas-data/3.2/protocol/sync-agent-notification-configs-response.json +7 -7
  1142. package/dist/lib/schemas-data/3.2/protocol/sync-principal-request.json +8 -8
  1143. package/dist/lib/schemas-data/3.2/protocol/sync-principal-response.json +10 -10
  1144. package/dist/lib/schemas-data/3.2/registries/v1-canonical-mapping.json +2 -2
  1145. package/dist/lib/schemas-data/3.2/signals/activate-signal-request.json +6 -6
  1146. package/dist/lib/schemas-data/3.2/signals/activate-signal-response.json +9 -9
  1147. package/dist/lib/schemas-data/3.2/signals/get-signals-async-response-submitted.json +4 -4
  1148. package/dist/lib/schemas-data/3.2/signals/get-signals-async-response-working.json +3 -3
  1149. package/dist/lib/schemas-data/3.2/signals/get-signals-request.json +11 -11
  1150. package/dist/lib/schemas-data/3.2/signals/get-signals-response.json +17 -17
  1151. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-capabilities.json +1 -1
  1152. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-context-use.json +1 -1
  1153. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-get-offering-request.json +4 -4
  1154. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-get-offering-response.json +9 -9
  1155. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-identity.json +1 -1
  1156. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-initiate-session-request.json +7 -7
  1157. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-initiate-session-response.json +10 -10
  1158. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-send-message-request.json +5 -5
  1159. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-send-message-response.json +10 -10
  1160. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-sponsored-context-receipt.json +4 -4
  1161. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-sponsored-context.json +4 -4
  1162. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-terminate-session-request.json +4 -4
  1163. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-terminate-session-response.json +7 -7
  1164. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-ui-element.json +1 -1
  1165. package/dist/lib/schemas-data/3.2/trusted-match/available-package.json +5 -5
  1166. package/dist/lib/schemas-data/3.2/trusted-match/context-match-request.json +5 -5
  1167. package/dist/lib/schemas-data/3.2/trusted-match/context-match-response.json +4 -4
  1168. package/dist/lib/schemas-data/3.2/trusted-match/error.json +1 -1
  1169. package/dist/lib/schemas-data/3.2/trusted-match/identity-match-request.json +4 -4
  1170. package/dist/lib/schemas-data/3.2/trusted-match/identity-match-response.json +4 -4
  1171. package/dist/lib/schemas-data/3.2/trusted-match/offer-price.json +1 -1
  1172. package/dist/lib/schemas-data/3.2/trusted-match/offer.json +5 -5
  1173. package/dist/lib/schemas-data/3.2/trusted-match/provider-context-match-response.json +4 -4
  1174. package/dist/lib/schemas-data/3.2/trusted-match/provider-identity-match-response.json +4 -4
  1175. package/dist/lib/schemas-data/3.2/trusted-match/provider-registration.json +2 -2
  1176. package/dist/lib/schemas-data/3.2/trusted-match/publisher-targeting-kv-config.json +1 -1
  1177. package/dist/lib/schemas-data/3.2/trusted-match/publisher-tmpx-config.json +1 -1
  1178. package/dist/lib/schemas-data/3.2/trusted-match/tmpx-chunk.json +1 -1
  1179. package/dist/lib/server/create-adcp-server.js +1 -1
  1180. package/dist/lib/server/create-adcp-server.mjs +2 -1
  1181. package/dist/lib/server/responses.js +50 -3
  1182. package/dist/lib/server/responses.mjs +49 -3
  1183. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  1184. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  1185. package/dist/lib/v2/projection/creative-delivery.js +31 -32
  1186. package/dist/lib/v2/projection/creative-delivery.mjs +29 -31
  1187. package/dist/lib/version.d.mts +5 -5
  1188. package/dist/lib/version.d.ts +5 -5
  1189. package/dist/lib/version.js +4 -3
  1190. package/dist/lib/version.mjs +4 -3
  1191. package/docs/CLI.md +1 -1
  1192. package/docs/TYPE-SUMMARY.md +2 -2
  1193. package/docs/guides/CREATIVE-DELIVERY.md +15 -2
  1194. package/docs/guides/CREATIVE-PACKAGE-FIT.md +1 -1
  1195. package/docs/guides/REPORTING-LEDGER.md +6 -0
  1196. package/docs/guides/REPORTING-OPERATIONS.md +62 -5
  1197. package/docs/llms.txt +2 -2
  1198. package/docs/migration-14.x-rc-worksheet.md +5 -5
  1199. package/docs/migration-16-to-17.md +3 -3
  1200. package/docs/migration-account-change-feed.md +1 -1
  1201. package/docs/migration-reporting-storage-package.md +21 -1
  1202. package/package.json +3 -3
  1203. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/index.yaml +0 -0
  1204. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/scenarios/distributed_brand_resolution.yaml +0 -0
  1205. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/scenarios/signed_response_envelope_vectors.yaml +0 -0
  1206. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/scenarios/single_side_trust_extension.yaml +0 -0
  1207. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/index.yaml +0 -0
  1208. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/asset_type_filtering.yaml +0 -0
  1209. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/billing_out_of_band.yaml +0 -0
  1210. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/canonical_supported_formats.yaml +0 -0
  1211. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/creative_features_idempotency.yaml +0 -0
  1212. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/creative_revision_identity.yaml +0 -0
  1213. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/evaluator_auth.yaml +0 -0
  1214. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/list_creatives_filter_behavior.yaml +0 -0
  1215. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/native_in_feed.yaml +0 -0
  1216. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/native_localization.yaml +0 -0
  1217. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/policy_backed_rejections.yaml +0 -0
  1218. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/governance/index.yaml +0 -0
  1219. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/governance/scenarios/failed_outcome_audit_persistence.yaml +0 -0
  1220. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/governance/scenarios/property_list_change_webhook_signing.yaml +0 -0
  1221. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/index.yaml +0 -0
  1222. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/acceptance_policy_discovery.yaml +0 -0
  1223. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_change_feed.yaml +0 -0
  1224. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_timezone_buyer_selected.yaml +0 -0
  1225. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_timezone_seller_assigned.yaml +0 -0
  1226. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_timezone_seller_fixed.yaml +0 -0
  1227. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/advanced_delivery_reporting.yaml +0 -0
  1228. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/audience_activation_discovery.yaml +0 -0
  1229. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/audience_buy_flow.yaml +0 -0
  1230. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/availability_windows.yaml +0 -0
  1231. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/available_actions.yaml +0 -0
  1232. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/bidding_cost_binding.yaml +0 -0
  1233. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/bidding_policy_placement.yaml +0 -0
  1234. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/billing_finality_delivery.yaml +0 -0
  1235. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_account.yaml +0 -0
  1236. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_fixed.yaml +0 -0
  1237. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_override.yaml +0 -0
  1238. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_override_rejected.yaml +0 -0
  1239. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/canonical_formats.yaml +0 -0
  1240. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/catalog_item_availability_updates.yaml +0 -0
  1241. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/change_rights_state_projection.yaml +0 -0
  1242. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/clicks_buy_flow.yaml +0 -0
  1243. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/collection_selection.yaml +0 -0
  1244. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/compact_direct_buy_lifecycle.yaml +0 -0
  1245. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/compact_product_lifecycle.yaml +0 -0
  1246. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/completed_views_buy_flow.yaml +0 -0
  1247. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/create_media_buy_async.yaml +0 -0
  1248. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/create_media_buy_async_lifecycle.yaml +0 -0
  1249. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/creative_reception.yaml +0 -0
  1250. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/cross_path_targeting_provenance.yaml +0 -0
  1251. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/declined_proposal_execution.yaml +0 -0
  1252. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/declined_proposal_refinement.yaml +0 -0
  1253. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/delivery_reporting.yaml +0 -0
  1254. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/demographic_targeting.yaml +0 -0
  1255. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/dependency_impairment_audience.yaml +0 -0
  1256. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/event_dedup_flow.yaml +0 -0
  1257. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/expired_proposal_execution.yaml +0 -0
  1258. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/external_audience_source_binding.yaml +0 -0
  1259. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/frequency_cap_capability_updates.yaml +0 -0
  1260. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/frequency_cap_enforcement.yaml +0 -0
  1261. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_place_targeting.yaml +0 -0
  1262. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_region_all_values_support.yaml +0 -0
  1263. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_region_exclusion_support.yaml +0 -0
  1264. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_region_targeting.yaml +0 -0
  1265. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/get_products_async.yaml +0 -0
  1266. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/get_products_rejected.yaml +0 -0
  1267. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_agent_binding_acceptance.yaml +0 -0
  1268. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_approved.yaml +0 -0
  1269. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_conditions.yaml +0 -0
  1270. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_denied.yaml +0 -0
  1271. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_denied_recovery.yaml +0 -0
  1272. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/inline_creatives_without_sync.yaml +0 -0
  1273. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/inventory_list_no_match.yaml +0 -0
  1274. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/inventory_list_targeting.yaml +0 -0
  1275. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/measurement_accountability.yaml +0 -0
  1276. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/measurement_terms_accepted.yaml +0 -0
  1277. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/media_buy_frequency_cap_readback.yaml +0 -0
  1278. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/media_buy_frequency_cap_updates.yaml +0 -0
  1279. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/metric_container_subsumption.yaml +0 -0
  1280. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/outcome_target.yaml +0 -0
  1281. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/outcome_target_list_products_inert.yaml +0 -0
  1282. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/owner_sold_channel_carriage.yaml +0 -0
  1283. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/package_automatic_bidding.yaml +0 -0
  1284. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/package_correlation_legacy_fallback.yaml +0 -0
  1285. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/pending_creatives_to_start.yaml +0 -0
  1286. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/per_creative_conversion_attribution.yaml +0 -0
  1287. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/performance_buy_flow.yaml +0 -0
  1288. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/performance_buy_flow_roas.yaml +0 -0
  1289. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/portfolio_routing_scope.yaml +0 -0
  1290. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/pricing_currency_filter.yaml +0 -0
  1291. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/product_coverage_filters.yaml +0 -0
  1292. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/product_filter_behavior.yaml +0 -0
  1293. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/product_signal_targeting.yaml +0 -0
  1294. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/proposal_finalize.yaml +0 -0
  1295. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/proposal_finalize_asap_timing.yaml +0 -0
  1296. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/proposal_not_found_errors.yaml +0 -0
  1297. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/provenance_audit_observation.yaml +0 -0
  1298. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/provenance_enforcement.yaml +0 -0
  1299. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/provenance_truth_of_claim.yaml +0 -0
  1300. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/reach_buy_flow.yaml +0 -0
  1301. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/read_filter_behavior.yaml +0 -0
  1302. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/refine_finalize_exclusivity.yaml +0 -0
  1303. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/refine_frequency_cap_negotiation.yaml +0 -0
  1304. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/refine_products.yaml +0 -0
  1305. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/revenue_share_pricing.yaml +0 -0
  1306. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/seller_optimized_budget.yaml +0 -0
  1307. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/seller_optimized_min_spend_target_exceeds_package_cap.yaml +0 -0
  1308. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/seller_optimized_proposal_package_pacing.yaml +0 -0
  1309. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/targeting_aware_discovery.yaml +0 -0
  1310. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/total_budget_redistribution.yaml +0 -0
  1311. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/typed_proposal_negotiation.yaml +0 -0
  1312. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/vendor_metric_accountability.yaml +0 -0
  1313. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/vendor_metric_catalog_precondition.yaml +0 -0
  1314. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/vendor_metric_optimization_flow.yaml +0 -0
  1315. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/state-machine.yaml +0 -0
  1316. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/signals/index.yaml +0 -0
  1317. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/signals/scenarios/get_signals_async.yaml +0 -0
  1318. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/sponsored-intelligence/index.yaml +0 -0
  1319. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/sponsored-intelligence/sponsored-context-accountability.yaml +0 -0
  1320. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/audience-sync/index.yaml +0 -0
  1321. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/index.yaml +0 -0
  1322. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/scenarios/governance_approved.yaml +0 -0
  1323. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/scenarios/governance_denied.yaml +0 -0
  1324. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/scenarios/update_rights_lifecycle.yaml +0 -0
  1325. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-activation/index.yaml +0 -0
  1326. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-discovery/index.yaml +0 -0
  1327. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-monitoring/index.yaml +0 -0
  1328. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-negotiation/index.yaml +0 -0
  1329. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-recovery/index.yaml +0 -0
  1330. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/collection-lists/index.yaml +0 -0
  1331. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/content-standards/index.yaml +0 -0
  1332. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-ad-server/index.yaml +0 -0
  1333. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-generative/generative-seller.yaml +0 -0
  1334. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-generative/index.yaml +0 -0
  1335. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-template/index.yaml +0 -0
  1336. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-transformers/index.yaml +0 -0
  1337. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-transformers/scenarios/governance_approved.yaml +0 -0
  1338. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-transformers/scenarios/governance_denied.yaml +0 -0
  1339. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-aware-seller/index.yaml +0 -0
  1340. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-aware-seller/scenarios/governance_multi_agent_rejected.yaml +0 -0
  1341. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-delivery-monitor/index.yaml +0 -0
  1342. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-spend-authority/denied.yaml +0 -0
  1343. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-spend-authority/index.yaml +0 -0
  1344. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/orchestrator-multi-agent/index.yaml +0 -0
  1345. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/property-lists/index.yaml +0 -0
  1346. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-catalog-driven/index.yaml +0 -0
  1347. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-dooh/index.yaml +0 -0
  1348. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-exchange/index.yaml +0 -0
  1349. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-guaranteed/index.yaml +0 -0
  1350. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-non-guaranteed/index.yaml +0 -0
  1351. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-proposal-mode/index.yaml +0 -0
  1352. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-retail-media/index.yaml +0 -0
  1353. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-social/index.yaml +0 -0
  1354. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-streaming-tv/index.yaml +0 -0
  1355. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-marketplace/index.yaml +0 -0
  1356. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-marketplace/scenarios/governance_approved.yaml +0 -0
  1357. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-marketplace/scenarios/governance_denied.yaml +0 -0
  1358. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-owned/index.yaml +0 -0
  1359. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sponsored-intelligence/index.yaml +0 -0
  1360. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/acme-outdoor-live.yaml +0 -0
  1361. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/acme-outdoor.yaml +0 -0
  1362. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/billing-gate-runner.yaml +0 -0
  1363. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/bistro-oranje.yaml +0 -0
  1364. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/creative-build-probe-runner.yaml +0 -0
  1365. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/distributed-brand-runner.yaml +0 -0
  1366. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/hosted-grader.yaml +0 -0
  1367. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/nova-motors.yaml +0 -0
  1368. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/oauth-setup-runner.yaml +0 -0
  1369. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/osei-natural.yaml +0 -0
  1370. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/parallel-dispatch-runner.yaml +0 -0
  1371. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/rate-limit-trip-runner.yaml +0 -0
  1372. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/signed-requests-runner.yaml +0 -0
  1373. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/signed-responses-runner.yaml +0 -0
  1374. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/single-side-trust-runner.yaml +0 -0
  1375. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/substitution-observer-runner.yaml +0 -0
  1376. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/summit-foods.yaml +0 -0
  1377. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/trusted-match-router-runner.yaml +0 -0
  1378. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/webhook-receiver-runner.yaml +0 -0
  1379. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/attestations/README.md +0 -0
  1380. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/attestations/vectors.json +0 -0
  1381. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/audience-evidence/README.md +0 -0
  1382. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/audience-evidence/vectors.json +0 -0
  1383. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/brand-response-signing/brand-authorization-cross-check.json +0 -0
  1384. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/catalog-macro-substitution.json +0 -0
  1385. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/creative-representation-resolution.json +0 -0
  1386. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/creative-representation-resolution.schema.json +0 -0
  1387. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/error-recovery/README.md +0 -0
  1388. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/error-recovery/vectors.json +0 -0
  1389. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/governance-authorization.json +0 -0
  1390. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/governance-runtime-attestations/README.md +0 -0
  1391. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/governance-runtime-attestations/vectors.json +0 -0
  1392. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/macro-processing.json +0 -0
  1393. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/macro-processing.schema.json +0 -0
  1394. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/oauth-setup/vectors.json +0 -0
  1395. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/001-minimal-plan.json +0 -0
  1396. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/002-full-plan.json +0 -0
  1397. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/003-bookkeeping-stripped.json +0 -0
  1398. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/004a-human-review-omitted.json +0 -0
  1399. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/004b-human-review-explicit-null.json +0 -0
  1400. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/005a-policy-categories-order-1.json +0 -0
  1401. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/005b-policy-categories-order-2.json +0 -0
  1402. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/006a-ext-trace-v1.json +0 -0
  1403. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/006b-ext-trace-v2.json +0 -0
  1404. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/007-unicode-objectives.json +0 -0
  1405. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/008-numeric-canonicalization.json +0 -0
  1406. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/products-only-brief-compatibility/README.md +0 -0
  1407. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/products-only-brief-compatibility/vectors.json +0 -0
  1408. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/relationship-scoped-indicators.json +0 -0
  1409. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/README.md +0 -0
  1410. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/adjustment.json +0 -0
  1411. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/canonicalization.json +0 -0
  1412. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/coverage-aggregation.json +0 -0
  1413. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/manifest.json +0 -0
  1414. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/materialization.json +0 -0
  1415. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/obligation.json +0 -0
  1416. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/accepted-recorded-response.json +0 -0
  1417. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/accepted-request.json +0 -0
  1418. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/accepted-unchanged-response.json +0 -0
  1419. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/adjustment-accepted-recorded-response.json +0 -0
  1420. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/adjustment-accepted-request.json +0 -0
  1421. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/rejected-recorded-response.json +0 -0
  1422. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/rejected-request.json +0 -0
  1423. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/report-definition.json +0 -0
  1424. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/revision.json +0 -0
  1425. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/row-schema.json +0 -0
  1426. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/rows.jsonl +0 -0
  1427. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/scenario-index.json +0 -0
  1428. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/scenario-index.schema.json +0 -0
  1429. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-summary/complete-summary.json +0 -0
  1430. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/README.md +0 -0
  1431. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/001-unsigned-sendmessage-required.json +0 -0
  1432. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/002-unsigned-message-send-v0-3-required.json +0 -0
  1433. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/003-unsigned-sendstreamingmessage-required.json +0 -0
  1434. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/004-duplicate-invocation-datapart.json +0 -0
  1435. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/005-signed-duplicate-invocation-datapart.json +0 -0
  1436. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/006-missing-skill.json +0 -0
  1437. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/007-protocol-method-required-covers-sendmessage.json +0 -0
  1438. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/008-no-extension-header.json +0 -0
  1439. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/009-extra-non-invocation-datapart.json +0 -0
  1440. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/010-filepart-present.json +0 -0
  1441. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/011-part-with-text-and-data.json +0 -0
  1442. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/012-non-object-data.json +0 -0
  1443. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/013-v0-3-kind-mismatch.json +0 -0
  1444. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/014-duplicate-skill-key.json +0 -0
  1445. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/015-non-string-skill.json +0 -0
  1446. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/016-text-only-message.json +0 -0
  1447. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/017-unsigned-message-stream-v0-3-required.json +0 -0
  1448. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/018-unresolvable-with-lone-signature-header.json +0 -0
  1449. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/019-raw-part-present.json +0 -0
  1450. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/020-case-variant-member-name.json +0 -0
  1451. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/021-escaped-duplicate-skill-key.json +0 -0
  1452. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/022-unsigned-http-json-message-send-required.json +0 -0
  1453. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/023-batch-body.json +0 -0
  1454. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/024-duplicate-method-key.json +0 -0
  1455. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/025-missing-method.json +0 -0
  1456. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/026-empty-skill.json +0 -0
  1457. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/001-signed-sendmessage-create-media-buy.json +0 -0
  1458. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/002-signed-message-send-v0-3-create-media-buy.json +0 -0
  1459. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/003-unsigned-sendmessage-get-products-not-required.json +0 -0
  1460. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/004-unsigned-decoy-text-and-metadata.json +0 -0
  1461. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/005-unsigned-alias-skill-not-in-lists.json +0 -0
  1462. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/006-unsigned-message-send-v0-3-legacy-parameters.json +0 -0
  1463. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/007-unsigned-method-case-variant.json +0 -0
  1464. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/body-integrity-policy.json +0 -0
  1465. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/canonicalization.json +0 -0
  1466. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/keys.json +0 -0
  1467. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/001-no-signature-header.json +0 -0
  1468. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/002-wrong-tag.json +0 -0
  1469. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/003-expired-signature.json +0 -0
  1470. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/004-window-too-long.json +0 -0
  1471. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/005-alg-not-allowed.json +0 -0
  1472. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/006-missing-covered-component.json +0 -0
  1473. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/007-missing-content-digest.json +0 -0
  1474. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/008-unknown-keyid.json +0 -0
  1475. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/009-key-ops-missing-verify.json +0 -0
  1476. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/010-content-digest-mismatch.json +0 -0
  1477. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/011-malformed-header.json +0 -0
  1478. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/012-missing-expires-param.json +0 -0
  1479. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/013-expires-le-created.json +0 -0
  1480. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/014-missing-nonce-param.json +0 -0
  1481. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/015-signature-invalid.json +0 -0
  1482. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/016-replayed-nonce.json +0 -0
  1483. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/017-key-revoked.json +0 -0
  1484. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/018-digest-covered-when-forbidden.json +0 -0
  1485. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/019-signature-without-signature-input.json +0 -0
  1486. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/020-rate-abuse.json +0 -0
  1487. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/021-duplicate-signature-input-label.json +0 -0
  1488. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/022-multi-valued-content-type.json +0 -0
  1489. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/023-multi-valued-content-digest.json +0 -0
  1490. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/024-unquoted-string-param.json +0 -0
  1491. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/025-jwk-alg-crv-mismatch.json +0 -0
  1492. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/026-non-ascii-host.json +0 -0
  1493. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/027-webhook-registration-authentication-unsigned.json +0 -0
  1494. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/028-unsigned-protocol-method-required.json +0 -0
  1495. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/029-duplicate-signature-label.json +0 -0
  1496. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/030-content-digest-key-case.json +0 -0
  1497. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/031-malformed-host-authority.json +0 -0
  1498. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/001-basic-post.json +0 -0
  1499. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/002-post-with-content-digest.json +0 -0
  1500. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/003-es256-post.json +0 -0
  1501. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/004-multiple-signature-labels.json +0 -0
  1502. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/005-default-port-stripped.json +0 -0
  1503. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/006-dot-segment-path.json +0 -0
  1504. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/007-query-byte-preserved.json +0 -0
  1505. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/008-percent-encoded-path.json +0 -0
  1506. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/009-percent-encoded-unreserved-decoded.json +0 -0
  1507. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/010-percent-encoded-slash-preserved.json +0 -0
  1508. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/011-ipv6-authority.json +0 -0
  1509. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/012-ipv6-authority-default-port-stripped.json +0 -0
  1510. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/013-two-signature-labels-distinct.json +0 -0
  1511. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/014-content-digest-two-algorithms.json +0 -0
  1512. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/015-bracketed-ipv6-host-with-port.json +0 -0
  1513. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/001-base64url-sf-binary.json +0 -0
  1514. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/001-no-signature-header.json +0 -0
  1515. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/002-multiple-trailing-dots.json +0 -0
  1516. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/002-wrong-tag.json +0 -0
  1517. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/003-expired-signature.json +0 -0
  1518. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/004-window-too-long.json +0 -0
  1519. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/005-alg-not-allowed.json +0 -0
  1520. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/006-missing-covered-component.json +0 -0
  1521. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/007-missing-content-digest.json +0 -0
  1522. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/008-unknown-keyid.json +0 -0
  1523. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/009-key-ops-missing-verify.json +0 -0
  1524. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/010-content-digest-mismatch.json +0 -0
  1525. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/011-malformed-header.json +0 -0
  1526. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/012-missing-expires-param.json +0 -0
  1527. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/013-expires-le-created.json +0 -0
  1528. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/014-missing-nonce-param.json +0 -0
  1529. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/015-signature-invalid.json +0 -0
  1530. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/016-replayed-nonce.json +0 -0
  1531. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/017-key-revoked.json +0 -0
  1532. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/019-signature-without-signature-input.json +0 -0
  1533. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/020-rate-abuse.json +0 -0
  1534. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/021-duplicate-signature-input-label.json +0 -0
  1535. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/022-multi-valued-content-type.json +0 -0
  1536. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/023-multi-valued-content-digest.json +0 -0
  1537. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/024-unquoted-string-param.json +0 -0
  1538. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/025-jwk-alg-crv-mismatch.json +0 -0
  1539. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/026-non-ascii-host.json +0 -0
  1540. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/027-webhook-registration-authentication-unsigned.json +0 -0
  1541. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/028-unsigned-protocol-method-required.json +0 -0
  1542. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/029-duplicate-signature-label.json +0 -0
  1543. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/030-content-digest-key-case.json +0 -0
  1544. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/031-malformed-host-authority.json +0 -0
  1545. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/001-post-with-content-digest.json +0 -0
  1546. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/003-es256-post.json +0 -0
  1547. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/004-multiple-signature-labels.json +0 -0
  1548. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/005-default-port-stripped.json +0 -0
  1549. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/006-dot-segment-path.json +0 -0
  1550. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/007-query-byte-preserved.json +0 -0
  1551. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/008-percent-encoded-path.json +0 -0
  1552. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/009-percent-encoded-unreserved-decoded.json +0 -0
  1553. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/010-percent-encoded-slash-preserved.json +0 -0
  1554. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/011-ipv6-authority.json +0 -0
  1555. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/012-ipv6-authority-default-port-stripped.json +0 -0
  1556. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/013-two-signature-labels-distinct.json +0 -0
  1557. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/014-content-digest-two-algorithms.json +0 -0
  1558. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/015-bracketed-ipv6-host-with-port.json +0 -0
  1559. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/protocol-method-names.json +0 -0
  1560. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/rights-attestations/README.md +0 -0
  1561. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/rights-attestations/vectors.json +0 -0
  1562. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/supply-path/README.md +0 -0
  1563. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/supply-path/vectors.json +0 -0
  1564. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/tracker-execution-contracts.json +0 -0
  1565. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/tracker-execution-contracts.schema.json +0 -0
  1566. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/trusted-match-context-merge/README.md +0 -0
  1567. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/trusted-match-context-merge/vectors.json +0 -0
  1568. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/universal-macro-translation.json +0 -0
  1569. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/universal-macro-translation.schema.json +0 -0
  1570. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-receiver-envelope.json +0 -0
  1571. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/README.md +0 -0
  1572. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/keys.json +0 -0
  1573. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/001-wrong-tag.json +0 -0
  1574. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/002-expired-signature.json +0 -0
  1575. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/003-window-too-long.json +0 -0
  1576. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/004-alg-not-allowed.json +0 -0
  1577. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/005-missing-authority-component.json +0 -0
  1578. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/006-missing-content-digest.json +0 -0
  1579. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/007-unknown-keyid.json +0 -0
  1580. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/008-wrong-adcp-use.json +0 -0
  1581. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/009-content-digest-mismatch.json +0 -0
  1582. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/010-malformed-signature-input.json +0 -0
  1583. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/011-signature-without-input.json +0 -0
  1584. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/012-missing-expires-param.json +0 -0
  1585. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/013-expires-le-created.json +0 -0
  1586. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/014-missing-nonce-param.json +0 -0
  1587. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/015-signature-invalid.json +0 -0
  1588. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/016-replayed-nonce.json +0 -0
  1589. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/017-key-revoked.json +0 -0
  1590. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/018-rate-abuse.json +0 -0
  1591. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/019-revocation-stale.json +0 -0
  1592. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/020-key-ops-missing-verify.json +0 -0
  1593. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/021-base64-alphabet-mixing.json +0 -0
  1594. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/001-basic-post.json +0 -0
  1595. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/002-es256-post.json +0 -0
  1596. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/003-multiple-signature-labels.json +0 -0
  1597. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/004-default-port-stripped.json +0 -0
  1598. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/005-percent-encoded-path.json +0 -0
  1599. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/006-query-byte-preserved.json +0 -0
  1600. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/007-body-without-idempotency-key.json +0 -0
  1601. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/008-request-signing-key-reuse.json +0 -0
  1602. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/account-identity-reconciliation.yaml +0 -0
  1603. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/agent-notification-configs.yaml +0 -0
  1604. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/billing-gate-dispatch.yaml +0 -0
  1605. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/buyer-fixture-publisher.yaml +0 -0
  1606. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/buyer-orchestrator-track.yaml +0 -0
  1607. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/canonical-format-validate-input.yaml +0 -0
  1608. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/capability-discovery.yaml +0 -0
  1609. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/collection-lists-pagination-integrity.yaml +0 -0
  1610. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/comply-controller-mode-gate.yaml +0 -0
  1611. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/content-standards-pagination-integrity.yaml +0 -0
  1612. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/ctv-experience-validate-input.yaml +0 -0
  1613. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/deterministic-testing.yaml +0 -0
  1614. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/error-compliance-signals.yaml +0 -0
  1615. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/error-compliance.yaml +0 -0
  1616. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/fictional-entities.yaml +0 -0
  1617. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/get-media-buys-pagination-integrity.yaml +0 -0
  1618. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/get-products-pagination-integrity.yaml +0 -0
  1619. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/get-signals-pagination-integrity.yaml +0 -0
  1620. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/governance.yaml +0 -0
  1621. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/idempotency.yaml +0 -0
  1622. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/notification-config-event-scope.yaml +0 -0
  1623. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/notification-config-lifecycle.yaml +0 -0
  1624. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/notification-config-rejections.yaml +0 -0
  1625. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/oauth-setup.yaml +0 -0
  1626. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/pagination-integrity-creative-formats.yaml +0 -0
  1627. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/pagination-integrity-list-accounts.yaml +0 -0
  1628. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/pagination-integrity.yaml +0 -0
  1629. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/premium-display-canonical-validation.yaml +0 -0
  1630. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/principal.yaml +0 -0
  1631. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/property-lists-pagination-integrity.yaml +0 -0
  1632. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/read-tool-idempotency.yaml +0 -0
  1633. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reliable-reporting-managed-delivery.yaml +0 -0
  1634. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reliable-reporting-reconciled-billing.yaml +0 -0
  1635. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reporting-consumer-status.yaml +0 -0
  1636. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reporting-core-declaration.yaml +0 -0
  1637. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reporting-core.yaml +0 -0
  1638. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/runner-output-contract.yaml +0 -0
  1639. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/schema-validation-signals.yaml +0 -0
  1640. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/schema-validation.yaml +0 -0
  1641. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/security.yaml +0 -0
  1642. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/signed-requests.yaml +0 -0
  1643. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/trusted-match-publisher-authentication.yaml +0 -0
  1644. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/v3-envelope-integrity.yaml +0 -0
  1645. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/v4-compatibility.yaml +0 -0
  1646. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/version-negotiation.yaml +0 -0
  1647. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/webhook-emission.yaml +0 -0
  1648. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/webhook-receiver-envelope.yaml +0 -0
  1649. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-bulk-webhooks.yaml +0 -0
  1650. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-product-webhooks.yaml +0 -0
  1651. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-products-scope-isolation.yaml +0 -0
  1652. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-products.yaml +0 -0
  1653. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-signal-webhooks.yaml +0 -0
  1654. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-signals-scope-isolation.yaml +0 -0
  1655. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-signals.yaml +0 -0
@@ -1 +1 @@
1
- {"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json","title":"Get Products Request","description":"AdCP 3.x compatibility request for discovering and changing advertising products and proposals. Buyers SHOULD express every campaign constraint that has a structured field in that field rather than relying on prose: structured input is cheaper to transmit, deterministic to process, and avoids lossy inference. Exact targeting_overlay values scope returned products, pricing, and forecasts; required_overlay_support identifies targeting dimensions whose values will be supplied on packages later. Explicit hard targeting stated only in a brief remains binding. AdCP 3.2 introduces the narrower list_products, request_proposals, refine_proposals, and decline_proposals tasks; new callers SHOULD use those tasks while existing get_products payloads remain valid throughout 3.x.","type":"object","x-mutates-state":true,"x-idempotency-key-required":false,"x-operation-family":"get_products","x-deprecated-in":"3.2.0","x-superseded-by":["list_products","request_proposals","refine_proposals","decline_proposals"],"properties":{"adcp_version":{"type":"string","description":"Release-precision AdCP version (VERSION.RELEASE, e.g. \"3.0\", \"3.1\", \"3.1-beta\"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = \"3.1.0-beta.1\") MUST normalize to release-precision (\"3.1-beta.1\") before emitting on the wire — meta-field values are NOT valid wire values.","pattern":"^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?)?$","examples":["3.0","3.1","3.1-beta","3.1-rc.1"]},"adcp_major_version":{"type":"integer","deprecated":true,"x-removed-in":"4.0.0","description":"DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.","minimum":1,"maximum":99},"idempotency_key":{"type":"string","description":"Optional client-generated key on the AdCP 3.x compatibility facade. The field remains optional on every arm for wire compatibility. A seller MAY ignore a supplied key on a guaranteed side-effect-free synchronous read. Buyers SHOULD supply a key whenever the request may allocate a task, finalize a proposal, or otherwise change observable state. When a key is supplied on such a request and the seller declares adcp.idempotency.supported: true, the seller MUST apply the AdCP replay contract before that effect. If the key is omitted or the seller declares adcp.idempotency.supported: false, the buyer has no portable at-most-once retry guarantee after an ambiguous result. New callers SHOULD use the compact 3.2 tasks; each stateful split task has its own idempotency identity, so callers MUST retry with the same tool name. Keys MUST be unique per seller and logical request.","minLength":16,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{16,255}$"},"buying_mode":{"type":"string","enum":["brief","wholesale","refine"],"description":"Declares buyer intent for this request. 'brief': publisher curates product recommendations from the provided brief. 'wholesale': buyer requests raw product inventory to apply their own audiences — brief must not be provided, and proposals are omitted. 'refine': iterate on products and proposals from a previous get_products response using the refine array of change requests. v3 clients MUST include buying_mode. Sellers receiving requests from pre-v3 clients without buying_mode SHOULD default to 'brief'. Timing semantics: 'wholesale' is a wholesale product feed read — sellers SHOULD return a synchronous response and MUST NOT route a 'wholesale' request through the async/Submitted arm; partial completion is signalled via the response's incomplete[] field (with optional estimated_wait), not via a task-handoff envelope. 'brief' and 'refine' MAY complete synchronously, or MAY return a Submitted envelope (see get-products-async-response-submitted.json) when curation requires upstream-system queries or HITL review the seller cannot complete inside time_budget. Buyers needing predictable fast wholesale product feed access MUST use 'wholesale'; buyers open to slower curation use 'brief' or 'refine'."},"brief":{"type":"string","description":"Natural language description of campaign requirements. Required when buying_mode is 'brief'. Must not be provided when buying_mode is 'wholesale' or 'refine'. Buyers SHOULD use structured fields for every requirement that can be expressed structurally, and reserve brief prose for goals, context, preferences, and requirements without a structured representation. Sellers MUST apply explicit hard requirements stated in the brief even when the buyer did not duplicate them in a structured field. When a seller translates hard prose into structured targeting that materially affects product eligibility, pricing, or forecasting, it MUST confirm that interpretation once in GetProductsResponse.targeting_resolution.brief_targeting; otherwise confirmation remains a best practice. If hard prose contradicts a structured field, sellers MUST reject the request with INVALID_REQUEST rather than choose one interpretation or return an unexplained empty result."},"refine":{"type":"array","description":"Array of change requests for iterating on products and proposals from a previous get_products response. Each entry declares a scope (request, product, or proposal) and what the buyer is asking for. Only valid when buying_mode is 'refine'. The seller responds to each entry via refinement_applied in the response, matched by position.\n\nFinalize-exclusivity rule: if any entry has `action: 'finalize'`, ALL entries in the array MUST be proposal-scoped with `action: 'finalize'` — mixing finalize entries with `include`/`omit` entries or with request- / product-scoped entries MUST be rejected by the seller with `INVALID_REQUEST`. Finalize is a commit, not a refinement; the buyer expressing intent to commit means refinements have already converged. Buyers needing to refine AND commit in close succession sequence the calls: first a refine call (no finalize), then a finalize call against the resulting `proposal_id`(s).\n\nMulti-finalize semantics: multiple finalize entries against different `proposal_id` values in a single call are allowed and MUST be **atomic at the observation point** — sellers MUST NOT return a success response unless every named proposal has both completed and been persisted as committed. Pre-commit validation runs before any side-effects (inventory pull, terms lock, governance attestation); if any proposal fails validation, the seller MUST reject the entire call without committing any of the named proposals. There is no rollback operation in the spec — an `unfinalize` would itself be a new mutation surface; the atomicity guarantee runs entirely on the seller's pre-commit validation gate, not on post-commit reversal. Sellers that cannot guarantee atomic pre-commit validation MUST reject multi-finalize arrays with `MULTI_FINALIZE_UNSUPPORTED` (preferred — distinguishes seller-side capability gap from a malformed request) or `INVALID_REQUEST` (acceptable fallback for sellers on a pre-3.1 error catalog). If a mid-commit failure occurs *after* validation passed but before all proposals persist (e.g., a downstream ad server fails between commits one and two), the seller MUST return `INTERNAL_ERROR` with `refinement_applied[]` carrying per-position outcomes — the spec does NOT define a recovery path for this case, and buyers SHOULD treat the resulting state as undefined and re-read via `get_media_buys` / equivalent before retrying. Buyers MUST NOT assume multi-finalize support without a successful first attempt — there is no capability flag for this; the failure response is the discovery surface. Buyers whose intent specifically requires atomic commit (e.g., budget-shared proposals where one finalizing without the other is incoherent) MUST be prepared to abandon the intent if the seller returns `MULTI_FINALIZE_UNSUPPORTED` — there is no recovery for that loss of buyer intent beyond sequencing single-finalize calls and accepting the looser commit guarantee.","minItems":1,"items":{"type":"object","discriminator":{"propertyName":"scope"},"oneOf":[{"properties":{"scope":{"type":"string","const":"request","description":"Change scoped to the overall request — direction for the selection as a whole."},"ask":{"type":"string","minLength":1,"description":"What the buyer is asking for at the request level (e.g., 'more video options and less display', 'suggest how to combine these products')."}},"required":["scope","ask"],"additionalProperties":false},{"properties":{"scope":{"type":"string","const":"product","description":"Change scoped to a specific product."},"product_id":{"type":"string","minLength":1,"description":"Product ID from a previous get_products response."},"action":{"type":"string","enum":["include","omit","more_like_this"],"default":"include","description":"'include' (default): return this product with updated pricing and data. 'omit': exclude this product from the response. 'more_like_this': find additional products similar to this one (the original is also returned). Optional — when omitted, the seller treats the entry as action: 'include'."},"ask":{"type":"string","minLength":1,"description":"What the buyer is asking for on this product. For 'include': specific changes to request (e.g., 'add 16:9 format'). For 'more_like_this': what 'similar' means (e.g., 'same audience but video format'). Ignored when action is 'omit'."}},"required":["scope","product_id"],"additionalProperties":false},{"properties":{"scope":{"type":"string","const":"proposal","description":"Change scoped to a specific proposal."},"proposal_id":{"type":"string","minLength":1,"description":"Proposal ID from a previous get_products response."},"action":{"type":"string","enum":["include","omit","finalize"],"default":"include","description":"'include' (default): return this proposal with updated allocations and pricing. 'omit': exclude this proposal from the response. 'finalize': request firm pricing and inventory hold. New callers use refine_proposals with action revise for a draft successor or action finalize for a committed held successor; terminal feedback is available through decline_proposals.\n\nLegacy finalize is exclusive within the parent `refine[]` array: see the array-level description for the finalize-exclusivity rule (mixing finalize with non-finalize entries is rejected) and multi-finalize atomicity contract."},"ask":{"type":"string","minLength":1,"description":"What the buyer is asking for on this proposal (e.g., 'shift more budget toward video', 'reduce total by 10%'). Ignored when action is omit."}},"required":["scope","proposal_id"],"additionalProperties":false}]}},"brand":{"$ref":"#/$defs/external:core~1brand-ref.json","description":"Brand reference for product discovery context. Resolved to full brand identity at execution time."},"acceptance_context":{"$ref":"#/$defs/external:media-buy~1acceptance-context.json","x-adcp-schema-uri":"/schemas/media-buy/acceptance-context.json","description":"Structured campaign and advertiser facts for seller acceptance-policy preflight. Sellers may infer omitted facts from brand and brief, but uncertainty never implies acceptance."},"catalog":{"$ref":"#/$defs/external:core~1catalog.json","description":"Catalog of items the buyer wants to promote. The seller matches catalog items against its inventory and returns products where matches exist. Supports all catalog types: a job catalog finds job ad products, a product catalog finds sponsored product slots. Reference a synced catalog by catalog_id, or provide inline items."},"account":{"$ref":"#/$defs/external:core~1account-ref.json","description":"Account for product lookup. Returns products with pricing specific to this account's rate card. The account must already be provisioned: a reference that does not resolve returns ACCOUNT_NOT_FOUND rather than public products, unless the seller provisions lazily. Omit account (and send brand for discovery context) until sync_accounts succeeds. See /docs/accounts/overview#account-references-before-provisioning."},"preferred_delivery_types":{"type":"array","description":"Delivery types the buyer prefers, in priority order. Unlike filters.delivery_type which excludes non-matching products, this signals preference for curation — the publisher may still include other delivery types when they match the brief well.","items":{"$ref":"#/$defs/external:enums~1delivery-type.json"},"minItems":1,"uniqueItems":true},"filters":{"$ref":"#/$defs/external:core~1product-filters.json","description":"Offer filters. Valid in brief, wholesale, and refine modes. In every mode, sellers MUST exclude products that do not satisfy them: brief controls curation, wholesale controls feed behavior, and refine controls iteration, but none changes filter semantics. On refine, presence is the complete replacement filter state; when omitted, each referenced product's bound discovery constraints remain in force. Targeting-like legacy fields remain accepted during migration but are deprecated in favor of targeting_overlay and required_overlay_support."},"targeting_overlay":{"$ref":"#/$defs/external:core~1targeting.json","description":"Concrete delivery constraints the buyer expects to carry into create_media_buy. Buyers SHOULD use this field instead of putting equivalent exact targeting only in brief prose. Sellers evaluate these constraints during discovery and scope returned pricing and forecasts to the effective targeting. If a product cannot honor the request exactly, the seller may omit it or return a request-scoped configured product with Product targeting_resolution modifications. Absence of Product targeting_resolution means exact acceptance of this structured overlay; it does not confirm how targeting in the brief was interpreted. On refine, presence is complete replacement state for returned configurations; when omitted, each referenced product's bound targeting remains in force."},"media_buy_frequency_cap":{"$ref":"#/$defs/external:core~1media-buy-frequency-cap.json","description":"Concrete aggregate max-impression cap intended for the MediaBuy root. Every returned product must participate in one shared counter for this exact value. Legacy proposals echo it as proposals[].frequency_cap; direct buyers repeat it at purchase."},"required_overlay_support":{"$ref":"#/$defs/external:core~1targeting-overlay-requirements.json","description":"Minimum product-scoped targeting dimensions the buyer must be able to set independently on packages later. This requests selectable capability, not current targeting values, value-specific availability or forecasts, and not one product per possible value. A requirement true matches support true or any valid support object; an object requirement matches support true or an object containing every requested boolean and requested array subset. The backward-compatible daypart_targets support true is the exception: it satisfies inventory_local requirements only, not iana requirements. Unrequested object fields and numeric limits do not participate. Missing or unknown requirement fields do not match. Seller limit fields are response-only and cannot be requested here. On refine, presence is complete replacement state; when omitted, each referenced product's bound future-support requirements remain in force."},"required_media_buy_support":{"$ref":"#/$defs/external:core~1media-buy-support-requirements.json","description":"Minimum product participation in shared MediaBuy-level controls. For a frequency cap, every returned product must be composable in one seller-maintained aggregate counter for every requested per unit. On refine, presence is complete replacement state."},"property_list":{"$ref":"#/$defs/external:core~1property-list-ref.json","description":"DEPRECATED discovery-only property filter. On compact discovery tasks use criteria.offer_filters.property_list to preserve product eligibility. Use targeting_overlay.property_list only when the buyer intends a delivery constraint, or required_overlay_support.property_list for future selectability. A facade MUST NOT convert this discovery filter into delivery targeting.","deprecated":true},"fields":{"type":"array","description":"Specific product fields to include in the response. When omitted, all fields are returned. Use for lightweight discovery calls where only a subset of product data is needed. product_id and name are always included. `format_ids` is a deprecated 3.x compatibility projection; new integrations request canonical `format_options`. Safety-critical request-specific fields override projection: Product.targeting_resolution and expires_at MUST be included whenever the seller returns modifications, overlay_support MUST be included when required_overlay_support was requested, media_buy_support MUST be included when required_media_buy_support or media_buy_frequency_cap was requested, list_applications MUST be included when a property or collection list is in the effective targeting, and audience_evidence_selections MUST be included when filters.audience_evidence_requirements affects eligibility or ranking. fields controls the optional audience_evidence payload, not either decision receipt. Response-level brief targeting confirmation is not a projected product field.","minItems":1,"items":{"anyOf":[{"$ref":"#/$defs/external:media-buy~1product-fields.json/items"},{"type":"string","enum":["format_ids","outcome_measurement","delivery_measurement","creative_policy","metric_optimization","conversion_tracking","data_provider_signals","included_signals","signal_targeting_options","overlay_support","media_buy_support","installments","is_custom","product_card","product_card_detailed","enforced_policies","trusted_match"]}]}},"time_budget":{"allOf":[{"$ref":"#/$defs/external:core~1duration.json"}],"description":"Maximum time the buyer will commit to this request. The seller returns the best results achievable within this budget and does not start processes (human approvals, expensive external queries) that cannot complete in time. When omitted, the seller decides timing."},"push_notification_config":{"$ref":"#/$defs/external:core~1push-notification-config.json","description":"Optional webhook configuration for async terminal completion/failure notifications on curated discovery. Meaningful only for `buying_mode: \"brief\"` and `buying_mode: \"refine\"` requests that enter the async lifecycle. Submitted envelopes with `task_id` remain pollable through `get_task_status` (legacy `tasks/get`) whether or not this field is present. If a brief/refine request includes this field and the seller returns a Submitted envelope, the seller MUST deliver at least the terminal completion/failure notification to the configured URL; intermediate progress notifications are MAY. If the seller cannot honor the webhook channel, it MUST reject the request with a structured error instead of silently accepting. This field does not change wholesale timing semantics: sellers MUST NOT route `buying_mode: \"wholesale\"` requests through the async/Submitted arm or emit async delivery solely because `push_notification_config` is present; partial wholesale completion is reported via `incomplete[]`."},"pagination":{"$ref":"#/$defs/external:core~1pagination-request.json","description":"Cursor-based pagination controls for get_products. Valid in all buying modes. In brief mode, pagination bounds the seller's returned products[] for the curated answer to the brief and is not an exhaustive catalog-enumeration contract. In refine mode, pagination bounds the refined products[] result implied by refine[] and filters; proposals may accompany a page as plan metadata but are not independently counted by this pagination envelope. In wholesale mode, pagination walks the wholesale product feed and may be combined with wholesale feed versioning."},"if_wholesale_feed_version":{"type":"string","description":"Opaque wholesale_feed_version token returned by a prior wholesale-mode get_products response from this agent. Only valid when buying_mode is wholesale. When provided, the seller compares against its current wholesale product feed version for the buyer's cache_scope and MAY return an unchanged: true response (with products omitted) if nothing has changed. The token is scope-keyed: buyers cache `(cache_scope, wholesale_feed_version)` pairs. Scoping dimensions: (agent, buying_mode, filters, targeting_overlay, media_buy_frequency_cap, required_overlay_support, required_media_buy_support, deprecated property_list, catalog) for cache_scope: 'public'; that tuple plus account identity for cache_scope: 'account'. pagination.cursor is NOT part of the scoping tuple. Backward-compatible: pre-v3.1 agents that ignore this field simply return the full payload, same as the unchanged-server path. See specs/wholesale-feed-webhooks.md for the full sync pattern."},"if_pricing_version":{"type":"string","description":"Opaque pricing_version token from a prior get_products response. MUST only be sent together with if_wholesale_feed_version — pricing version has no structural baseline to compare against on its own. Evaluation order: (1) if_wholesale_feed_version mismatch → seller returns the full payload (pricing is implicitly stale); (2) if_wholesale_feed_version matches but if_pricing_version mismatches → seller returns the full payload so the buyer sees updated pricing_options; (3) both match → seller MAY return unchanged: true. Agents that don't track pricing separately ignore if_pricing_version and fall back to if_wholesale_feed_version semantics. Useful for storefronts that re-price compositions far more often than they re-render product mirrors."},"context":{"$ref":"#/$defs/external:core~1context.json"},"required_policies":{"type":"array","items":{"type":"string"},"description":"Registry policy IDs that the buyer requires to be enforced for products in this response. Sellers filter products to only those that comply with or already enforce the requested policies."},"ext":{"$ref":"#/$defs/external:core~1ext.json"}},"required":["buying_mode"],"additionalProperties":true,"$defs":{"external:core/version-envelope.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/version-envelope.json","title":"AdCP Version Envelope","description":"Release-precision AdCP protocol version negotiation fields. Composed via `allOf` into AdCP request schemas and shared response components so the version semantics live in one place. Strict (`additionalProperties: false`) request schemas also redeclare these two fields in their own `properties` via `$ref`, because draft-07 does not evaluate properties across `allOf`. The Trusted Match match requests are the exception: they inline both fields for their strict privacy boundary. Distinct from `core/protocol-envelope.json`, which wraps responses at the transport layer (context_id / task_id / status / payload). This envelope is part of the payload itself.","type":"object","properties":{"adcp_version":{"type":"string","description":"Release-precision AdCP version (VERSION.RELEASE, e.g. \"3.0\", \"3.1\", \"3.1-beta\"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = \"3.1.0-beta.1\") MUST normalize to release-precision (\"3.1-beta.1\") before emitting on the wire — meta-field values are NOT valid wire values.","pattern":"^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?)?$","examples":["3.0","3.1","3.1-beta","3.1-rc.1"]},"adcp_major_version":{"type":"integer","deprecated":true,"x-removed-in":"4.0.0","description":"DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.","minimum":1,"maximum":99}}},"external:core/brand-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/brand-ref.json","title":"Brand Reference","description":"Reference to a brand by domain and optional brand_id. The domain hosts /.well-known/brand.json or is registered in the brand registry. For single-brand domains, brand_id can be omitted. For house-of-brands domains, brand_id identifies the specific brand. For creative production, brand.json is the canonical source of master brand identity (logo, palette, fonts, voice, and visual guidelines), subject only to the supported per-call fields in brand_kit_override. Catalogs supply product or item payload; catalog item asset groups, including property- or franchise-level logos, are item identity and do not override these master brand fields.","type":"object","properties":{"domain":{"type":"string","description":"Domain where /.well-known/brand.json is hosted, or the brand's operating domain","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"brand_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-id.json","description":"Brand identifier within the house portfolio. Optional for single-brand domains."},"countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1,"uniqueItems":true,"description":"Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting."},"industries":{"type":"array","items":{"type":"string"},"description":"Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json."},"data_subject_contestation":{"type":"object","description":"Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand → house → missing.","properties":{"url":{"type":"string","format":"uri","pattern":"^https://"},"email":{"type":"string","format":"email"},"languages":{"type":"array","items":{"type":"string"}}},"anyOf":[{"required":["url"]},{"required":["email"]}],"additionalProperties":false},"brand_kit_override":{"type":"object","description":"Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call — e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` — the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently — when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently — a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.","properties":{"logo":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1assets~1image-asset.json","description":"Override logo asset."},"colors":{"type":"object","description":"Override brand colors (hex strings).","properties":{"primary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"secondary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"additionalProperties":true},"voice":{"type":"string","description":"Override brand-voice description for surface-composed text/audio output."},"tagline":{"type":"string","description":"Override tagline."}},"additionalProperties":true}},"required":["domain"],"additionalProperties":false,"examples":[{"domain":"nova-brands.com","brand_id":"spark"},{"domain":"nova-brands.com","brand_id":"glow"},{"domain":"acme-corp.com"},{"domain":"nova-athletics.example","countries":["NL"]}]},"external:core/brand-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/brand-id.json","title":"Brand ID","description":"Identifier for a brand within a house portfolio. Must be lowercase alphanumeric with underscores only. The house chooses this identifier.","type":"string","pattern":"^[a-z0-9_]+$","x-entity":"advertiser_brand","examples":["tide","cheerios","air_jordan","nike","pampers"]},"external:core/assets/image-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/image-asset.json","title":"Image Asset","description":"Image asset with URL and dimensions","type":"object","properties":{"asset_type":{"type":"string","const":"image","description":"Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL to the image asset"},"width":{"type":"integer","minimum":1,"description":"Width in pixels"},"height":{"type":"integer","minimum":1,"description":"Height in pixels"},"file_size_bytes":{"type":"integer","minimum":1,"description":"Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint."},"pixel_ratio":{"type":"number","exclusiveMinimum":0,"description":"Intrinsic pixels per logical render pixel (for example `2` for a 600×500 image intended to render at 300×250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields."},"state_id":{"type":"string","description":"Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots."},"breakpoint_id":{"type":"string","description":"Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots."},"focal_point":{"type":"array","items":{"type":"number","minimum":0,"maximum":1},"minItems":2,"maxItems":2,"description":"Normalized `[x, y]` coordinates (0–1 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults."},"format":{"type":"string","description":"Image file format (jpg, png, gif, webp, etc.)"},"alt_text":{"type":"string","description":"Alternative text for accessibility","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url","width","height"],"additionalProperties":true},"external:core/provenance.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/provenance.json","title":"Provenance","description":"Declares how content was produced, whether AI was involved, and what disclosure obligations apply. Attaches to creative manifests, individual assets, or content-standards artifacts. When present at multiple levels, the most specific provenance object replaces the inherited one entirely (no field-level merging). Provenance is a claim by the declaring party — receiving parties should verify claims independently via their own detection tools.","type":"object","properties":{"digital_source_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1digital-source-type.json","description":"IPTC-aligned classification of AI involvement in producing this content"},"synthetic_depiction":{"type":"boolean","description":"Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`."},"ai_tool":{"type":"object","description":"AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.","properties":{"name":{"type":"string","description":"Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"},"version":{"type":"string","description":"Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version."},"provider":{"type":"string","description":"Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')"}},"required":["name"]},"human_oversight":{"type":"string","description":"Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` — the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.","enum":["none","prompt_only","selected","edited","directed"],"enumDescriptions":{"none":"Fully automated with no human involvement in generation","prompt_only":"Human provided the prompt or instructions but did not review outputs","selected":"Human selected from multiple AI-generated candidates","edited":"Human edited or refined AI-generated output","directed":"Human directed the creative process with AI as an assistive tool"}},"declared_by":{"type":"object","description":"Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent or service that declared this provenance"},"role":{"type":"string","enum":["creator","advertiser","agency","platform","tool"],"description":"Role of the declaring party in the supply chain","enumDescriptions":{"creator":"The party that created or generated the content","advertiser":"The brand or advertiser that owns the content","agency":"Agency acting on behalf of the advertiser","platform":"Ad platform or publisher that processed the content","tool":"Automated tool or service that attached provenance metadata"}}},"required":["role"]},"declared_at":{"type":"string","format":"date-time","description":"When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance."},"created_time":{"type":"string","format":"date-time","description":"When this content was created or generated (ISO 8601)"},"c2pa":{"type":"object","description":"C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.","properties":{"manifest_url":{"type":"string","format":"uri","description":"URL to the C2PA manifest store for this content"}},"required":["manifest_url"]},"embedded_provenance":{"type":"array","description":"Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).","minItems":1,"items":{"type":"object","properties":{"method":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1embedded-provenance-method.json","description":"How provenance data is carried within the content"},"standard":{"type":"string","description":"Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)"},"provider":{"type":"string","description":"Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context — not a wire identifier."},"verify_agent":{"type":"object","description":"Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing — the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."},"feature_id":{"type":"string","description":"Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog."}},"required":["agent_url"],"additionalProperties":false},"embedded_at":{"type":"string","format":"date-time","description":"When the provenance data was embedded (ISO 8601)"}},"required":["method","provider"]}},"watermarks":{"type":"array","description":"Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).","minItems":1,"items":{"type":"object","properties":{"media_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1watermark-media-type.json","description":"Media category of the watermarked content"},"provider":{"type":"string","description":"Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context — not a wire identifier."},"verify_agent":{"type":"object","description":"Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing — the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."},"feature_id":{"type":"string","description":"Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog."}},"required":["agent_url"],"additionalProperties":false},"c2pa_action":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1c2pa-watermark-action.json","description":"C2PA action classification for this watermark"},"embedded_at":{"type":"string","format":"date-time","description":"When the watermark was applied (ISO 8601)"}},"required":["media_type","provider"]}},"disclosure":{"type":"object","description":"Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.","properties":{"required":{"type":"boolean","description":"The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain — useful as a routing and audit input — not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."},"jurisdictions":{"type":"array","description":"Jurisdictions where disclosure obligations apply","items":{"type":"object","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"},"region":{"type":"string","description":"Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)"},"regulation":{"type":"string","description":"Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"},"label_text":{"type":"string","description":"Required disclosure label text for this jurisdiction, in the local language"},"render_guidance":{"type":"object","description":"How the disclosure should be rendered for this jurisdiction. Expresses the declaring party's intent for persistence and position based on regulatory requirements. Publishers control actual rendering but governance agents can audit whether guidance was followed.","minProperties":1,"properties":{"persistence":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1disclosure-persistence.json","description":"How long the disclosure must persist during content playback or display"},"min_duration_ms":{"type":"integer","minimum":1,"description":"Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial — without it, the duration is at the publisher's discretion. At serve time the publisher reads this from provenance since the brief is not available."},"positions":{"type":"array","description":"Preferred disclosure positions in priority order. The first position a format supports should be used.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1disclosure-position.json"},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}}}},"required":["country","regulation"]},"minItems":1}},"required":["required"]},"verification":{"type":"array","description":"Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.","minItems":1,"items":{"type":"object","properties":{"verified_by":{"type":"string","description":"Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"},"verified_time":{"type":"string","format":"date-time","description":"When the verification was performed (ISO 8601)"},"result":{"type":"string","enum":["authentic","ai_generated","ai_modified","inconclusive"],"description":"Verification outcome"},"confidence":{"type":"number","minimum":0,"maximum":1,"description":"Confidence score of the verification result (0.0 to 1.0)"},"details_url":{"type":"string","format":"uri","description":"URL to the full verification report"}},"required":["verified_by","result"]}},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}}},"external:enums/digital-source-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/digital-source-type.json","title":"Digital Source Type","description":"Classification of AI involvement in content creation, aligned with IPTC digitalsourcetype vocabulary. Used in provenance metadata to declare how a creative asset, artifact, or individual asset was produced.","type":"string","enum":["digital_capture","digital_creation","trained_algorithmic_media","composite_with_trained_algorithmic_media","algorithmic_media","composite_capture","composite_synthetic","human_edits","data_driven_media"],"enumDescriptions":{"digital_capture":"Captured by a digital device (camera, scanner, screen recording) with no AI involvement","digital_creation":"Created by a human using digital tools (Photoshop, Illustrator, After Effects) without AI generation","trained_algorithmic_media":"Generated entirely by a trained AI model (DALL-E, Midjourney, Stable Diffusion, Sora)","composite_with_trained_algorithmic_media":"Human-created content combined with AI-generated elements (e.g., photo with AI background)","algorithmic_media":"Produced by deterministic algorithms without machine learning (procedural generation, rule-based systems)","composite_capture":"Multiple digital captures composited together without AI","composite_synthetic":"Composite of multiple elements where at least one is AI-generated (e.g., stock photo composited with AI-generated background)","human_edits":"Content augmented, corrected, or enhanced by humans using non-generative tools","data_driven_media":"Assembled from structured data feeds (DCO templates, product catalogs, weather-triggered variants)"}},"external:enums/embedded-provenance-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/embedded-provenance-method.json","title":"Embedded Provenance Method","description":"How provenance data is carried within the content stream. Distinguishes between format-level manifest embedding (where the manifest travels inside the file container) and provenance markers (where invisible markers in the content itself encode or reference a provenance record). Both survive operations that strip sidecar metadata, but provenance markers additionally survive content-level transformations such as copy-paste, reformatting, and CMS re-encoding.","type":"string","enum":["manifest_wrapper","provenance_markers"],"enumDescriptions":{"manifest_wrapper":"A provenance manifest embedded in the file container per format-specific rules (e.g., JUMBF box in JPEG, C2PATextManifestWrapper in plaintext per C2PA Section A.7). The manifest travels with the file but is tied to the file's byte structure.","provenance_markers":"Invisible markers embedded within the content stream that encode or reference a provenance record. Designed to survive reformatting, copy-paste, CMS ingestion, and ad-server transcoding that breaks file-level bindings."}},"external:enums/watermark-media-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/watermark-media-type.json","title":"Watermark Media Type","description":"Media category of a content watermark. Identifies what kind of content the watermark is applied to, which determines the detection and verification methods required.","type":"string","enum":["audio","image","video","text"],"enumDescriptions":{"audio":"Watermark applied to audio content (e.g., spread-spectrum, echo hiding)","image":"Watermark applied to image content (e.g., spatial domain, frequency domain)","video":"Watermark applied to video content (e.g., per-frame image watermarking, temporal watermarking)","text":"Watermark applied to text content (e.g., synonym substitution, structural modification)"}},"external:enums/c2pa-watermark-action.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/c2pa-watermark-action.json","title":"C2PA Watermark Action","description":"C2PA action classification for a content watermark. Distinguishes watermarks that are cryptographically linked to a C2PA manifest (bound) from watermarks that exist independently (unbound). Aligns with the c2pa.watermarked.* action family in the C2PA action taxonomy.","type":"string","enum":["c2pa.watermarked.bound","c2pa.watermarked.unbound"],"enumDescriptions":{"c2pa.watermarked.bound":"Watermark linked to a C2PA manifest for this asset. The watermark and manifest are mutually reinforcing: the manifest references the watermark, and the watermark can be used to locate the manifest.","c2pa.watermarked.unbound":"Watermark independent of any C2PA manifest. Applied before any provenance signing event (e.g., by the AI generator at creation time) or in pipelines where no manifest is present."}},"external:enums/disclosure-persistence.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/disclosure-persistence.json","title":"Disclosure Persistence","description":"How long a disclosure must persist during content playback or display. Different jurisdictions and regulations require different persistence behaviors for AI-generated content labels. When multiple sources specify persistence for the same jurisdiction (e.g., brief and provenance), the most restrictive mode applies: continuous > initial > flexible.","type":"string","enum":["continuous","initial","flexible"],"enumDescriptions":{"continuous":"Disclosure must remain visible or audible throughout the entire content display duration. For video and audio, this means the full playback duration. For static formats (display, DOOH), this means the full display slot. For DOOH specifically, 'content duration' means the ad's display slot within the rotation, not the screen's full rotation cycle.","initial":"Disclosure must appear at the start of content for a minimum duration before it may be removed. Pair with min_duration_ms in render_guidance or creative brief to specify the required duration.","flexible":"Disclosure presence is sufficient; placement timing and duration are at the publisher's discretion"}},"external:enums/disclosure-position.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/disclosure-position.json","title":"Disclosure Position","description":"Where a required disclosure should appear within a creative. Used by creative briefs to specify disclosure placement and by formats to declare which positions they can render.","type":"string","enum":["prominent","footer","audio","subtitle","overlay","end_card","pre_roll","companion"]},"external:core/ext.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/ext.json","title":"Extension Object","description":"Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.","type":"object","additionalProperties":true},"external:media-buy/acceptance-context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/media-buy/acceptance-context.json","title":"Acceptance Context","description":"Buyer-declared facts used for coarse seller acceptance matching during product and proposal discovery. Sellers may infer omitted facts, but uncertainty never implies acceptance.","type":"object","properties":{"subjects":{"type":"array","items":{"type":"object","properties":{"subject_category":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","x-entity":"governance_policy_category"},"subject_facets":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","x-entity":"governance_policy_category_facet"},"minItems":1,"uniqueItems":true}},"required":["subject_category"],"additionalProperties":false},"minItems":1},"advertiser_roles":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"minItems":1,"uniqueItems":true},"advertiser_industry":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1advertiser-industry.json"},"advertiser_jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1,"uniqueItems":true,"description":"Jurisdictions in which the advertiser is established or legally organized. This is distinct from where an ad will be delivered."},"delivery_jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1,"uniqueItems":true,"description":"Jurisdictions in which the proposed advertising will be delivered. Seller acceptance rules' jurisdictions and jurisdiction_groups match this field."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"x-adcp-validation":{"unique_by":[{"path":"subjects","field":"subject_category"}]},"minProperties":1,"additionalProperties":false},"external:enums/advertiser-industry.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/advertiser-industry.json","title":"Advertiser Industry","description":"Standardized advertiser industry classification. Top-level categories classify the advertiser's primary business. Dot-notation subcategories (e.g., 'media_entertainment.podcasts') provide platform-specific precision where needed. Sellers map these to platform-native codes (Spotify ADV categories, LinkedIn industry IDs, IAB Content Taxonomy, etc.). Sellers MUST accept unknown values gracefully — treat unrecognized values as the parent category (strip the subcategory) or as uncategorized. This ensures forward compatibility as the taxonomy evolves.","type":"string","x-extensible":true,"x-pattern":"^[a-z][a-z0-9_]+(\\.[a-z][a-z0-9_]+)?$","enum":["automotive","automotive.electric_vehicles","automotive.parts_accessories","automotive.luxury","beauty_cosmetics","beauty_cosmetics.skincare","beauty_cosmetics.fragrance","beauty_cosmetics.haircare","cannabis","cpg","cpg.personal_care","cpg.household","dating","education","education.higher_education","education.online_learning","education.k12","energy_utilities","energy_utilities.renewable","fashion_apparel","fashion_apparel.luxury","fashion_apparel.sportswear","finance","finance.banking","finance.insurance","finance.investment","finance.cryptocurrency","food_beverage","food_beverage.alcohol","food_beverage.restaurants","food_beverage.packaged_goods","gambling_betting","gambling_betting.sports_betting","gambling_betting.casino","gaming","gaming.mobile","gaming.console_pc","gaming.esports","government_nonprofit","government_nonprofit.political","government_nonprofit.charity","healthcare","healthcare.pharmaceutical","healthcare.medical_devices","healthcare.wellness","home_garden","home_garden.furniture","home_garden.home_improvement","media_entertainment","media_entertainment.podcasts","media_entertainment.music","media_entertainment.film_tv","media_entertainment.publishing","media_entertainment.live_events","pets","professional_services","professional_services.legal","professional_services.consulting","real_estate","real_estate.residential","real_estate.commercial","recruitment_hr","retail","retail.ecommerce","retail.department_stores","sports_fitness","sports_fitness.equipment","sports_fitness.teams_leagues","technology","technology.software","technology.hardware","technology.ai_ml","telecom","telecom.mobile_carriers","telecom.internet_providers","transportation_logistics","travel_hospitality","travel_hospitality.airlines","travel_hospitality.hotels","travel_hospitality.cruise","travel_hospitality.tourism"],"enumDescriptions":{"automotive":"Automotive manufacturers, dealerships, and auto industry","automotive.electric_vehicles":"Electric vehicle manufacturers and charging infrastructure","automotive.parts_accessories":"Auto parts, accessories, and aftermarket products","automotive.luxury":"Luxury and premium automotive brands","beauty_cosmetics":"Beauty, cosmetics, and prestige skincare brands. Distinct from cpg.personal_care — use beauty_cosmetics for brands whose identity is rooted in beauty (L'Oreal Paris, Estee Lauder, Sephora) and cpg.personal_care for mass-market personal hygiene (Dove, Colgate)","beauty_cosmetics.skincare":"Skincare brands and dermatological products","beauty_cosmetics.fragrance":"Perfume and fragrance brands","beauty_cosmetics.haircare":"Professional and prestige haircare brands","cannabis":"Cannabis products and dispensaries. Subject to heavy platform restrictions — most platforms require explicit category declaration for ad acceptance","cpg":"Consumer packaged goods — mass-market products sold through retail. For food and beverage manufacturers, use food_beverage. For prestige beauty, use beauty_cosmetics","cpg.personal_care":"Mass-market personal care and hygiene products (deodorant, toothpaste, soap). For prestige beauty brands, use beauty_cosmetics","cpg.household":"Household cleaning and maintenance products","dating":"Dating apps and matchmaking services. Subject to platform restrictions similar to gambling_betting","education":"Educational institutions and learning services","education.higher_education":"Universities, colleges, and graduate programs","education.online_learning":"Online courses, MOOCs, and digital education platforms","education.k12":"Primary and secondary education","energy_utilities":"Energy companies and utilities","energy_utilities.renewable":"Renewable energy, solar, wind, and clean technology","fashion_apparel":"Clothing, footwear, and fashion accessories","fashion_apparel.luxury":"Luxury fashion and designer brands","fashion_apparel.sportswear":"Athletic and sportswear brands","finance":"Financial services, banking, and insurance","finance.banking":"Retail and commercial banking","finance.insurance":"Insurance products and services","finance.investment":"Investment, wealth management, and brokerage","finance.cryptocurrency":"Cryptocurrency exchanges and blockchain financial products","food_beverage":"Food and beverage companies — manufacturers (Coca-Cola, Nestle), restaurants, and alcohol brands. For non-food packaged goods, use cpg","food_beverage.alcohol":"Alcoholic beverages (beer, wine, spirits). Subject to platform age-gating and regional restrictions","food_beverage.restaurants":"Restaurants, fast food, and food delivery","food_beverage.packaged_goods":"Packaged food and non-alcoholic beverages","gambling_betting":"Gambling, sports betting, and wagering. Subject to heavy platform restrictions — most platforms require explicit category declaration","gambling_betting.sports_betting":"Sports betting and daily fantasy sports","gambling_betting.casino":"Online casinos and traditional gambling","gaming":"Video games and interactive entertainment","gaming.mobile":"Mobile gaming","gaming.console_pc":"Console and PC gaming","gaming.esports":"Esports teams, tournaments, and streaming","government_nonprofit":"Government agencies and nonprofit organizations","government_nonprofit.political":"Political advertising and advocacy. Subject to platform transparency and disclosure requirements","government_nonprofit.charity":"Charitable organizations and fundraising","healthcare":"Healthcare, pharmaceuticals, and medical","healthcare.pharmaceutical":"Pharmaceutical and biotech companies. Subject to platform restrictions on drug advertising","healthcare.medical_devices":"Medical devices and health technology","healthcare.wellness":"Wellness, supplements, and alternative health","home_garden":"Home furnishing, improvement, and garden","home_garden.furniture":"Furniture and home decor","home_garden.home_improvement":"Home improvement, tools, and renovation","media_entertainment":"Media, entertainment, and content","media_entertainment.podcasts":"Podcast networks and podcast-first brands","media_entertainment.music":"Music labels, streaming, and artists","media_entertainment.film_tv":"Film studios, TV networks, and streaming services","media_entertainment.publishing":"Book publishers, magazines, and digital publications","media_entertainment.live_events":"Concerts, festivals, and live entertainment","pets":"Pet food, supplies, and veterinary services","professional_services":"Professional and business services","professional_services.legal":"Law firms and legal services","professional_services.consulting":"Management and business consulting","real_estate":"Real estate, property, and construction","real_estate.residential":"Residential real estate and housing","real_estate.commercial":"Commercial real estate and property management","recruitment_hr":"Job boards, staffing agencies, and HR technology","retail":"Retail stores and e-commerce","retail.ecommerce":"Online-first retailers and marketplaces","retail.department_stores":"Department stores and multi-brand retailers","sports_fitness":"Sports, fitness, and athletics","sports_fitness.equipment":"Sports and fitness equipment","sports_fitness.teams_leagues":"Professional sports teams and leagues","technology":"Technology companies and digital services","technology.software":"Software products, platforms, and SaaS","technology.hardware":"Consumer electronics and hardware","technology.ai_ml":"Artificial intelligence and machine learning companies","telecom":"Telecommunications and connectivity","telecom.mobile_carriers":"Mobile network operators","telecom.internet_providers":"Internet service providers and broadband","transportation_logistics":"Shipping, logistics, and freight services","travel_hospitality":"Travel, hospitality, and tourism","travel_hospitality.airlines":"Airlines and air travel","travel_hospitality.hotels":"Hotels, resorts, and accommodation","travel_hospitality.cruise":"Cruise lines and ocean travel","travel_hospitality.tourism":"Tourism boards and travel agencies"}},"external:core/catalog.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/catalog.json","title":"Catalog","description":"A typed data feed. Catalogs carry the items, locations, stock levels, or pricing that publishers use to render ads. They can be synced to a platform via sync_catalogs (managed lifecycle with approval), provided inline, or fetched from an external URL. The catalog type determines the item schema and can be structural (offering, product, inventory, store, promotion) or vertical-specific (hotel, flight, job, vehicle, real_estate, education, destination, app). Selectors (ids, tags, category, query) filter items regardless of sourcing method.","type":"object","properties":{"catalog_id":{"type":"string","description":"Buyer's identifier for this catalog. Required when syncing via sync_catalogs. When used in creatives, references a previously synced catalog on the account.","x-entity":"catalog"},"name":{"type":"string","description":"Human-readable name for this catalog (e.g., 'Summer Products 2025', 'Amsterdam Store Locations')."},"type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1catalog-type.json","description":"Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema."},"url":{"type":"string","format":"uri","description":"URL to an external catalog feed. The platform fetches and resolves items from this URL. For offering-type catalogs, the feed contains an array of Offering objects. For other types, the feed format is determined by feed_format. When omitted with type 'product', the platform uses its synced copy of the brand's product catalog."},"feed_format":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1feed-format.json","description":"Format of the external feed at url. Required when url points to a non-AdCP feed (e.g., Google Merchant Center XML, Meta Product Catalog). Omit for offering-type catalogs where the feed is native AdCP JSON."},"update_frequency":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1update-frequency.json","description":"How often the platform should re-fetch the feed from url. Only applicable when url is provided. Platforms may use this as a hint for polling schedules."},"items":{"type":"array","description":"Inline catalog data. The item schema depends on the catalog type: Offering objects for 'offering', StoreItem for 'store', HotelItem for 'hotel', FlightItem for 'flight', JobItem for 'job', VehicleItem for 'vehicle', RealEstateItem for 'real_estate', EducationItem for 'education', DestinationItem for 'destination', AppItem for 'app', or freeform objects for 'product', 'inventory', and 'promotion'. Mutually exclusive with url — provide one or the other, not both. Implementations should validate items against the type-specific schema.","items":{"type":"object"},"minItems":1},"ids":{"type":"array","description":"Filter catalog to exact canonical item keys. The key field is offering_id for offering, store_id for store, hotel_id for hotel, flight_id for flight, job_id for job, vehicle_id for vehicle, listing_id for real_estate, program_id for education, destination_id for destination, and app_id for app. Product, inventory, and promotion catalogs use the stable normalized source identifier retained during ingestion (for example a retailer SKU). The same canonical key is used by catalog availability item_id.","items":{"type":"string"},"minItems":1},"gtins":{"type":"array","description":"Filter product-type catalogs by GTIN identifiers for cross-retailer catalog matching. Accepts standard GTIN formats (GTIN-8, UPC-A/GTIN-12, EAN-13/GTIN-13, GTIN-14). Only applicable when type is 'product'.","items":{"type":"string","pattern":"^[0-9]{8,14}$"},"minItems":1},"tags":{"type":"array","description":"Filter catalog to items with these tags. Tags are matched using OR logic — items matching any tag are included.","items":{"type":"string"},"minItems":1},"category":{"type":"string","description":"Filter catalog to items in this category (e.g., 'beverages/soft-drinks', 'chef-positions')."},"query":{"type":"string","description":"Natural language filter for catalog items (e.g., 'all pasta sauces under $5', 'amsterdam vacancies')."},"conversion_events":{"type":"array","description":"Event types that represent conversions for items in this catalog. Declares what events the platform should attribute to catalog items — e.g., a job catalog converts via submit_application, a product catalog via purchase. The event's content_ids field carries the item IDs that connect back to catalog items. Use content_id_type to declare what identifier type content_ids values represent.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1event-type.json"},"minItems":1,"uniqueItems":true},"content_id_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1content-id-type.json","description":"Identifier type that the event's content_ids field should be matched against for items in this catalog. For example, 'gtin' means content_ids values are Global Trade Item Numbers, 'sku' means retailer SKUs. Omit when using a custom identifier scheme not listed in the enum."},"feed_field_mappings":{"type":"array","description":"Declarative normalization rules for external feeds. Maps non-standard feed field names, date formats, price encodings, and image URLs to the AdCP catalog item schema. Applied during sync_catalogs ingestion. Supports field renames, named transforms (date, divide, boolean, split), static literal injection, and assignment of image URLs to typed asset pools.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1catalog-field-mapping.json"},"minItems":1}},"required":["type"],"additionalProperties":true,"examples":[{"description":"Synced product catalog from Google Merchant Center","data":{"catalog_id":"gmc-primary","name":"Primary Product Feed","type":"product","url":"https://feeds.acmecorp.com/products.xml","feed_format":"google_merchant_center","update_frequency":"daily"}},{"description":"Inventory feed for store-level stock data","data":{"catalog_id":"store-inventory","name":"Store Inventory","type":"inventory","url":"https://feeds.acmecorp.com/inventory.json","feed_format":"custom","update_frequency":"hourly"}},{"description":"Store locator feed","data":{"catalog_id":"retail-locations","name":"Retail Locations","type":"store","url":"https://feeds.acmecorp.com/stores.json","feed_format":"custom","update_frequency":"weekly"}},{"description":"Promotional pricing feed","data":{"catalog_id":"summer-sale","name":"Summer Sale Promotions","type":"promotion","url":"https://feeds.acmecorp.com/promotions.json","feed_format":"google_merchant_center","update_frequency":"daily"}},{"description":"Inline offering catalog (no sync needed)","data":{"type":"offering","items":[{"offering_id":"summer-sale","name":"Summer Sale","landing_url":"https://acme.com/summer"}]}},{"description":"Reference to a previously synced catalog by ID","data":{"catalog_id":"gmc-primary","type":"product","ids":["SKU-12345","SKU-67890"]}},{"description":"Product catalog with GTIN cross-retailer matching and attribution","data":{"type":"product","gtins":["00013000006040","00013000006057"],"content_id_type":"gtin","conversion_events":["purchase","add_to_cart"]}},{"description":"Inline store catalog with catchment areas","data":{"catalog_id":"retail-locations","name":"Retail Locations","type":"store","items":[{"store_id":"amsterdam-flagship","name":"Amsterdam Flagship","location":{"lat":52.3676,"lng":4.9041},"catchments":[{"catchment_id":"walk","travel_time":{"value":10,"unit":"min"},"transport_mode":"walking"},{"catchment_id":"drive","travel_time":{"value":15,"unit":"min"},"transport_mode":"driving"}]}]}}]},"external:enums/catalog-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/catalog-type.json","title":"Catalog Type","description":"The type of catalog feed. Determines the item schema and how the platform resolves catalog items. Multiple catalog types can be synced to the same account and referenced together in creatives.","type":"string","enum":["offering","product","inventory","store","promotion","hotel","flight","job","vehicle","real_estate","education","destination","app"]},"external:enums/feed-format.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/feed-format.json","title":"Feed Format","description":"Catalog feed formats. Determines how the platform (seller) parses items from an external feed URL. Each named value is an externally-documented feed specification a seller parses natively without buyer-supplied feed_field_mappings; values are vendor spec names (proper nouns), not semantic categories. Use `custom` + feed_field_mappings for any feed whose shape is not one of the named formats.","type":"string","enum":["google_merchant_center","facebook_catalog","shopify","linkedin_jobs","tiktok_shop","pinterest_catalog","openai_product_feed","custom"],"enumDescriptions":{"google_merchant_center":"Google Merchant Center / Google Shopping product data specification — the de-facto e-commerce product-feed lingua franca that the other named commerce formats derive from.","facebook_catalog":"Meta (Facebook / Instagram) product catalog feed — a Google-Merchant-Center-derived dialect, the closest clone of the GMC field set.","shopify":"Shopify product feed export.","linkedin_jobs":"LinkedIn job-posting feed (XML).","tiktok_shop":"TikTok Shop product catalog feed — a GMC-derived dialect with material deltas (sku_id as the primary identifier rather than id, and a first-class video_link) that a GMC parser keyed on id would mis-parse.","pinterest_catalog":"Pinterest product catalog feed — a GMC-derived dialect with stricter serialization (composite-encoded price and shipping, a mandatory google_product_category, space-delimited availability enums) that a strict GMC parser would mis-handle.","openai_product_feed":"OpenAI Commerce product feed for ChatGPT shopping — a GMC-derived dialect adding ChatGPT-specific eligibility flags (is_eligible_search / is_eligible_checkout / is_eligible_ads). Spec: https://developers.openai.com/commerce/specs/file-upload/products","custom":"A feed whose shape is not one of the named formats above. The buyer MUST supply feed_field_mappings to normalize it to the AdCP catalog item schema."}},"external:enums/update-frequency.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/update-frequency.json","title":"Update Frequency","description":"Frequency of product catalog updates","type":"string","enum":["realtime","hourly","daily","weekly"]},"external:enums/event-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/event-type.json","title":"Event Type","description":"Standard marketing event types for event logging, aligned with IAB ECAPI","type":"string","enum":["page_view","view_content","select_content","select_item","search","share","add_to_cart","remove_from_cart","viewed_cart","add_to_wishlist","initiate_checkout","add_payment_info","purchase","refund","lead","qualify_lead","close_convert_lead","disqualify_lead","complete_registration","subscribe","follow","content_view","watch_milestone","start_trial","app_install","app_launch","contact","schedule","donate","submit_application","custom"],"enumDescriptions":{"page_view":"User viewed a page","view_content":"User viewed specific content (product, article, etc.)","select_content":"User selected or clicked on content (article, video, etc.)","select_item":"User selected a specific product or item from a list","search":"User performed a search","share":"User shared content via social or messaging","add_to_cart":"User added an item to cart","remove_from_cart":"User removed an item from cart","viewed_cart":"User viewed their shopping cart","add_to_wishlist":"User added an item to a wishlist","initiate_checkout":"User started checkout process","add_payment_info":"User added payment information","purchase":"User completed a purchase","refund":"A purchase was fully or partially refunded (adjusts ROAS)","lead":"User expressed interest (form submission, signup, etc.)","qualify_lead":"Lead qualified by sales or scoring criteria","close_convert_lead":"Lead converted to a customer or closed deal","disqualify_lead":"Lead disqualified or marked as not viable","complete_registration":"User completed account registration","subscribe":"User started a paid subscription or paid membership","follow":"User made a free, durable opt-in to an account, channel, feed, list, podcast, or similar owned property","content_view":"User meaningfully consumed a content unit, such as a watch, listen, stream, episode play, or read","watch_milestone":"User reached a content progress threshold, such as 25%, 50%, 75%, 100%, or a seconds-viewed milestone","start_trial":"User started a free trial","app_install":"User installed an application","app_launch":"User launched an application","contact":"User initiated contact (call, message, etc.)","schedule":"User scheduled an appointment or event","donate":"User made a donation","submit_application":"User submitted an application (loan, job, etc.)","custom":"Custom event type (specify in custom_event_name)"}},"external:enums/content-id-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/content-id-type.json","title":"Content ID Type","description":"Identifier type used in content_ids on conversion events to match back to catalog items. Omit when the identifier type is custom or not listed here.","type":"string","enum":["sku","gtin","offering_id","job_id","hotel_id","flight_id","vehicle_id","listing_id","store_id","program_id","destination_id","app_id"]},"external:core/catalog-field-mapping.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/catalog-field-mapping.json","title":"Catalog Field Mapping","description":"Declares how a field in an external feed maps to the AdCP catalog item schema. Used in sync_catalogs feed_field_mappings to normalize non-AdCP feeds (Google Merchant Center, LinkedIn Jobs XML, hotel XML, etc.) to the standard catalog item schema without requiring the buyer to preprocess every feed. Multiple mappings can assemble a nested object via dot notation (e.g., separate mappings for price.amount and price.currency).","type":"object","properties":{"feed_field":{"type":"string","description":"Field name in the external feed record. Omit when injecting a static literal value (use the value property instead)."},"catalog_field":{"type":"string","description":"Target field on the catalog item schema, using dot notation for nested fields (e.g., 'name', 'price.amount', 'location.city'). Mutually exclusive with asset_group_id."},"asset_group_id":{"type":"string","description":"Places the feed field value (a URL) into a typed asset pool on the catalog item's assets array. The value is wrapped as an image or video asset in a group with this ID. Use standard group IDs: 'images_landscape', 'images_vertical', 'images_square', 'logo', 'video'. Mutually exclusive with catalog_field."},"value":{"description":"Static literal value to inject into catalog_field for every item, regardless of what the feed contains. Mutually exclusive with feed_field. Useful for fields the feed omits (e.g., currency when price is always USD, or a constant category value)."},"transform":{"type":"string","description":"Named transform to apply to the feed field value before writing to the catalog schema. See transform-specific parameters (format, timezone, by, separator).","enum":["date","divide","boolean","split"]},"format":{"type":"string","description":"For transform 'date': the input date format string (e.g., 'YYYYMMDD', 'MM/DD/YYYY', 'DD-MM-YYYY'). Output is always ISO 8601 (e.g., '2025-03-01'). Uses Unicode date pattern tokens."},"timezone":{"type":"string","description":"For transform 'date': the timezone of the input value. IANA timezone identifier (e.g., 'UTC', 'America/New_York', 'Europe/Amsterdam'). Defaults to UTC when omitted."},"by":{"type":"number","description":"For transform 'divide': the divisor to apply (e.g., 100 to convert integer cents to decimal dollars).","exclusiveMinimum":0},"separator":{"type":"string","description":"For transform 'split': the separator character or string to split on. Defaults to ','.","default":","},"default":{"description":"Fallback value to use when feed_field is absent, null, or empty. Applied after any transform would have been applied. Allows optional feed fields to have a guaranteed baseline value."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"allOf":[{"not":{"required":["feed_field","value"]}},{"not":{"required":["catalog_field","asset_group_id"]}}],"additionalProperties":true,"examples":[{"description":"Simple field rename","data":{"feed_field":"hotel_name","catalog_field":"name"}},{"description":"Date format transform — YYYYMMDD to ISO 8601","data":{"feed_field":"available_from","catalog_field":"valid_from","transform":"date","format":"YYYYMMDD","timezone":"UTC"}},{"description":"Divide cents to dollars","data":{"feed_field":"price_cents","catalog_field":"price.amount","transform":"divide","by":100}},{"description":"Static literal injection — currency not in feed","data":{"catalog_field":"price.currency","value":"USD"}},{"description":"Image URL assigned to typed asset pool","data":{"feed_field":"primary_photo_url","asset_group_id":"images_landscape"}},{"description":"Vertical photo URL assigned to vertical pool","data":{"feed_field":"portrait_photo_url","asset_group_id":"images_vertical"}},{"description":"Split comma-separated tags to array","data":{"feed_field":"amenity_list","catalog_field":"amenities","transform":"split","separator":","}},{"description":"Boolean coercion with default","data":{"feed_field":"is_available","catalog_field":"available","transform":"boolean","default":false}}]},"external:core/account-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/account-ref.json","title":"Account Reference","description":"Reference to an advertiser account by seller-assigned ID or natural key. account_id is the seller/storefront handle returned by list_accounts. The natural key is brand + operator + optional operator_unit.id + optional fixed currency + optional buyer-selected account timezone + sandbox; it describes the advertiser object the seller resolves or provisions. After a capability-gated identity rekey, the former natural key is tombstoned and returns ACCOUNT_MOVED to authorized callers rather than resolving or provisioning another account. brand.countries qualifies the advertiser's geographic identity. operator_unit identifies the operator-owned buying seat or business unit and is distinct from the seller account. operator_unit.name is display metadata and does not participate in identity. Use account_id when the seller or upstream platform owns the canonical account namespace; use the natural key for buyer-declared accounts (require_operator_auth: false).","type":"object","oneOf":[{"properties":{"account_id":{"type":"string","description":"Seller-assigned account identifier. For upstream-managed account namespaces, this value comes from list_accounts; for seller-defined namespaces without a list_accounts surface, it is supplied out-of-band. Buyer-declared account sellers MAY echo account_id from sync_accounts as an internal handle, but they MUST continue accepting the account's current natural-key AccountRef on subsequent calls. Buyers of buyer-declared accounts send the natural key; a seller MAY also accept its echoed account_id, and buyers MUST NOT assume it does. A former key tombstoned by identity reconciliation returns ACCOUNT_MOVED to authorized callers.","x-entity":"account"}},"required":["account_id"],"additionalProperties":false},{"properties":{"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Brand reference identifying the advertiser"},"operator":{"type":"string","description":"Domain of the entity operating on the brand's behalf. When the brand operates directly, this is the brand's domain.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","x-entity":"operator"},"operator_unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1operator-unit.json","description":"Optional operator-owned business unit, agency seat, or platform account. Only id participates in the natural account key; name is mutable display metadata."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Immutable ISO 4217 transaction currency when the seller's advertiser object is currency-bound. When present, this is part of the natural account key and media buys on the account MUST use it. Omit when currency is selected independently per media buy."},"timezone":{"type":"string","minLength":1,"description":"Immutable account timezone. Include it in the natural key when get_adcp_capabilities.account.timezone declares account_fixed with buyer_selected; omit it for seller_fixed or seller_assigned accounts."},"sandbox":{"type":"boolean","description":"When true, references the sandbox account for this brand/operator pair. Defaults to false (production account).","default":false}},"required":["brand","operator"],"additionalProperties":false}],"examples":[{"account_id":"acc_acme_001"},{"brand":{"domain":"acme-corp.com"},"operator":"acme-corp.com"},{"brand":{"domain":"nova-brands.com","brand_id":"spark"},"operator":"pinnacle-media.com"},{"brand":{"domain":"nova-athletics.example","countries":["NL"]},"operator":"nova-athletics.example","operator_unit":{"id":"234284238","name":"Nova EMEA"},"currency":"EUR","timezone":"Europe/Amsterdam"},{"brand":{"domain":"acme-corp.com"},"operator":"acme-corp.com","sandbox":true}]},"external:core/operator-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/operator-unit.json","title":"Operator Unit","description":"Operator-owned buying context used to distinguish business units, agency seats, or platform accounts beneath one operator domain. The id is stable identity in the operator's namespace; name is mutable display metadata and never participates in account identity.","x-entity":"operator_unit","type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*$","description":"Stable identifier assigned by the operator. Numeric platform IDs and durable slugs are both valid. Scoped by the enclosing operator domain."},"name":{"type":"string","minLength":1,"maxLength":200,"description":"Human-readable seat or business-unit name, such as Nova EMEA. This label may change and is not part of the natural account key."}},"required":["id"],"additionalProperties":false,"examples":[{"id":"234284238","name":"Nova EMEA"},{"id":"benelux-seat","name":"Nova Benelux"}]},"external:enums/delivery-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/delivery-type.json","title":"Delivery Type","description":"Type of inventory delivery","type":"string","enum":["guaranteed","non_guaranteed"],"enumDescriptions":{"guaranteed":"Reserved inventory with guaranteed delivery","non_guaranteed":"Inventory without reserved or guaranteed delivery, commonly auction-based or otherwise best-effort. Do not use for scheduled broadcast buys solely because final audience delivery is estimated from historical ranges or settles through third-party measurement."}},"external:core/product-filters.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/product-filters.json","title":"Product Filters","description":"Structured offer filters for discovery. Filters decide which products may be returned based on metadata, commercial fit, availability assumptions, dates, budget, and reporting support; they do not become package delivery targeting. targeting_overlay constrains eligible delivery. Legacy targeting-like fields remain accepted during migration but are deprecated.","type":"object","properties":{"delivery_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1delivery-type.json"},"exclusivity":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1exclusivity.json","description":"Filter by exclusivity level. Returns products matching the specified exclusivity (e.g., 'exclusive' returns only sole-sponsorship products)."},"is_fixed_price":{"type":"boolean","description":"Legacy filter for fixed versus auction pricing availability. true returns options with fixed_price; false returns auction options whose price is established through bid_price. Contingent options such as revenue_share match neither value and MUST be omitted whenever this filter is present. Use pricing_structures to discover contingent pricing. Products with both fixed and auction options match both true and false, but sellers MUST return only entries matching the requested structure."},"pricing_structures":{"type":"array","description":"Filter by how the payable price is determined. fixed selects options with fixed_price, auction selects options established through bid_price, and contingent selects options calculated from a measured business outcome after delivery (currently revenue_share). Products match when at least one pricing option has a requested structure. Sellers MUST return only matching pricing_options entries. When combined with is_fixed_price, both filters apply and the returned entries must satisfy both.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1pricing-structure.json"},"minItems":1,"uniqueItems":true,"x-canonicalization":"set"},"pricing_currencies":{"type":"array","description":"Filter by currencies the buyer can use for the media product transaction, using ISO 4217 currency codes. Products match when they offer at least one product-level pricing_options entry in one of the requested currencies and any seller-applied or otherwise mandatory product-scoped signal charges are satisfiable in one of those currencies or have no incremental price. Mandatory custom signal pricing without currency is not satisfiable for this filter unless the seller can truthfully treat it as having no incremental price. Sellers MUST return only product pricing_options entries whose currency is in this list so buyers can select deterministically from discovery. This filter does not require pruning optional signal or vendor add-on pricing; buyers should avoid optional add-ons priced only in unsupported currencies.","items":{"type":"string","description":"ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP')","pattern":"^[A-Z]{3}$"},"minItems":1,"uniqueItems":true,"x-canonicalization":"set"},"format_ids":{"type":"array","deprecated":true,"x-removed-in":"4.0.0","description":"Deprecated in AdCP 3.2; removed in AdCP 4.0. Filter by legacy named-format references. Use `format_kinds` or `format_option_refs`.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1format-id.json"},"minItems":1},"format_kinds":{"type":"array","description":"Filter to products accepting any of these canonical format kinds.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1canonical-format-kind.json"},"minItems":1,"uniqueItems":true,"x-canonicalization":"set"},"format_option_refs":{"type":"array","description":"Filter to products accepting any of these exact publisher- or product-scoped canonical format options.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1format-option-ref.json"},"minItems":1,"uniqueItems":true,"x-canonicalization":"set"},"standard_formats_only":{"type":"boolean","description":"Only return products accepting IAB standard formats"},"min_exposures":{"type":"integer","description":"Minimum exposures/impressions needed for measurement validity","minimum":1},"start_date":{"type":"string","format":"date","description":"Campaign start date (ISO 8601 date format: YYYY-MM-DD) for availability checks"},"end_date":{"type":"string","format":"date","description":"Campaign end date (ISO 8601 date format: YYYY-MM-DD) for availability checks"},"budget_range":{"type":"object","description":"Budget range to filter appropriate products","properties":{"min":{"type":"number","description":"Minimum budget amount","minimum":0},"max":{"type":"number","description":"Maximum budget amount","minimum":0},"currency":{"type":"string","description":"ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP')","pattern":"^[A-Z]{3}$"}},"required":["currency"],"anyOf":[{"required":["min"]},{"required":["max"]}],"additionalProperties":true},"countries":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.countries. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"regions":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.regions. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]+$"},"minItems":1},"metros":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.metros. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json","description":"Metro classification system"},"code":{"type":"string","description":"Metro code within the system (e.g., '501' for NYC DMA)"}},"required":["system","code"],"additionalProperties":false},"minItems":1},"channels":{"type":"array","description":"Filter by advertising channels (e.g., ['display', 'ctv', 'dooh'])","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1channels.json"},"minItems":1},"video_placement_types":{"type":"array","description":"Filter product metadata by declared video placement types, using IAB Tech Lab/OpenRTB 2.6 video.plcmt definitions with AdCP-native names. A product matches when its declared array intersects the requested array. This is discovery classification only and does not promise delivery exclusively on a requested type; buyers needing exact placement inventory use targeting_overlay.placement_selection against targetable placements. This filter has set semantics for wholesale feed canonicalization.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1video-placement-type.json"},"uniqueItems":true,"minItems":1,"x-canonicalization":"set"},"audio_distribution_types":{"type":"array","description":"Filter product metadata by declared audio distribution types, using IAB Tech Lab/OpenRTB 2.6 audio.feed definitions with AdCP-native names. A product matches when its declared array intersects the requested array. This is discovery classification only and does not promise delivery exclusively on a requested type. This filter has set semantics for wholesale feed canonicalization.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audio-distribution-type.json"},"uniqueItems":true,"minItems":1,"x-canonicalization":"set"},"sponsored_placement_types":{"type":"array","description":"Filter retail-media product metadata by declared sponsored-placement types (sponsored search, sponsored display, or sponsored native). A product matches when its declared array intersects the requested array. This is discovery classification only and does not promise delivery exclusively on a requested type. This filter has set semantics for wholesale feed canonicalization.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1sponsored-placement-type.json"},"uniqueItems":true,"minItems":1,"x-canonicalization":"set"},"social_placement_surfaces":{"type":"array","description":"Filter social-product metadata by declared placement surfaces (feed, stories, short_video, explore, or search). A product matches when its declared array intersects the requested array. This is discovery classification only and does not promise delivery exclusively on a requested surface; buyers needing an exact public placement use targeting_overlay.placement_selection. This filter has set semantics for wholesale feed canonicalization.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1social-placement-surface.json"},"uniqueItems":true,"minItems":1,"x-canonicalization":"set"},"required_axe_integrations":{"type":"array","description":"Deprecated: Use trusted_match filter instead. Filter to products executable through specific agentic ad exchanges. URLs are canonical identifiers.","deprecated":true,"items":{"type":"string","format":"uri"},"minItems":1},"trusted_match":{"type":"object","description":"Filter products by Trusted Match Protocol capabilities. Only products with matching TMP support are returned.","properties":{"providers":{"type":"array","description":"Filter to products with specific TMP providers and match types. Each entry identifies a provider by agent_url and optionally requires specific match capabilities. Products must match at least one entry.","items":{"type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"Provider's agent URL from the registry."},"context_match":{"type":"boolean","description":"When true, require this provider to support context match."},"identity_match":{"type":"boolean","description":"When true, require this provider to support identity match."}},"required":["agent_url"],"additionalProperties":true},"minItems":1},"response_types":{"type":"array","description":"Filter to products supporting specific TMP response types (e.g., 'activation', 'creative', 'catalog_items'). Products must support at least one of the listed types.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1response-type.json"},"minItems":1}},"additionalProperties":false},"audience_activation_methods":{"type":"array","x-status":"experimental","description":"Filter to products whose audience_activation.methods matches at least one requested entry (OR across entries). Within an entry every specified field must match (AND); omitted optional fields are wildcards; directions matches on non-empty intersection, and a method that omits directions matches any requested directions; vendor matches on domain, plus brand_id when specified. Fields inapplicable to the requested pattern (e.g. transport on a clean_room entry) make that entry unsatisfiable. Sellers MUST exclude products with no audience_activation declaration when this filter is present; exclusions MAY be reported via filter_diagnostics.excluded_by. Experimental: part of the media_buy.audience_activation surface — buyers SHOULD check the seller's experimental_features before filtering on it; sellers that do not list the feature ignore this filter.","items":{"oneOf":[{"type":"object","description":"Filter by AdCP audience sync path.","properties":{"pattern":{"type":"string","const":"sync_audiences"}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by TMP identity-match path, optionally pinned to a specific buyer agent.","properties":{"pattern":{"type":"string","const":"tmp_identity_match"},"buyer_agent":{"type":"object","description":"Require this buyer agent on tmp_identity_match entries. Buyers typically filter on their own agent_url.","properties":{"agent_url":{"type":"string","format":"uri"}},"required":["agent_url"],"additionalProperties":false}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by bucket-addressed file exchange, optionally pinning transport, directions, or vendor.","properties":{"pattern":{"type":"string","const":"file_transfer"},"transport":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1cloud-storage-protocol.json","description":"Require this storage protocol (file_transfer only)."},"directions":{"type":"array","description":"Require a non-empty intersection with the method's declared directions (file_transfer only).","items":{"type":"string","enum":["buyer_to_seller","seller_to_buyer"]},"minItems":1,"uniqueItems":true},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Require the method's vendor to match this reference."}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by vendor-mediated dataset query path.","properties":{"pattern":{"type":"string","const":"dataset_query"},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Require the method's vendor to match this reference."}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by clean-room path.","properties":{"pattern":{"type":"string","const":"clean_room"},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Require the method's vendor to match this reference."}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by platform distribution path.","properties":{"pattern":{"type":"string","const":"platform_distribution"},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Require the method's vendor to match this reference."}},"required":["pattern"],"additionalProperties":false}]},"minItems":1,"uniqueItems":true},"required_features":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1media-buy-features.json","description":"Filter to products from sellers supporting specific protocol features. Only features set to true are used for filtering."},"required_geo_targeting":{"type":"array","description":"DEPRECATED. Use get_products.required_overlay_support, which is product-scoped and applies consistently to geographic and non-geographic targeting dimensions.","deprecated":true,"items":{"type":"object","properties":{"level":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1geo-level.json","description":"Geographic targeting level (country, region, metro, postal_area)"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code. Required for native postal_area system filters; not applicable to country, region, or metro filters."},"system":{"type":"string","description":"Optional classification system within the level. Use for a specific metro system (e.g., 'nielsen_dma'), native postal_area system (e.g., 'zip' with country 'US'), or deprecated legacy postal alias (e.g., 'us_zip'). Not applicable for country/region which use ISO standards."}},"required":["level"],"allOf":[{"if":{"properties":{"level":{"enum":["country","region"]}},"required":["level"]},"then":{"not":{"anyOf":[{"required":["country"]},{"required":["system"]}]}}},{"if":{"properties":{"level":{"const":"metro"}},"required":["level"]},"then":{"anyOf":[{"not":{"required":["system"]}},{"properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json"}},"required":["system"]}],"not":{"required":["country"]}}},{"if":{"properties":{"level":{"const":"postal_area"}},"required":["level"]},"then":{"anyOf":[{"not":{"anyOf":[{"required":["country"]},{"required":["system"]}]}},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-country-system.json"},{"properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1legacy-postal-system.json"}},"required":["system"],"not":{"required":["country"]}}]}}],"additionalProperties":false},"minItems":1},"signal_targeting":{"type":"array","description":"DEPRECATED legacy signal-option eligibility filter. Retained get_products handlers MUST preserve the signal identity, value predicate, and requested include/exclude capability. This does not activate delivery targeting. Native buyers use criteria.targeting_overlay.signal_targeting_groups only for concrete delivery selections, preserving exclusion through group operators; copying targeting_mode into targeting_overlay.signal_targeting does not preserve it.","deprecated":true,"items":{"type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-targeting.json"}],"properties":{"targeting_mode":{"type":"string","description":"Desired use of this signal on the product. 'include' requires the product option to allow use in an any group. 'exclude' requires the product option to allow use in a none group.","enum":["include","exclude"],"default":"include"}}},"minItems":1},"postal_areas":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.postal_areas. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_proximity":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.geo_proximity. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees (WGS 84)"},"lng":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees (WGS 84)"},"label":{"type":"string","description":"Human-readable label (e.g., 'Düsseldorf', 'Heathrow Airport')"},"travel_time":{"type":"object","description":"Travel time limit for isochrone calculation","properties":{"value":{"type":"number","minimum":1,"description":"Travel time limit"},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1travel-time-unit.json"}},"required":["value","unit"],"additionalProperties":false},"transport_mode":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1transport-mode.json","description":"Transportation mode for isochrone calculation. Required when travel_time is provided."},"radius":{"type":"object","description":"Simple radius from the point","properties":{"value":{"type":"number","exclusiveMinimum":0,"description":"Radius distance"},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1distance-unit.json","description":"Distance unit"}},"required":["value","unit"],"additionalProperties":false},"geometry":{"type":"object","description":"Pre-computed GeoJSON geometry defining the proximity boundary","properties":{"type":{"type":"string","enum":["Polygon","MultiPolygon"],"description":"GeoJSON geometry type"},"coordinates":{"type":"array","description":"GeoJSON coordinates array"}},"required":["type","coordinates"],"additionalProperties":false}},"oneOf":[{"required":["lat","lng","travel_time","transport_mode"],"not":{"anyOf":[{"required":["radius"]},{"required":["geometry"]}]}},{"required":["lat","lng","radius"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["geometry"]}]}},{"required":["geometry"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["radius"]}]}}],"additionalProperties":true},"minItems":1},"required_performance_standards":{"type":"array","description":"Filter to products that can meet the buyer's performance standard requirements. Each entry specifies a metric, minimum threshold, and optionally a required vendor and standard. Products that cannot meet these thresholds or do not support the specified vendors are excluded. Use this to tell the seller upfront: 'I need DoubleVerify for viewability at 70% MRC.'","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1performance-standard.json"},"minItems":1},"required_metrics":{"type":"array","description":"Filter to products whose `reporting_capabilities.available_metrics` is a superset of these metrics — i.e., products that commit to reporting all listed metrics in delivery responses. Use this for capability-level discovery (e.g., 'I need products that report `completed_views` for a CTV CPCV buy'); guarantee-level requirements with thresholds belong in `required_performance_standards` and `measurement_terms`. Sellers MUST silently exclude products that cannot meet this list (filter-not-fail; do not return an error). Under the container-subsumption rule in `enums/available-metric.json`, `viewability` satisfies numeric leaves such as `viewable_rate`; structured distributions require explicit `viewed_seconds_percentiles` or `viewed_seconds_histogram` declarations. The product's declared `available_metrics` becomes the binding reporting contract carried into the resulting media buy — the same metric vocabulary is used to compute `missing_metrics` on `get_media_buy_delivery`.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1available-metric.json"},"minItems":1,"uniqueItems":true,"examples":[["completed_views"],["completed_views","completion_rate"],["impressions","spend","engagements"]]},"required_vendor_metrics":{"type":"array","description":"Filter to products whose `reporting_capabilities.vendor_metrics` matches these criteria. Each entry pins a `vendor` (matches any metric from that vendor), a `metric_id` (matches the metric across any vendor that uses that identifier), or both (specific vendor's specific metric). A product matches if its declared `vendor_metrics` covers ALL listed entries (AND across entries; pins within an entry are conjunctive). Cross-vendor discovery (e.g., 'I need attention measurement from any vendor that does it') is the buyer agent's responsibility — the agent resolves which vendors offer a category via the vendors' `brand.json` records, then enumerates them as filter entries. AdCP does not carry vendor-side metric metadata (category, methodology, standard alignment) in the filter surface; that lives at the vendor and is queried out-of-band. Sellers MUST silently exclude non-matching products (filter-not-fail; do not return an error) — same convention as the other `required_*` filters.","items":{"type":"object","properties":{"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Pin to a specific vendor. Optional — omit to match any vendor offering this `metric_id`."},"metric_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1vendor-metric-id.json","description":"Pin to an exact metric identifier within a vendor's vocabulary. Optional — omit to match any metric from the pinned vendor. Cross-vendor identifier matching only works after vendors converge on identifiers (typically post-standardization)."}},"anyOf":[{"required":["vendor"]},{"required":["metric_id"]}],"additionalProperties":false},"minItems":1,"examples":[[{"vendor":{"domain":"attentionvendor.example"}}],[{"vendor":{"domain":"panelmeasurement.example"},"metric_id":"demographic_reach"}],[{"vendor":{"domain":"attentionvendor.example"}},{"vendor":{"domain":"secondattentionvendor.example"}}]]},"keywords":{"type":"array","description":"DEPRECATED legacy product eligibility filter. Retained get_products handlers MUST preserve the requested keyword eligibility and match_type (default broad). This is not an instruction to add package keyword targeting. Native buyers use criteria.targeting_overlay.keyword_targets only when they intend a delivery constraint, or criteria.required_overlay_support.keyword_targets for future selectability.","deprecated":true,"items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to target"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1match-type.json","default":"broad"}},"required":["keyword"],"additionalProperties":false},"minItems":1},"audience_evidence_requirements":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1audience-evidence-requirements.json","description":"Buyer policy for evaluating Product.audience_evidence. In required mode, sellers MUST apply the evidence_presence and admissibility semantics and exclude non-matching products; they MUST NOT ignore an unsupported hard requirement. In preferred mode, sellers use matches for ranking and explain the evidence selected. Buyers SHOULD inspect media_buy.audience_evidence capabilities before sending this object."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json","description":"Vendor-namespaced extension parameters for seller-specific filter criteria not covered by standard fields. Keys MUST be namespaced under a vendor or platform key (e.g., ext.gam, ext.platform_x). Sellers MUST treat all values as untrusted buyer input; do not interpolate into LLM prompts, SQL queries, or system commands without sanitization. Persistent use of an extension key across multiple buyers is a signal to propose standardization."}},"additionalProperties":true},"external:enums/exclusivity.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/exclusivity.json","title":"Exclusivity","description":"Whether a product offers exclusive access to its inventory","type":"string","enum":["none","category","exclusive"],"enumDescriptions":{"none":"No exclusivity — multiple advertisers can buy this product simultaneously","category":"Category-exclusive — only one advertiser per industry category (e.g., one auto brand per collection sponsorship)","exclusive":"Sole sponsorship — only one advertiser can buy this product"}},"external:enums/pricing-structure.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/pricing-structure.json","title":"Pricing Structure","description":"How the payable price is determined. Fixed pricing has a seller-declared monetary unit price, auction pricing is established through a buyer bid, and contingent pricing is calculated from a measured business outcome after delivery.","type":"string","enum":["fixed","auction","contingent"],"enumDescriptions":{"fixed":"Seller-declared monetary unit price through fixed_price","auction":"Buyer bid against optional floor_price and price_guidance","contingent":"Price calculated from a measured business outcome after delivery"}},"external:core/format-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/format-id.json","title":"Format Reference (Structured Object)","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format reference retained for 3.x compatibility. This JSON object — never a plain string — identifies a format by its declaring agent and local slug, and may carry legacy logical dimensions, pixel ratio, or duration parameters. New products and manifests use canonical `format_options`, `format_kind`, and `format_option_ref`; creative-agent build routing uses `creative.supported_formats[].capability_id`.","x-entity":"creative_format","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent that defines this format (e.g., 'https://creative.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats). Callers comparing two `format-id` values MUST canonicalize `agent_url` per the AdCP URL canonicalization rules before treating two formats as the same. See docs/reference/url-canonicalization."},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant."},"width":{"type":"integer","minimum":1,"description":"Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."},"height":{"type":"integer","minimum":1,"description":"Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."},"duration_ms":{"type":"number","minimum":1,"description":"Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters."},"pixel_ratio":{"type":"number","exclusiveMinimum":0,"description":"Required intrinsic-pixel density for a parameterized visual format, expressed as intrinsic pixels per logical pixel. Requires `width` and `height`. Example: `{id: \"display_image\", width: 300, height: 250, pixel_ratio: 2}` identifies a 300×250 logical render supplied by a 600×500 image. Omit for the backward-compatible 1x variant."}},"required":["agent_url","id"],"additionalProperties":true,"dependentRequired":{"width":["height"],"height":["width"],"pixel_ratio":["width","height"]}},"external:core/canonical-format-kind.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/canonical-format-kind.json","title":"Canonical Format Kind","description":"Discriminator naming one of the 15 AdCP 3.2 canonical creative formats, plus `custom` for adopter-defined shapes. AdCP 3.2 adds `audio_vast` for VAST-tag-delivered audio (the standards-conformant profile starts at VAST 4.1, with older versions available only as seller-declared legacy interoperability) and promotes the legacy `multi_state_display` and `multi_placement_takeover` custom shapes to `seller_rendered_stateful_display` and `coordinated_placements`. When `format_kind` is `custom`, the declaration also carries `format_shape` and `format_schema`. The enum mirrors the branches in `product-format-declaration.json` and is closed for producer validation: sellers do not mint ad-hoc values. SDKs may retain unknown future values in tolerant in-memory parsers, but that does not change versioned JSON Schema validation. A seller responding to a 3.1-or-earlier request MUST project away 3.2-only kinds and emit a compatible legacy declaration; a strict older schema correctly rejects an unprojected newer kind. See adcp#3666 and the promotion migration contract in canonical-formats.mdx.","type":"string","enum":["image","html5","display_tag","image_carousel","video_hosted","video_vast","audio_hosted","audio_vast","audio_daast","sponsored_placement","native_in_feed","responsive_creative","agent_placement","seller_rendered_stateful_display","coordinated_placements","custom"]},"external:core/format-option-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/format-option-ref.json","title":"Format Option Reference","description":"Discriminated reference to a product format option. The global canonical shape is still named by `format_kind`; this reference selects one concrete product `format_options[]` entry. `scope: \"publisher\"` identifies a publisher-declared catalog option by `{ publisher_domain, format_option_id }`. `scope: \"product\"` identifies a product-local option by `format_option_id`; the enclosing package/product context supplies the namespace.","type":"object","discriminator":{"propertyName":"scope"},"oneOf":[{"title":"Publisher Catalog Format Option Reference","description":"Selects a publisher-catalog-backed product format option by publisher domain and format option ID.","type":"object","properties":{"scope":{"type":"string","const":"publisher","description":"Reference resolves against the named publisher's adagents.json top-level `formats[]` catalog."},"publisher_domain":{"type":"string","description":"Publisher domain where the adagents.json declaring this format option is hosted.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"format_option_id":{"type":"string","description":"Stable format option ID from the publisher's adagents.json top-level `formats[]`, matching a publisher-catalog-backed entry in the target product's `format_options[]`."}},"required":["scope","publisher_domain","format_option_id"],"additionalProperties":true},{"title":"Product-Local Format Option Reference","description":"Selects a product-local format option by ID within the enclosing package/product context. This branch deliberately forbids `publisher_domain` (`publisher_domain: false` in the schema) because product-local references are namespaced by the enclosing product only; include `scope: \"publisher\"` when the selector must cross into a publisher catalog.","type":"object","properties":{"scope":{"type":"string","const":"product","description":"Reference resolves only against the target product's inline `format_options[]`."},"format_option_id":{"type":"string","description":"Stable format option ID from the target product's inline `format_options[]`."},"publisher_domain":false},"required":["scope","format_option_id"],"additionalProperties":true}],"additionalProperties":true},"external:enums/metro-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/metro-system.json","title":"Metro Area System","description":"Metro area classification systems for geographic targeting","type":"string","enum":["nielsen_dma","uk_itl1","uk_itl2","eurostat_nuts2","custom"]},"external:enums/channels.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/channels.json","title":"Media Channel","description":"Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.","type":"string","enum":["display","olv","social","search","ctv","linear_tv","radio","streaming_audio","podcast","dooh","ooh","print","cinema","email","gaming","retail_media","influencer","affiliate","product_placement","sponsored_intelligence"],"enumDescriptions":{"display":"Digital display advertising (banners, native, rich media) across web and app","olv":"Online video advertising outside CTV (pre-roll, outstream, in-app video)","social":"Social media platforms (Facebook, Instagram, TikTok, LinkedIn, etc.)","search":"Search engine advertising and search networks","ctv":"Connected TV and streaming on television screens","linear_tv":"Traditional broadcast and cable television","radio":"Traditional AM/FM radio broadcast","streaming_audio":"Digital audio streaming services (Spotify, Pandora, etc.)","podcast":"Podcast advertising (host-read or dynamically inserted)","dooh":"Digital out-of-home buying context, including inventory on venue-operated screens and audio players","ooh":"Classic out-of-home (physical billboards, transit, etc.)","print":"Newspapers, magazines, and other print publications","cinema":"Movie theater advertising","email":"Email advertising and sponsored newsletter content","gaming":"In-game advertising across platforms","retail_media":"Retail media networks and commerce marketplaces (Amazon, Walmart, Instacart)","influencer":"Creator and influencer marketing partnerships","affiliate":"Affiliate networks, comparison sites, and performance-based partnerships","product_placement":"Product placement, branded content, and sponsorship integrations","sponsored_intelligence":"Sponsored Intelligence — advertising within AI assistants, AI search, and generative AI experiences via the reversed data flow"}},"external:enums/video-placement-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/video-placement-type.json","title":"Video Placement Type","description":"Declared video placement classification for OLV and other video inventory, using the IAB Tech Lab/OpenRTB 2.6 video.plcmt definitions with AdCP-native value names. This is seller-declared discovery metadata, not independent verification of inventory quality or delivery context.","type":"string","enum":["instream","accompanying_content","interstitial","standalone"],"enumDescriptions":{"instream":"OpenRTB 2.6 video.plcmt=1: video ads played before, during, or after streaming video content requested by the user.","accompanying_content":"OpenRTB 2.6 video.plcmt=2: video ads played with accompanying video content in a player associated with the page or app content.","interstitial":"OpenRTB 2.6 video.plcmt=3: video ads shown as an interstitial experience, typically between content or app states.","standalone":"OpenRTB 2.6 video.plcmt=4: video ads shown without associated video content, also called no-content or standalone video."}},"external:enums/audio-distribution-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/audio-distribution-type.json","title":"Audio Distribution Type","description":"Declared audio distribution classification for radio, streaming-audio, podcast, and other audio inventory, using IAB Tech Lab/OpenRTB 2.6 audio.feed definitions with AdCP-native value names. This is seller-declared discovery metadata, not independent verification of inventory quality or delivery context.","type":"string","enum":["music_streaming_service","fm_am_broadcast","podcast","catch_up_radio","web_radio","video_game","text_to_speech"],"enumDescriptions":{"music_streaming_service":"OpenRTB 2.6 audio.feed=1: music streaming service.","fm_am_broadcast":"OpenRTB 2.6 audio.feed=2: FM/AM broadcast, including live content broadcast over the air and also available via online streaming.","podcast":"OpenRTB 2.6 audio.feed=3: original, pre-recorded content distributed as episodes in a series.","catch_up_radio":"OpenRTB 2.6 audio.feed=4: recorded segment of a radio show that was originally broadcast live.","web_radio":"OpenRTB 2.6 audio.feed=5: live audio content only available via online streaming, not as FM/AM broadcast.","video_game":"OpenRTB 2.6 audio.feed=6: background audio in video games.","text_to_speech":"OpenRTB 2.6 audio.feed=7: text-to-speech audio such as audio books or website/plugin article narration."}},"external:enums/sponsored-placement-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/sponsored-placement-type.json","title":"Sponsored Placement Type","description":"Declared sponsored-placement classification for catalog-driven retail-media inventory, distinguishing where the sponsored placement renders on the retailer surface. This is seller-declared discovery metadata, not independent verification of inventory quality or delivery context.","type":"string","enum":["sponsored_search","sponsored_display","sponsored_native"],"enumDescriptions":{"sponsored_search":"Sponsored placements rendered against retailer on-site search results, keyed to the shopper's query (e.g., Amazon Sponsored Products on search, Walmart Connect Sponsored Search).","sponsored_display":"Sponsored placements rendered in display slots across retailer browse, category, and product-detail pages outside the search results stream (e.g., Criteo Sponsored Display, Amazon Sponsored Display on-site).","sponsored_native":"Sponsored placements rendered using the retailer's native in-grid product template, blending into the organic product listing (e.g., CitrusAd native product cards, Pinterest catalog-driven collections)."}},"external:enums/social-placement-surface.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/social-placement-surface.json","title":"Social Placement Surface","description":"Declared social-placement surface classification for social inventory, distinguishing the in-app surface where a social placement renders. Values name the semantic surface, not platform brands. This is seller-declared discovery metadata, not independent verification of inventory quality or delivery context.","type":"string","enum":["feed","stories","short_video","explore","search"],"enumDescriptions":{"feed":"The primary scrolling home or timeline surface where posts and ads are interleaved with followed and recommended content.","stories":"The full-screen, ephemeral tap-through surface presented between or alongside users' story content.","short_video":"The full-screen, sound-on, swipe-past, algorithmically-recommended vertical short-video surface. Subsumes the platform brand names for this surface (Reels, Shorts, Spotlight, and TikTok's For You short-video experience) — platform identity belongs to a property/publisher axis, not here.","explore":"The discovery or browse surface presenting recommended content outside the user's followed graph.","search":"The in-app search-results surface, keyed to the user's query."}},"external:enums/response-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/response-type.json","title":"TMP Response Type","description":"What the publisher wants back from a TMP context match. Determines the richness level of the buyer's offer response.","type":"string","enum":["activation","catalog_items","creative","deal"],"enumDescriptions":{"activation":"Binary activation with GAM key-values. Offers identify the package via package_id.","catalog_items":"Preferred catalog items for rendering. Offers may include catalog item references.","creative":"Inline creative manifest. Offers include full rendering details.","deal":"Deal ID for programmatic execution. Offers include deal metadata."}},"external:enums/cloud-storage-protocol.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/cloud-storage-protocol.json","title":"Cloud Storage Protocol","description":"Cloud storage protocols supported for offline file delivery","type":"string","enum":["s3","gcs","azure_blob"]},"external:core/media-buy-features.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/media-buy-features.json","title":"Media Buy Features","description":"Optional media-buy protocol features. Used in capability declarations (seller declares support) and product filters (buyer requires support). If a seller declares a feature as true, they MUST honor requests using that feature.","type":"object","properties":{"inline_creative_management":{"type":"boolean","deprecated":true,"x-removed-in":"4.0.0","description":"Deprecated 3.x compatibility capability for creatives provided inline in create_media_buy and update_media_buy package payloads. buy_products, accept_proposal, and control_media_buy never accept inline creatives. New integrations use the dedicated creative lifecycle. Removed in 4.0."},"property_list_filtering":{"type":"boolean","description":"Honors property_list parameter in get_products to filter results to buyer-approved properties"},"catalog_management":{"type":"boolean","description":"Supports sync_catalogs task for catalog feed management with platform review and approval"},"catalog_item_availability_updates":{"type":"boolean","description":"Supports buyer-pushed item_availability_updates and item_availability_queries on sync_catalogs for immediate suppression/restoration and current-state readback in buyer-managed catalogs. Seller declarations may be true only with catalog_management: true; buyer required_features filters may request this feature alone. Requests containing availability operations are synchronous and accept at most 1,000 combined update and query entries. A successful suppress covers selection, dynamic rendering, and cached or pre-generated creatives materialized from the item. Internal lineage MUST retain resolved_account_id, catalog_id, catalog_generation, and item_id. Static creatives supplied or promoted by the buyer without catalog lineage remain outside this automatic guarantee. Suppression persists across feed refreshes and ordinary upserts until restore, expires_at, or catalog deletion. A seller that does not declare true MUST reject availability operations with UNSUPPORTED_FEATURE before lookup or mutation and MUST NOT interpret them as discovery. This does not control seller-owned wholesale inventory or let restore bypass seller controls."},"committed_metrics_supported":{"type":"boolean","description":"Seller has per-package snapshot infrastructure for the reporting contract. When true, the seller MUST populate `package.committed_metrics` on committed `create_media_buy` responses where `confirmed_at` is non-null, MUST omit `package.committed_metrics` while `confirmed_at` is null for a provisional buy, and MUST honor append-only mid-flight metric additions via `update_media_buy`. The unified `committed_metrics` array (per the metric-accountability design) covers both standard and vendor-defined metric entries, so a single flag is load-bearing. Buyers filtering on this flag are detecting 'this seller can stamp the reporting contract,' which closes the audit gap from PR #3510 where absence of `committed_metrics` was indistinguishable between 'didn't snapshot' and 'snapshot infrastructure not implemented.'"},"seller_optimized_budget":{"type":"boolean","description":"Supports the core seller-optimized shared-budget contract for budget_allocation.mode `seller_optimized`: one hard shared total_budget, seller allocation of that total across the buy's packages against budget_allocation.optimization_goals, media-buy-level pacing, and echo of the allocation configuration on buy read surfaces. Sellers declaring true MUST accept eligible explicit-package and proposal executions that use only these core controls and MUST enforce the aggregate budget. Core media-buy pacing: sellers declaring true MUST accept omitted media-buy pacing (which defaults to even when total_budget is present) and pacing `even` on seller-optimized buys; they MAY reject `asap` or `front_loaded` with `UNSUPPORTED_FEATURE` (error.field `pacing`) before any provider mutation, and MUST NOT silently coerce them to `even`. Package-level controls inside a seller-optimized buy are separate capabilities: package budget caps (seller_optimized_package_budgets), package minimum-spend targets (seller_optimized_min_spend_targets), and package pacing (seller_optimized_package_pacing). A seller declaring this feature but not one of those sub-capabilities MUST reject any request that would leave that package control on a seller-optimized buy with `UNSUPPORTED_FEATURE` before any over-subscription validation or provider mutation, and MUST NOT silently drop, soften, or coerce it. Over-subscription validation (`INVALID_REQUEST`) applies only to package controls the seller has declared; see seller_optimized_min_spend_targets. Product combinations may still be rejected when their currencies, optimization capabilities, pricing terms, or delivery constraints are incompatible. Sellers that do not declare this feature MUST reject any request carrying `budget_allocation.mode: 'seller_optimized'` with `UNSUPPORTED_FEATURE` before any provider mutation, and MUST NOT coerce the request to fixed allocation."},"seller_optimized_package_budgets":{"type":"boolean","description":"Honors package `budget` as an optional hard lifetime package spend cap inside a seller-optimized buy: packages[].budget and new_packages[].budget on create_media_buy and update_media_buy, purchases[].budget on buy_products, package budget controls on control_media_buy, and max_spend_percentage on seller-optimized proposal allocations. The cap is a ceiling, not a reserved or current allocation, and package caps may sum above total_budget. Meaningful only with seller_optimized_budget: true; seller declarations may be true only with seller_optimized_budget: true, while buyer required_features filters may request this feature alone. A seller that declares seller_optimized_budget without this feature MUST reject a request that would leave a package budget on a seller-optimized buy, including an allocation-mode switch that retains fixed-mode package budgets (the buyer clears them with null in the same atomic update), with `UNSUPPORTED_FEATURE` before any over-subscription validation or provider mutation, and MUST NOT issue seller-optimized proposals carrying max_spend_percentage. Does not govern fixed allocation, where package budgets remain required."},"seller_optimized_min_spend_targets":{"type":"boolean","description":"Honors package `min_spend_target` as a soft lifetime minimum-spend target inside a seller-optimized buy: packages[].min_spend_target and new_packages[].min_spend_target on create_media_buy and update_media_buy, purchases[].min_spend_target on buy_products, package min_spend_target controls on control_media_buy, and min_spend_target_percentage on seller-optimized proposal allocations. The seller SHOULD attempt to deliver at least the target before allocating incremental spend elsewhere; it is not a billing or delivery guarantee. Meaningful only with seller_optimized_budget: true; seller declarations may be true only with seller_optimized_budget: true, while buyer required_features filters may request this feature alone. Sellers declaring this feature MUST reject package minimum-spend targets summing above total_budget with `INVALID_REQUEST` before mutation, and, when they also declare seller_optimized_package_budgets, MUST likewise reject a min_spend_target above its own package budget. A seller that declares seller_optimized_budget without this feature MUST reject a request carrying a numeric min_spend_target with `UNSUPPORTED_FEATURE` before any over-subscription validation or provider mutation, so an over-subscribed target sent to such a seller yields `UNSUPPORTED_FEATURE`, and MUST NOT issue seller-optimized proposals carrying min_spend_target_percentage."},"seller_optimized_package_pacing":{"type":"boolean","description":"Honors package `pacing` as subordinate per-package pacing inside a seller-optimized buy, in addition to the media-buy-level pacing covered by seller_optimized_budget: packages[].pacing and new_packages[].pacing on create_media_buy and update_media_buy, purchases[].pacing on buy_products, package pacing controls on control_media_buy, and allocation pacing on seller-optimized proposals. Package pacing MUST NOT cause delivery to exceed aggregate media-buy pacing. Meaningful only with seller_optimized_budget: true; seller declarations may be true only with seller_optimized_budget: true, while buyer required_features filters may request this feature alone. Package pacing equal to the effective media-buy pacing adds no subordinate constraint and does not require this feature; buyers SHOULD omit package pacing on seller-optimized buys unless this feature is advertised. A seller that declares seller_optimized_budget without this feature MUST reject a request that would leave package pacing differing from media-buy pacing on a seller-optimized buy, including an allocation-mode switch that retains such fixed-mode package pacing (the buyer can align it in the same update), with `UNSUPPORTED_FEATURE` before any provider mutation, and MUST NOT issue seller-optimized proposals carrying allocation pacing. Does not govern package pacing in fixed allocation."},"bidding_policy":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json"}],"description":"Structured support for canonical bidding by authored scope, allocation context, mode, strength, and strength-qualified multi-field combination. Presence does not imply support for both scopes, both allocation modes, or every policy shape. Sellers MUST preserve every advertised semantic exactly and reject unadvertised policies rather than translating them."}},"additionalProperties":{"type":"boolean"}},"external:core/bidding-policy-capability.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/bidding-policy-capability.json","title":"Bidding Policy Capability","description":"Structured declaration of the canonical bidding policies a seller can preserve without semantic translation. Media-buy/package authored scope and fixed/seller-optimized allocation context are advertised independently. Buyers MUST inspect the exact scope, allocation context, mode, strength, and combination rather than treating presence of this object as blanket support.","x-adcp-hoist":true,"type":"object","properties":{"media_buy":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/scope_capability","description":"Policies accepted at media-buy scope and inherited by packages that omit a package override."},"package":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/scope_capability","description":"Policies accepted as package-authored policies, including explicit automatic overrides."}},"minProperties":1,"additionalProperties":false,"$defs":{"scope_capability":{"type":"object","description":"Support at one authored scope, partitioned by the media buy's resulting allocation mode. Omitted contexts are unsupported; claims in one context make no claim about the other.","properties":{"fixed":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/policy_profile","description":"Policies supported when budget allocation is fixed or omitted."},"seller_optimized":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/policy_profile","description":"Policies supported when budget_allocation.mode is seller_optimized."}},"minProperties":1,"additionalProperties":false},"policy_profile":{"type":"object","properties":{"modes":{"type":"array","description":"Standalone policy modes accepted in this exact scope and allocation context. Combination-only components belong only in supported_combinations and need not appear here. `automatic` means the seller accepts and preserves an explicit `{automatic:true}` authored block; omission only invokes inheritance/default behavior.","items":{"type":"string","enum":["automatic","bid_amount","max_bid","cost_per","roas"]},"minItems":1,"uniqueItems":true},"cost_per_strengths":{"type":"array","description":"Supported standalone cost_per strengths in this profile. Required exactly when modes includes cost_per.","items":{"type":"string","enum":["cap","target"]},"minItems":1,"uniqueItems":true},"roas_strengths":{"type":"array","description":"Supported standalone roas strengths in this profile. Required exactly when modes includes roas.","items":{"type":"string","enum":["floor","target"]},"minItems":1,"uniqueItems":true},"supported_combinations":{"type":"array","description":"Multi-field policies supported in this exact scope and allocation context. Each entry independently qualifies the strengths supported in that combination; standalone strength support does not imply combination support. Absence means no multi-field combination is claimed.","items":{"oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/max_bid_with_cost_per"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/max_bid_with_roas"}]},"minItems":1}},"anyOf":[{"required":["modes"]},{"required":["supported_combinations"]}],"allOf":[{"if":{"properties":{"modes":{"contains":{"const":"cost_per"}}},"required":["modes"]},"then":{"required":["cost_per_strengths"]},"else":{"not":{"required":["cost_per_strengths"]}}},{"if":{"properties":{"modes":{"contains":{"const":"roas"}}},"required":["modes"]},"then":{"required":["roas_strengths"]},"else":{"not":{"required":["roas_strengths"]}}}],"additionalProperties":false},"max_bid_with_cost_per":{"type":"object","properties":{"kind":{"type":"string","const":"max_bid_with_cost_per"},"cost_per_strengths":{"type":"array","description":"cost_per strengths supported when combined with max_bid.","items":{"type":"string","enum":["cap","target"]},"minItems":1,"uniqueItems":true}},"required":["kind","cost_per_strengths"],"additionalProperties":false},"max_bid_with_roas":{"type":"object","properties":{"kind":{"type":"string","const":"max_bid_with_roas"},"roas_strengths":{"type":"array","description":"roas strengths supported when combined with max_bid.","items":{"type":"string","enum":["floor","target"]},"minItems":1,"uniqueItems":true}},"required":["kind","roas_strengths"],"additionalProperties":false}}},"external:enums/geo-level.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/geo-level.json","title":"Geographic Targeting Level","description":"Geographic targeting granularity levels. Some levels (metro, postal_area) require a system specification.","type":"string","enum":["country","region","metro","postal_area"]},"external:core/postal-country-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/postal-country-system.json","title":"Postal Country System","description":"Valid country-local postal system pairing. Registered countries only accept their registered local systems; countries without a registered local system use postal_code or custom.","type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1postal-system.json","description":"Country-local postal code system."}},"required":["country","system"],"anyOf":[{"properties":{"country":{"const":"US"},"system":{"enum":["zip","zip_plus_four"]}}},{"properties":{"country":{"const":"GB"},"system":{"enum":["outward","full"]}}},{"properties":{"country":{"const":"CA"},"system":{"enum":["fsa","full"]}}},{"properties":{"country":{"enum":["DE","CH","AT"]},"system":{"const":"plz"}}},{"properties":{"country":{"const":"FR"},"system":{"const":"code_postal"}}},{"properties":{"country":{"const":"AU"},"system":{"const":"postcode"}}},{"properties":{"country":{"const":"BR"},"system":{"const":"cep"}}},{"properties":{"country":{"const":"IN"},"system":{"const":"pin"}}},{"properties":{"country":{"const":"ZA"},"system":{"const":"postal_code"}}},{"properties":{"country":{"not":{"enum":["US","GB","CA","DE","CH","AT","FR","AU","BR","IN","ZA"]}},"system":{"enum":["postal_code","custom"]}}}]},"external:enums/postal-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/postal-system.json","title":"Postal Code System","description":"Postal code system names for geographic targeting. Prefer country-local values with an explicit ISO 3166-1 alpha-2 country. Deprecated country-fused values remain in this published enum for 3.x compatibility.","type":"string","enum":["postal_code","zip","zip_plus_four","outward","full","fsa","plz","code_postal","postcode","cep","pin","custom","us_zip","us_zip_plus_four","gb_outward","gb_full","ca_fsa","ca_full","de_plz","fr_code_postal","au_postcode","ch_plz","at_plz"]},"external:enums/legacy-postal-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/legacy-postal-system.json","title":"Country-Fused Postal Code System","description":"Deprecated country-fused postal code systems for geographic targeting. Prefer postal-system with an explicit ISO 3166-1 alpha-2 country on postal area objects.","type":"string","deprecated":true,"enum":["us_zip","us_zip_plus_four","gb_outward","gb_full","ca_fsa","ca_full","de_plz","fr_code_postal","au_postcode","ch_plz","at_plz"]},"external:core/signal-targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/signal-targeting.json","title":"Signal Targeting","description":"Targeting constraint for a specific signal. Uses value_type as discriminator to determine the targeting expression format.","discriminator":{"propertyName":"value_type"},"oneOf":[{"type":"object","description":"Binary signal targeting - user either matches or doesn't","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"binary","description":"Discriminator for binary signals"},"value":{"type":"boolean","description":"Whether to include (true) or exclude (false) users matching this signal"}},"required":["value_type","value"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true},{"type":"object","description":"Categorical signal targeting - target users with specific values","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"categorical","description":"Discriminator for categorical signals"},"values":{"type":"array","description":"Values to target. Users with any of these values will be included.","items":{"type":"string"},"minItems":1}},"required":["value_type","values"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true},{"type":"object","description":"Numeric signal targeting - target users within a value range. If min_value is provided, it must be <= max_value. Values should be within the signal's defined range (see signal definition).","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"numeric","description":"Discriminator for numeric signals"},"min_value":{"type":"number","description":"Minimum value (inclusive). Omit for no minimum. Must be <= max_value when both are provided. Should be >= signal's range.min if defined."},"max_value":{"type":"number","description":"Maximum value (inclusive). Omit for no maximum. Must be >= min_value when both are provided. Should be <= signal's range.max if defined."}},"required":["value_type"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true}]},"external:core/signal-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/signal-ref.json","title":"Signal Ref","description":"Reference to a named signal definition. Uses scope as discriminator: 'data_provider' for a signal resolved through published adagents.json signals[], 'signal_source' for a source-native signal resolved through the issuing signal source, or 'product' for a product-local signal option. Scope is the resolution path, not provenance; authoritative enrichment lives on the seller, signal source, or data-provider signal definition, not on this reference.","x-entity":"signal","discriminator":{"propertyName":"scope"},"oneOf":[{"type":"object","description":"Product-scoped signal. The signal_id is meaningful only within the selected product/package context and MUST match a Product.included_signals[].signal_ref.signal_id or Product.signal_targeting_options[].signal_ref.signal_id for that product, depending on whether the signal is descriptive or selectable.","properties":{"scope":{"type":"string","const":"product","description":"Discriminator indicating the signal resolves through the selected product's included_signals or signal_targeting_options."},"signal_id":{"type":"string","description":"Product-local signal identifier. For local signals exposed on both get_signals and get_products, this MUST match get_signals.signals[].signal_ref.signal_id for the same signal.","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","signal_id"],"not":{"anyOf":[{"required":["data_provider_domain"]},{"required":["signal_source_url"]},{"required":["agent_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true},{"type":"object","description":"Data-provider-scoped signal. The signal_id resolves through the data provider's published adagents.json signals[] and can be authorization-verified there.","properties":{"scope":{"type":"string","const":"data_provider","description":"Discriminator indicating the signal resolves through a data provider's published adagents.json signals[]."},"data_provider_domain":{"type":"string","description":"Domain that publishes the signal definition in its adagents.json signals[].","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"signal_id":{"type":"string","description":"Signal identifier within the data provider's published adagents.json signals[].","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","data_provider_domain","signal_id"],"not":{"anyOf":[{"required":["agent_url"]},{"required":["signal_source_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true},{"type":"object","description":"Signal-source-scoped signal. Use this for source-native signals that are not published in upstream adagents.json signals[]. The buyer trusts the issuing signal source for this identity; use scope 'data_provider' instead when the signal is published in adagents.json signals[], even if the publisher is also the seller or signal source.","properties":{"scope":{"type":"string","const":"signal_source","description":"Discriminator indicating the signal resolves through the issuing signal source."},"signal_source_url":{"type":"string","format":"uri","description":"URL of the signal source that issues this source-native signal."},"signal_id":{"type":"string","description":"Signal identifier within the issuing signal source's signal set.","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","signal_source_url","signal_id"],"not":{"anyOf":[{"required":["data_provider_domain"]},{"required":["agent_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true}]},"external:core/signal-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/signal-id.json","title":"Signal ID","description":"DEPRECATED. Use SignalRef for new discovery, activation, and media-buy signal identity surfaces. Legacy universal signal identifier used by older Signals Protocol clients. Uses 'source' as discriminator: 'catalog' for signals from a data provider's published catalog (verifiable), or 'agent' for signals native to a signal source identified by agent_url.","deprecated":true,"x-entity":"signal","discriminator":{"propertyName":"source"},"oneOf":[{"type":"object","description":"Data-provider signal - references a signal from a data provider's published adagents.json signals[]. Buyers can verify authorization by checking the data provider's adagents.json.","properties":{"source":{"type":"string","const":"catalog","description":"Discriminator indicating this signal is from a data provider's published adagents.json signals[]"},"data_provider_domain":{"type":"string","description":"Domain of the data provider that owns this signal (e.g., 'pinnacle-data.example'). The signal definition is published at this domain's /.well-known/adagents.json","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Signal identifier within the data provider's catalog (e.g., 'likely_ev_buyers', 'income_100k_plus')"}},"required":["source","data_provider_domain","id"],"additionalProperties":true},{"type":"object","description":"Agent signal - references a signal native to a signal source identified by agent_url. Not externally verifiable through an upstream catalog; buyer trusts the issuing signal source's claim about the signal.","properties":{"source":{"type":"string","const":"agent","description":"Discriminator indicating this signal is native to the signal source identified by agent_url, not from a data provider's published signal definitions."},"agent_url":{"type":"string","format":"uri","description":"URL of the signal source that provides this signal (e.g., 'https://signals.example/.well-known/adcp/signals')"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Signal identifier within the agent's signal set (e.g., 'custom_auto_intenders')"}},"required":["source","agent_url","id"],"additionalProperties":true}]},"external:core/postal-area.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/postal-area.json","title":"Postal Area","description":"Postal area values. Prefer the native country + postal system form. Deprecated legacy country-fused postal-system tokens remain accepted for compatibility.","anyOf":[{"title":"PostalArea","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-country-system.json"}],"properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code for the postal values."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1postal-system.json","description":"Country-local postal code system (e.g., 'zip', 'outward', 'plz', 'postal_code')."},"values":{"type":"array","description":"Postal codes within the country and system.","items":{"type":"string"},"minItems":1}},"required":["country","system","values"],"additionalProperties":false},{"title":"PostalAreaWithFusedSystem","deprecated":true,"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1legacy-postal-system.json","deprecated":true,"description":"Deprecated country-fused postal code system (e.g., 'us_zip', 'gb_outward'). Prefer country + postal-system."},"values":{"type":"array","description":"Postal codes within the legacy system.","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false}]},"external:enums/travel-time-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/travel-time-unit.json","title":"Travel Time Unit","description":"Time unit for isochrone (travel-time catchment) calculations.","type":"string","enum":["min","hr"],"enumDescriptions":{"min":"Minutes","hr":"Hours"}},"external:enums/transport-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/transport-mode.json","title":"Transport Mode","description":"Transportation modes for isochrone-based catchment area calculations. Determines how travel time translates to geographic reach.","type":"string","enum":["walking","cycling","driving","public_transport"],"enumDescriptions":{"walking":"Pedestrian travel on walkable paths and sidewalks","cycling":"Bicycle travel on roads and cycle paths","driving":"Motor vehicle travel on road networks","public_transport":"Public transit including bus, rail, metro, and ferry"}},"external:enums/distance-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/distance-unit.json","title":"Distance Unit","description":"Units of distance measurement for radius-based catchment areas.","type":"string","enum":["km","mi","m"],"enumDescriptions":{"km":"Kilometers","mi":"Miles","m":"Meters"}},"external:core/performance-standard.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/performance-standard.json","title":"Performance Standard","description":"A rate threshold for a performance metric, measured by a specified vendor. The threshold is a floor or ceiling depending on the metric: viewability, completion_rate, brand_safety, and attention_score are floors (must exceed); ivt is a ceiling (must not exceed).","type":"object","properties":{"metric":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1performance-standard-metric.json","description":"The performance metric this standard applies to."},"threshold":{"type":"number","minimum":0,"maximum":1,"description":"Rate threshold as a decimal (e.g., 0.70 for 70%). Whether this is a floor or ceiling depends on the metric: for viewability, completion_rate, brand_safety, attention_score the actual rate must be >= threshold; for ivt the actual rate must be <= threshold."},"standard":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1viewability-standard.json","description":"Measurement standard. Required when metric is 'viewability' (MRC and GroupM define materially different thresholds). Omit for other metrics."},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor measuring this metric (e.g., { domain: 'doubleverify.com' }). The vendor's brand.json agents array (type: 'measurement') is the discovery point for their measurement agent. When specified on a confirmed package, creatives MUST include tracker_script or tracker_pixel assets from this vendor."}},"required":["metric","threshold","vendor"],"additionalProperties":true},"external:enums/performance-standard-metric.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/performance-standard-metric.json","title":"Performance Standard Metric","description":"Performance metrics that support rate thresholds on media buys — the verification subset of the broader metric vocabulary. Each metric specifies whether its threshold is a floor (must exceed) or ceiling (must not exceed). Shared values with `available-metric.json` mirror the delivery vocabulary (`viewability` → `viewable_rate` family, `completion_rate` → same name); verification-only values (`ivt`, `brand_safety`, `attention_score`) are typically vendor-attested and do not appear in `available-metric.json` because they're not seller-reportable scalars — they flow through `vendor_metric_values` or vendor-scope `committed_metrics` entries with the matching `performance_standard.vendor` BrandRef anchoring identity.","type":"string","enum":["viewability","ivt","completion_rate","brand_safety","attention_score"],"enumDescriptions":{"viewability":"Viewable impression rate (floor — must exceed threshold). Requires viewability_standard. Denominator: measurable_impressions.","ivt":"Invalid Traffic rate (ceiling — must not exceed threshold). Denominator: total_impressions.","completion_rate":"Video or audio completion rate (floor — must exceed threshold). Denominator: total_impressions.","brand_safety":"Brand-safe impression rate (floor — must exceed threshold). Denominator: total_impressions.","attention_score":"Attention score rate (floor — must exceed threshold). Denominator: measurable_impressions."}},"external:enums/viewability-standard.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/viewability-standard.json","title":"Viewability Standard","description":"Viewability measurement standard applied to determine whether an impression qualifies as viewable. These are materially different thresholds and should not be compared across standards.","type":"string","enum":["mrc","groupm"],"enumDescriptions":{"mrc":"MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).","groupm":"GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."}},"external:enums/available-metric.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/available-metric.json","title":"Available Metric","description":"Standard delivery and performance metrics available for reporting. Most values name flat numeric fields of `core/delivery-metrics.json`. Leaf identities address a single numeric value nested inside an object-shaped metric so it can be declared, committed, aggregated, and sorted individually: `quartile_25`/`quartile_50`/`quartile_75`/`quartile_100` resolve to `quartile_data.q1_views`–`q4_views`, and `viewable_rate`/`viewable_impressions`/`measurable_impressions`/`viewed_seconds` resolve to the same-named fields of `viewability`. Structured nested identities `viewed_seconds_percentiles` and `viewed_seconds_histogram` make the corresponding optional distribution carriers discoverable, committable, and requestable, but not aggregatable or sortable. The nested object or array remains the canonical carrier — nested identities never introduce duplicate flat response fields. Container tokens such as `viewability`, `quartile_data`, `dooh_metrics`, and `time_based_views` declare their documented nested surface. **Container subsumption applies only to numeric leaves**: `viewability` subsumes `viewable_rate`, `viewable_impressions`, `measurable_impressions`, and `viewed_seconds`; `quartile_data` subsumes `quartile_25`, `quartile_50`, `quartile_75`, and `quartile_100`. This rule applies to capability declaration, `required_metrics` filtering, format `reported_metrics` intersection, and `requested_metrics` selection. Optional structured identities MUST be declared explicitly: `viewability` alone does not satisfy `viewed_seconds_percentiles` or `viewed_seconds_histogram`. Requesting any nested identity selects its canonical carrier in the response. A nested identity declaration does not imply sibling values or the carrier's non-metric fields.","type":"string","enum":["impressions","spend","clicks","ctr","views","completed_views","completion_rate","conversions","conversion_value","commissionable_value","roas","cost_per_acquisition","new_to_brand_rate","leads","reach","frequency","grps","engagements","engagement_rate","follows","saves","profile_visits","viewability","viewable_rate","viewable_impressions","measurable_impressions","viewed_seconds","viewed_seconds_percentiles","viewed_seconds_histogram","quartile_data","quartile_25","quartile_50","quartile_75","quartile_100","time_based_views","dooh_metrics","ooh_metrics","cost_per_click","cost_per_completed_view","cpm","downloads","units_sold","new_to_brand_units","plays","incremental_sales_lift","brand_lift","foot_traffic","conversion_lift","brand_search_lift"]},"external:core/vendor-metric-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/vendor-metric-id.json","title":"Vendor Metric ID","description":"Identifier for a vendor-defined metric within the vendor's vocabulary. Stable lookup key; the vendor publishes the canonical list (with category, methodology, and standard alignment) in `brand.json` `agents[type='measurement']`. Lowercase with underscores so a future enum promotion into `available-metric.json` is a literal string lift. Identifier is namespaced by the vendor — the same `metric_id` may mean different things in different vendors' vocabularies.","type":"string","x-entity":"vendor_metric","minLength":1,"maxLength":64,"pattern":"^[a-z][a-z0-9_]*$","examples":["attention_units","gco2e_per_impression","demographic_reach","co_view_index","incremental_lift_percent"]},"external:enums/match-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/match-type.json","title":"Match Type","description":"Keyword targeting match type. broad: ads may serve on queries semantically related to the keyword. phrase: ads serve when the query contains the keyword phrase. exact: ads serve only when the query matches the keyword exactly.","type":"string","enum":["broad","phrase","exact"],"enumDescriptions":{"broad":"Ads may serve on queries semantically related to the keyword","phrase":"Ads serve when the query contains the keyword phrase in order","exact":"Ads serve only when the query matches the keyword exactly"}},"external:core/audience-evidence-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/audience-evidence-requirements.json","title":"Audience Evidence Requirements","description":"Buyer-authored admissibility and ranking policy for product audience evidence. This reusable object attaches to get_products filters in 3.2, so the same semantics apply in brief, wholesale, and refine modes. It never requests exact audience targeting.","type":"object","properties":{"requirement_mode":{"type":"string","enum":["required","preferred"],"description":"required excludes products whose published evidence violates the constraints; preferred only affects ranking and explanation. When this policy affects inclusion or ranking, the seller MUST return the exact matching audience_evidence_selections even if get_products.fields omitted that field."},"evidence_presence":{"type":"string","enum":["required","when_available"],"description":"required applies the mode to evidence presence itself. when_available applies constraints only when a product publishes evidence: with requirement_mode required, a product with no evidence remains eligible but a product with evidence must have an admissible item; with preferred, presence and admissibility only affect ranking."},"accepted_methodologies":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audience-evidence-methodology.json"},"minItems":1,"uniqueItems":true,"description":"Allowed methodologies. excluded_methodologies always wins if a value appears in both lists."},"excluded_methodologies":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audience-evidence-methodology.json"},"minItems":1,"uniqueItems":true,"description":"Disallowed methodologies. Exclusion wins over accepted_methodologies when the lists overlap."},"accepted_evidence_types":{"type":"array","items":{"type":"string","enum":["measured","forecast","seller_declared"]},"minItems":1,"uniqueItems":true},"accepted_providers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json"},"minItems":1,"description":"Allowed evidence providers. excluded_providers always wins if the same canonical BrandRef appears in both lists."},"excluded_providers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json"},"minItems":1,"description":"Disallowed evidence providers. Exclusion wins over accepted_providers when the lists overlap."},"accepted_subject_types":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audience-subject-type.json"},"minItems":1,"uniqueItems":true},"accepted_resolution_methods":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audience-resolution-method.json"},"minItems":1,"uniqueItems":true},"minimum_confidence":{"type":"number","minimum":0,"maximum":1},"maximum_age":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1duration.json"},{"properties":{"unit":{"enum":["seconds","minutes","hours","days"]}}}],"description":"Maximum age at evaluation time measured from last_updated. Campaign-relative duration is not valid for evidence age."},"methodology_documentation_required":{"type":"boolean","default":false,"description":"Whether an admissible item must carry methodology_url."},"independent_attestation_required":{"type":"boolean","default":false,"description":"Whether an admissible item must have at least one exact reference/evaluation pair whose outcome is verified, whose reference is published in the evidence, and whose claim type and issuer match the buyer's accepted lists as well as the seller's issuer and resolver policy. Setting true requires accepted_attestation_issuers."},"accepted_attestation_issuers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1attestation-issuer.json"},"minItems":1,"uniqueItems":true,"description":"Buyer allowlist for independent attestation issuers. An exact reference/evaluation pair satisfies the requirement only when reference.issuer matches an entry here. This list narrows and never broadens the seller's accepted issuer policy."},"accepted_attestation_claim_types":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1,"uniqueItems":true,"description":"Optional acceptable claim types when attestation is used. Buyer-supplied claim types further constrain but never broaden seller policy."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["requirement_mode","evidence_presence"],"allOf":[{"if":{"properties":{"independent_attestation_required":{"const":true}},"required":["independent_attestation_required"]},"then":{"required":["accepted_attestation_issuers"]}}],"additionalProperties":false},"external:enums/audience-evidence-methodology.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/audience-evidence-methodology.json","title":"Audience Evidence Methodology","description":"How a population-level audience-evidence estimate was produced. This vocabulary is intentionally separate from signal-definition methodology: `projected` describes expansion of a sample or panel to a reference population and does not become a user-level signal-membership method.","type":"string","enum":["observed","declared","derived","inferred","modeled","projected"]},"external:enums/audience-subject-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/audience-subject-type.json","title":"Audience Subject Type","description":"The kind of subject characterized by audience data or population-level evidence.","type":"string","enum":["individual","household","business","contextual","none"]},"external:enums/audience-resolution-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/audience-resolution-method.json","title":"Audience Resolution Method","description":"How subjects were resolved when producing a signal or population-level evidence estimate.","type":"string","enum":["deterministic_id","probabilistic_device","browser","geographic","content_signal","mixed"]},"external:core/duration.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/duration.json","title":"Duration","description":"A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.","type":"object","properties":{"interval":{"type":"integer","minimum":1,"description":"Number of time units. Must be 1 when unit is 'campaign'."},"unit":{"type":"string","enum":["seconds","minutes","hours","days","campaign"],"description":"Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."}},"required":["interval","unit"],"additionalProperties":false},"external:core/attestation-issuer.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/attestation-issuer.json","title":"Attestation Issuer","description":"Canonical identity of the party that issued an attestation credential. The discriminator selects an existing AdCP identity when one exists and falls back to an HTTPS origin for other attestors. This identity is a claim carried by the presentation; evaluators MUST match it against their configured trust policy and verify it from the resolved or embedded credential before relying on it.","discriminator":{"propertyName":"type"},"oneOf":[{"title":"AttestationBrandIssuer","type":"object","properties":{"type":{"type":"string","const":"brand","description":"The issuer is identified by an AdCP BrandRef."},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["type","brand"],"additionalProperties":false},{"title":"AttestationAgentIssuer","type":"object","properties":{"type":{"type":"string","const":"agent","description":"The issuer is an AdCP agent identified by its canonical HTTPS endpoint."},"agent_url":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$","description":"Canonical HTTPS endpoint of the issuing agent. Evaluators compare it using AdCP URL canonicalization rules."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["type","agent_url"],"additionalProperties":false},{"title":"AttestationOriginIssuer","type":"object","properties":{"type":{"type":"string","const":"origin","description":"The issuer is identified by a canonical HTTPS origin because no AdCP brand or agent identity applies."},"origin":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+$","description":"Canonical HTTPS origin with no path, query, fragment, or userinfo. This identifies the issuer; it does not authorize a fetch."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["type","origin"],"additionalProperties":false}],"examples":[{"type":"brand","brand":{"domain":"nova-brands.example","brand_id":"nova_motors"}},{"type":"agent","agent_url":"https://attestor.example/adcp"},{"type":"origin","origin":"https://credentials.example"}]},"external:core/targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/targeting.json","title":"Targeting Overlay","description":"Strict non-null targeting state used during product discovery, commercial snapshots, and media-buy readback. Targeting includes both audience eligibility and purchased-inventory selection: geography, demographics, placements, properties, collections, device compatibility, language, keywords, and other explicit controls. Sellers resolve requested outcomes against inherent product scope or selectable execution. Request-side create and update mutations use targeting-input.json so null can explicitly clear one dimension; resolved effective targeting omits cleared dimensions and MUST NOT contain null. A fresh create/update request MUST be applied exactly or rejected; get_products may instead return a request-scoped configured product with sparse, buyer-reviewable targeting_resolution modifications.","x-adcp-validation":{"disjoint_place_fields":{"include":"geo_places","exclude":"geo_places_exclude","identity":["country","system","place_type","value"]},"description":"JSON Schema draft-07 cannot compare values across sibling arrays. Conformance tooling MUST reject any place identity present in both geo_places and geo_places_exclude. Catalog version is deliberately not part of place identity: a stable ID cannot be both included and excluded by assigning different versions."},"type":"object","properties":{"geo_countries":{"type":"array","description":"Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"geo_countries_exclude":{"type":"array","description":"Exclude specific countries from delivery. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"geo_regions":{"type":"array","description":"Restrict delivery to exact canonical ISO 3166-2 subdivisions (states, provinces, regions, departments, or other subdivision categories). Unknown identifiers are invalid. At create or update, sellers MUST reject unsupported identifiers and MUST NOT silently widen, drop, or partially apply the list. During get_products, a seller may instead return a sparse, buyer-reviewable targeting_resolution modification for a valid but unsupported requested outcome. Exact internal translation preserves accepted identifiers in package readback.","items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1},"geo_regions_exclude":{"type":"array","description":"Exclude exact canonical ISO 3166-2 subdivisions. Support is independent from geo_regions inclusion support. Unknown identifiers and values also present in geo_regions are invalid. At create or update, sellers MUST reject unsupported identifiers and partial application; during get_products, a seller may instead return a sparse, buyer-reviewable targeting_resolution modification for a valid but unsupported requested outcome.","x-adcp-validation":{"disjoint_with":"geo_regions","spec":"docs/media-buy/advanced-topics/targeting.mdx#geo_regions_exclude"},"items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1},"geo_metros":{"title":"Targeting Geo Metros","type":"array","description":"Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-metro.json"},"minItems":1},"geo_metros_exclude":{"type":"array","description":"Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.","items":{"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json","description":"Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"},"values":{"type":"array","description":"Metro codes to exclude within the system (e.g., ['501', '602'] for Nielsen DMAs)","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false},"minItems":1},"geo_postal_areas":{"type":"array","description":"Restrict delivery to specific postal areas. Prefer the native country + postal system form. The deprecated legacy country-fused postal-system tokens remain accepted for compatibility. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_postal_areas_exclude":{"type":"array","description":"Exclude specific postal areas from delivery. Prefer the native country + postal system form. The deprecated legacy country-fused postal-system tokens remain accepted for compatibility. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_places":{"type":"array","description":"Restrict delivery to catalog-backed named places. Values MUST be stable identifiers in the declared system, not display names. Sellers must declare supported systems, countries, and place types in get_adcp_capabilities and reject unsupported entries rather than silently dropping them.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-area.json","x-adcp-schema-uri":"/schemas/core/geo-place-area.json"},"minItems":1},"geo_places_exclude":{"type":"array","description":"Exclude catalog-backed named places. Uses the same identifier-based shape as geo_places. Sellers MUST reject overlap with geo_places for the same country, system, place_type, and value.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-area.json","x-adcp-schema-uri":"/schemas/core/geo-place-area.json"},"minItems":1},"daypart_targets":{"type":"array","description":"Restrict delivery to specific time windows. Each entry specifies days of week, an hour range, and an optional timezone that defaults to inventory_local. A concrete IANA zone uses one shared civil-time clock, while inventory_local evaluates each inventory unit in its seller-assigned local timezone. Entries are independent and MAY use different clocks.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1daypart-target.json"},"minItems":1},"axe_include_segment":{"type":"string","description":"Deprecated: Use TMP provider fields instead. AXE segment ID to include for targeting.","deprecated":true},"axe_exclude_segment":{"type":"string","description":"Deprecated: Use TMP provider fields instead. AXE segment ID to exclude from targeting.","deprecated":true},"audience_include":{"type":"array","description":"Restrict delivery to members of these first-party CRM audiences. Only users present in the uploaded lists are eligible. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Not for lookalike expansion — express that intent in the campaign brief. Seller must declare support in get_adcp_capabilities.","items":{"type":"string"},"minItems":1},"audience_exclude":{"type":"array","description":"Suppress delivery to members of these first-party CRM audiences. Matched users are excluded regardless of other targeting. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Seller must declare support in get_adcp_capabilities.","items":{"type":"string"},"minItems":1},"signal_targeting_groups":{"title":"Targeting Signal Groups","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1package-signal-targeting-groups.json","description":"Basic Boolean grouping for seller-offered signals. v1 supports a required top-level operator 'all' and child groups with operator 'any' for include groups or 'none' for exclusion groups. Example semantics: group 1 any(A, B) plus group 2 none(C, D) means (A OR B) AND NOT (C OR D). Signal entries reference named signal definitions with signal_ref scope 'product' for product-local signal options or scope 'data_provider' for external signals published in adagents.json signals[]. For simple include-only targeting, send one child group with operator 'any'. Sellers SHOULD reject entries that are not available for the product through inline signal_targeting_options or get_signals, are not active for the account, or exceed the product's signal_targeting_allowed/signal_targeting_rules/product terms. Signal targeting limits are product-scoped, not declared in get_adcp_capabilities, because products may be backed by different ad servers. Sellers MUST echo applied signal_targeting_groups on the resulting package state, including fixed/default selections. Sellers MAY return REQUOTE_REQUIRED when a targeting mutation changes commercial terms."},"signal_targeting":{"type":"array","description":"DEPRECATED. Use signal_targeting_groups for package-level signal targeting. Legacy flat signal_targeting remains accepted during the SignalRef migration window but cannot express grouped include/exclude composition or product-scoped pricing.","deprecated":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-targeting.json"},"minItems":1},"demographics":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1demographic-targeting-intent.json","description":"Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis."},"frequency_cap":{"title":"Targeting Frequency Cap","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap.json"},"property_list":{"title":"Targeting Property List","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false."},"property_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list whose properties must not carry the buyer's ads. Matched properties are removed from delivery. Use for brand-safety do-not-run lists (apps, sites). Exclude wins on overlap with property_list, and applies regardless of the product's property_targeting_allowed flag. Seller must declare support in get_adcp_capabilities."},"collection_list":{"title":"Targeting Collection List","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for including specific collections (programs, publications, channels) within this product. The package runs on the intersection of matched collections and this list. Use for inclusion-based collection targeting. Seller must declare support in get_adcp_capabilities."},"collection_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for excluding specific collections (programs, publications, channels) from this product. Matched collections must not carry the buyer's ads. Use for brand safety do-not-air lists. Seller must declare support in get_adcp_capabilities."},"placement_selection":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1placement-selection.json","description":"Purchased placement selection within the product. This constrains package inventory; it is distinct from creative_assignments[].placement_refs, which only route individual creatives within the purchased set. On create, mode selected supplies the complete selected set and mode default uses the product default. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},"collection_selection":{"title":"Targeting Collection Selection","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1collection-selection.json","description":"Purchased collection selection within the product. On create, mode selected supplies the complete selected set and mode default uses the product's full bundle. On package readback this is the committed selection sellers MUST echo as concrete selectors, materializing any collection_list composition; collection_list fields remain the buyer-managed list mechanism. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},"age_restriction":{"type":"object","description":"Age restriction for compliance. Use for legal requirements (alcohol, gambling), not audience targeting.","properties":{"min":{"type":"integer","minimum":13,"maximum":99,"description":"Minimum age required"},"verification_required":{"type":"boolean","default":false,"description":"Whether verified age (not inferred) is required for compliance"},"accepted_methods":{"type":"array","description":"Accepted verification methods. If omitted, any method the platform supports is acceptable.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1age-verification-method.json"},"minItems":1}},"required":["min"],"additionalProperties":false},"device_platform":{"type":"array","description":"Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1device-platform.json"},"minItems":1},"device_platform_exclude":{"type":"array","description":"Exclude specific operating-system platforms from delivery. When a platform appears in both device_platform and device_platform_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1device-platform.json"},"minItems":1},"device_type":{"type":"array","description":"Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1device-type.json"},"minItems":1},"device_type_exclude":{"type":"array","description":"Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1device-type.json"},"minItems":1},"browser":{"type":"array","description":"Restrict delivery to specific canonical browser families in the impression delivery and rendering environment, not the post-click landing-page browser. Values MUST NOT be inferred solely from operating system, device, web/mobile-web inventory, or placement. Values in this array use OR semantics. When browser is supplied, families not listed are ineligible: other includes a seller-recognized family that is not explicitly enumerated, while unknown includes a browser the seller cannot classify into a recognized family. When the same family appears in browser and browser_exclude, exclusion wins. Browser and device constraints intersect; a seller that cannot enforce the exact combination MUST exclude or explicitly reconfigure the product during discovery and MUST reject it at create or update rather than silently widening delivery. Browser versions and seller-native IDs are intentionally unsupported.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true},"browser_exclude":{"type":"array","description":"Exclude specific canonical browser families from delivery. other excludes seller-recognized families that are not explicitly enumerated; unknown excludes browsers the seller cannot classify into a recognized family. When the same family appears in browser and browser_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true},"store_catchments":{"type":"array","description":"Target users within store catchment areas from a synced store catalog. Each entry references a store-type catalog and optionally narrows to specific stores or catchment zones.","items":{"type":"object","properties":{"catalog_id":{"type":"string","description":"Synced store-type catalog ID from sync_catalogs."},"store_ids":{"type":"array","description":"Filter to specific stores within the catalog. Omit to target all stores.","items":{"type":"string"},"minItems":1},"catchment_ids":{"type":"array","description":"Catchment zone IDs to target (e.g., 'walk', 'drive'). Omit to target all catchment zones.","items":{"type":"string"},"minItems":1}},"required":["catalog_id"],"additionalProperties":true},"minItems":1},"geo_proximity":{"type":"array","description":"Target users within travel time, distance, or a custom boundary around arbitrary geographic points. Multiple entries use OR semantics — a user within range of any listed point is eligible. For campaigns targeting 10+ locations, consider using store_catchments with a location catalog instead. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees (WGS 84). Required for travel_time and radius methods."},"lng":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees (WGS 84). Required for travel_time and radius methods."},"label":{"type":"string","description":"Human-readable label for this entry (e.g., 'Düsseldorf', 'Heathrow Airport', 'Primary trade area')."},"travel_time":{"type":"object","description":"Travel time limit for isochrone calculation. The platform resolves this to a geographic boundary based on actual transportation networks.","properties":{"value":{"type":"number","minimum":1,"description":"Travel time limit."},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1travel-time-unit.json"}},"required":["value","unit"],"additionalProperties":false},"transport_mode":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1transport-mode.json","description":"Transportation mode for isochrone calculation. Required when travel_time is provided."},"radius":{"type":"object","description":"Simple radius from the point. The platform draws a circle of this distance around the coordinates.","properties":{"value":{"type":"number","exclusiveMinimum":0,"description":"Radius distance."},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1distance-unit.json","description":"Distance unit."}},"required":["value","unit"],"additionalProperties":false},"geometry":{"type":"object","description":"Pre-computed GeoJSON geometry defining the proximity boundary. Use when the buyer has already calculated isochrones (via TravelTime, Mapbox, etc.) or has custom boundaries. When geometry is provided, lat/lng are not required.","properties":{"type":{"type":"string","enum":["Polygon","MultiPolygon"],"description":"GeoJSON geometry type."},"coordinates":{"type":"array","description":"GeoJSON coordinates array. For Polygon: array of linear rings. For MultiPolygon: array of polygons."}},"required":["type","coordinates"],"additionalProperties":false},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"oneOf":[{"required":["lat","lng","travel_time","transport_mode"],"not":{"anyOf":[{"required":["radius"]},{"required":["geometry"]}]}},{"required":["lat","lng","radius"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["geometry"]}]}},{"required":["geometry"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["radius"]}]}}],"additionalProperties":true},"minItems":1},"language":{"title":"Targeting Languages","type":"array","description":"Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1locale-tag.json"},"minItems":1},"keyword_targets":{"title":"Targeting Keywords","type":"array","description":"Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to target"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1match-type.json"},"bid_price":{"type":"number","minimum":0,"description":"Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies."}},"required":["keyword","match_type"],"additionalProperties":false},"minItems":1},"negative_keywords":{"title":"Targeting Negative Keywords","type":"array","description":"Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1negative-keyword.json"},"minItems":1}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-unknown-age-eligibility-constraint.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-verified-age-basis-constraint.json"}],"additionalProperties":true},"external:core/geo-metro.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-metro.json","title":"Geo Metro","description":"A targeted metro area.","type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json","description":"Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"},"values":{"type":"array","description":"Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false},"external:core/geo-place-area.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-place-area.json","title":"Geographic Place Area","description":"A catalog-backed named place target. Values are stable identifiers in the declared system. Entries within geo_places form a union; different geographic inclusion dimensions intersect. value_labels are diagnostic only and MUST NOT be used to resolve targeting.","x-adcp-validation":{"map_keys_subset_of_array":{"map_field":"value_labels","array_field":"values"},"description":"Every value_labels key MUST also appear in values. JSON Schema draft-07 cannot express this sibling-field key membership constraint, so conformance tooling must enforce it."},"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code containing the place."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-system.json"},"system_version":{"type":"string","minLength":1,"description":"Optional exact catalog version from the seller's declared supported_versions. When omitted, the seller applies catalog.current_version and MUST echo that version on persisted package state."},"place_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-type.json"},"values":{"type":"array","description":"Stable place identifiers in the declared system. Display names are not valid targeting values.","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true},"value_labels":{"type":"object","description":"Optional human-readable diagnostic labels keyed by identifiers present in values. Extra keys are a conformance error. Labels are non-authoritative and MUST NOT be used to resolve or apply targeting.","additionalProperties":{"type":"string","minLength":1}},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["country","system","place_type","values"],"allOf":[{"if":{"properties":{"system":{"enum":["geonames","google_ads","microsoft_ads"]}},"required":["system"]},"then":{"properties":{"values":{"items":{"type":"string","pattern":"^[0-9]+$"}}}}}],"additionalProperties":false},"external:core/geo-place-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-place-system.json","title":"Geographic Place Identifier System","description":"Collision-safe identifier namespace for geographic places. Registered tokens have protocol-defined semantics. Unregistered systems MUST use an absolute HTTPS URI controlled by the catalog owner; consumers compare URI systems as exact opaque strings.","anyOf":[{"type":"string","enum":["geonames","google_ads","microsoft_ads"]},{"type":"string","format":"uri","pattern":"^https://"}],"examples":["geonames","google_ads","microsoft_ads","https://seller.example/geo/catalogs/places"]},"external:core/geo-place-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-place-type.json","title":"Geographic Place Type","description":"Canonical place classification. Registered tokens have protocol-defined meanings. Catalog-specific classifications without a registered mapping MUST use an absolute HTTPS URI controlled by the vocabulary owner; consumers compare URI types as exact opaque strings.","anyOf":[{"type":"string","enum":["airport","borough","city","city_region","commune","county","district","municipality","neighborhood","post_town","prefecture","province","quarter","state","territory","ward"]},{"type":"string","format":"uri","pattern":"^https://"}],"examples":["city","municipality","borough","neighborhood","post_town","city_region","county","https://seller.example/geo/place-types/trade-area"]},"external:core/daypart-target.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/daypart-target.json","title":"Daypart Target","description":"A time window for daypart targeting. Specifies days of week, an hour range, and the civil-time clock used to evaluate it. start_hour is inclusive, end_hour is exclusive (e.g., 6-10 = 6:00am to 10:00am). Follows the Google Ads AdScheduleInfo / DV360 DayPartTargeting pattern.","type":"object","properties":{"days":{"type":"array","description":"Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1day-of-week.json"},"minItems":1},"start_hour":{"type":"integer","description":"Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm.","minimum":0,"maximum":23},"end_hour":{"type":"integer","description":"End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour.","minimum":1,"maximum":24},"timezone":{"description":"Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and hour with the half-open window: a skipped DST hour has no matching instants, while both occurrences of a repeated hour match. This delivery clock is independent of reporting_capabilities.timezone.","default":"inventory_local","x-added-in":"3.2.0","anyOf":[{"type":"string","const":"inventory_local"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1iana-timezone.json"}]},"label":{"type":"string","description":"Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')"}},"required":["days","start_hour","end_hour"],"additionalProperties":false},"external:enums/day-of-week.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/day-of-week.json","title":"Day of Week","description":"Days of the week for daypart targeting","type":"string","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"external:core/iana-timezone.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/iana-timezone.json","title":"IANA Timezone Identifier","description":"Concrete timezone identifier in the implementation's supported IANA Time Zone Database, such as America/New_York, CET, or UTC.","type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._+-]+(?:/[A-Za-z0-9._+-]+)*$","not":{"const":"inventory_local"},"x-added-in":"3.2.0","x-adcp-validation":{"iana_timezone":"value_must_resolve_in_the_implementations_supported_IANA_TZDB"}},"external:core/package-signal-targeting-groups.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/package-signal-targeting-groups.json","title":"Package Signal Targeting Groups","description":"Top-level basic Boolean composition for package signal targeting. The groups-level operator is required; v1 supports operator 'all', meaning every child group must be satisfied. This represents the portable baseline: (any of include group 1) AND (any of include group 2) AND NOT (any of exclude group N).","type":"object","properties":{"operator":{"type":"string","enum":["all"],"description":"Groups-level operator. Required even though v1 only supports 'all': every child group must be satisfied."},"groups":{"type":"array","description":"Signal targeting groups to evaluate. Use operator 'any' for include groups and 'none' for exclusion groups.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1package-signal-targeting-group.json"},"minItems":1}},"required":["operator","groups"],"additionalProperties":true},"external:core/package-signal-targeting-group.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/package-signal-targeting-group.json","title":"Package Signal Targeting Group","description":"A basic Boolean group of package-level signal targeting entries. 'any' means the user must match at least one signal in the group. 'none' means the user must match none of the signals in the group. Use groups for portable include/exclude composition such as (A OR B) AND NOT (C OR D).","type":"object","properties":{"operator":{"type":"string","description":"How to evaluate the signals in this group. 'any' is an OR include group. 'none' is an exclusion group equivalent to NOT (A OR B OR C).","enum":["any","none"]},"signals":{"type":"array","description":"Signal targeting entries evaluated by this group. Each entry uses the package signal targeting shape, including signal_ref, value expression, and optional pricing, execution-handle, or activation fields.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1package-signal-targeting.json"},"minItems":1}},"required":["operator","signals"],"additionalProperties":true},"external:core/package-signal-targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/package-signal-targeting.json","title":"Package Signal Targeting","description":"Buy-time selection of one seller-offered signal inside a package signal targeting group. The signal_ref uses scope 'product' for a product-local signal option, scope 'data_provider' for a signal defined in a data provider's published adagents.json signals[], or scope 'signal_source' for a source-native signal that is not published in adagents.json signals[]. The selected product's inline Product.signal_targeting_options, get_signals feed when inline options are omitted, and signal_targeting_rules define buy-time eligibility. Inclusion and exclusion are controlled by the parent group operator: use operator 'any' to include users matching the signal expression and operator 'none' to exclude users matching the signal expression. For binary signals, value MUST be true; do not use value=false for exclusion inside signal_targeting_groups. Use audience_include/audience_exclude only for buyer-managed first-party audiences registered through sync_audiences.","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-targeting-expression.json"}],"properties":{"pricing_option_id":{"type":"string","description":"Pricing option selected for this signal. Use the pricing_option_id from the product's signal_targeting_options entry when product-scoped pricing is present; otherwise use the seller get_signals pricing only when the product option does not override it. Required when the selected signal has pricing_options; omit only when the signal is bundled into the product price or has no incremental cost.","x-entity":"vendor_pricing_option"},"signal_agent_segment_id":{"type":"string","description":"Optional opaque resolved-segment or seller execution handle for this signal. Omit when signal_ref plus the value expression is sufficient for the seller to resolve the signal. Include when the product option exposes a separate runtime or activation handle, and pass it verbatim. Buyers SHOULD prefer an exposed segment handle over reconstructing condition identity from categorical values because the handle can carry provider namespace and methodology distinctions.","x-entity":"signal_activation_id"},"activation_key":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1activation-key.json","description":"Destination-specific activation key returned by get_signals or activate_signal. Usually omitted for seller-offered signals selected directly through the same seller; include only when the selected signal was separately activated and the seller requires the activation key to correlate the package selection."}},"additionalProperties":true},"external:core/signal-targeting-expression.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/signal-targeting-expression.json","title":"Signal Targeting Expression","description":"Predicate over a named signal definition. Signals are typed dimensions, similar to feature values: binary signals match true, categorical signals match one of a set of values, and numeric signals match a range. In package signal targeting groups, include/exclude semantics are controlled by the parent group operator, not by negating the expression.","discriminator":{"propertyName":"value_type"},"oneOf":[{"type":"object","description":"Binary signal expression. In grouped package targeting, value is always true; use a parent group with operator 'none' for exclusion.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"binary","description":"Discriminator for binary signals."},"value":{"type":"boolean","const":true,"description":"Binary package signal entries match users for whom the signal is true. Use the parent group operator for include/exclude."}},"required":["signal_ref","value_type","value"],"additionalProperties":true},{"type":"object","description":"Categorical signal expression - target users with one of the listed values.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"categorical","description":"Discriminator for categorical signals."},"values":{"type":"array","description":"Values to target. Users with any of these values match the expression.","items":{"type":"string"},"minItems":1}},"required":["signal_ref","value_type","values"],"additionalProperties":true},{"type":"object","description":"Numeric signal expression - target users within a value range. At least one of min_value or max_value is required. If both min_value and max_value are provided, min_value MUST be <= max_value.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"numeric","description":"Discriminator for numeric signals."},"min_value":{"type":"number","description":"Minimum value, inclusive. Omit for no minimum. Should be within the signal definition's range when declared."},"max_value":{"type":"number","description":"Maximum value, inclusive. Omit for no maximum. Should be within the signal definition's range when declared."}},"required":["signal_ref","value_type"],"anyOf":[{"required":["min_value"]},{"required":["max_value"]}],"additionalProperties":true}]},"external:core/activation-key.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/activation-key.json","title":"Activation Key","description":"Universal identifier for using a signal on a destination platform. Can be either a segment ID or a key-value pair depending on the platform's targeting mechanism.","type":"object","discriminator":{"propertyName":"type"},"oneOf":[{"properties":{"type":{"type":"string","const":"segment_id","description":"Segment ID based targeting"},"segment_id":{"type":"string","description":"The platform-specific segment identifier to use in campaign targeting"}},"required":["type","segment_id"],"additionalProperties":true},{"properties":{"type":{"type":"string","const":"key_value","description":"Key-value pair based targeting"},"key":{"type":"string","description":"The targeting parameter key"},"value":{"type":"string","description":"The targeting parameter value"}},"required":["type","key","value"],"additionalProperties":true}]},"external:core/demographic-targeting-intent.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/demographic-targeting-intent.json","title":"Demographic Targeting Intent","description":"Portable demographic targeting intent plus buyer constraints on how the seller may determine user eligibility. The age predicate retains its canonical interval meaning; accepted_bases narrows execution provenance without changing which ages are requested.","type":"object","properties":{"age":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1demographic-age-range.json"},{"type":"object","properties":{"accepted_bases":{"type":"array","description":"User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1age-determination-basis.json"},"minItems":1,"uniqueItems":true},"accepted_verification_methods":{"type":"array","description":"Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1age-verification-method.json"},"minItems":1,"uniqueItems":true}},"allOf":[{"if":{"required":["accepted_verification_methods"]},"then":{"required":["accepted_bases"],"properties":{"accepted_bases":{"contains":{"const":"verified"}}}}}],"additionalProperties":true}]}},"required":["age"],"additionalProperties":true},"external:core/demographic-age-range.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/demographic-age-range.json","title":"Demographic Age Range","description":"A canonical audience-age predicate in completed integer years. min and max are inclusive; omitting one bound means no restriction in that direction. At least one bound is required. include_unknown is always explicit because people whose age is unavailable are not members of any numeric interval. Implementations MUST reject min greater than max; JSON Schema draft-07 cannot compare sibling numeric values.","type":"object","properties":{"min":{"type":"integer","minimum":0,"maximum":150,"description":"Inclusive minimum age in completed years. Omit for an open lower bound."},"max":{"type":"integer","minimum":0,"maximum":150,"description":"Inclusive maximum age in completed years. Omit for an open upper bound."},"include_unknown":{"type":"boolean","description":"Whether delivery to people whose age is unavailable is part of this predicate. This field has no default and MUST be supplied."}},"required":["include_unknown"],"anyOf":[{"required":["min"]},{"required":["max"]}],"additionalProperties":true},"external:enums/age-determination-basis.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/age-determination-basis.json","title":"Age Determination Basis","description":"User-level bases that may resolve age for demographic targeting execution. Population estimates are deliberately absent because aggregate composition cannot establish an individual impression's age.","type":"string","enum":["verified","declared","inferred"],"enumDescriptions":{"verified":"The user's applicable age claim was established through an age-assurance or identity-verification method.","declared":"The user supplied an age, date of birth, or threshold affirmation without independent verification.","inferred":"The user's age was predicted from behavior, attributes, or another model."}},"external:enums/age-verification-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/age-verification-method.json","title":"Age Verification Method","description":"Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.","type":"string","enum":["facial_age_estimation","id_document","digital_id","credit_card","world_id"]},"external:core/frequency-cap.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/frequency-cap.json","title":"Frequency Cap","description":"Frequency capping settings for package-level application. Two types of frequency control can be used independently or together: suppress enforces a cooldown between consecutive exposures; max_impressions + per + window caps total exposures per entity in a time window. When both suppress and max_impressions are set, an impression is delivered only if both constraints permit it (AND semantics). At least one of suppress, suppress_minutes, or max_impressions must be set. Field location determines scope; this value has no scope discriminator. The MediaBuy root uses the narrower media-buy-frequency-cap schema, which permits maximum impressions only in 3.2.","type":"object","properties":{"suppress":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1duration.json"}],"description":"Cooldown period between consecutive exposures to the same entity. Prevents back-to-back ad delivery (e.g. {\"interval\": 60, \"unit\": \"minutes\"} for a 1-hour cooldown). Preferred over suppress_minutes."},"suppress_minutes":{"type":"number","deprecated":true,"description":"Deprecated — use suppress instead. Cooldown period in minutes between consecutive exposures to the same entity (e.g. 60 for a 1-hour cooldown).","minimum":0},"max_impressions":{"type":"integer","description":"Maximum number of impressions per entity per window. For duration windows, implementations typically use a rolling window. campaign applies across the owning field's full flight: the package flight for a targeting overlay, or the MediaBuy flight for a root cap.","minimum":1},"per":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1reach-unit.json"}],"description":"Entity granularity for impression counting. Required when max_impressions is set."},"window":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1duration.json"}],"description":"Time window for the max_impressions cap (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Required when max_impressions is set."}},"anyOf":[{"required":["suppress"]},{"required":["suppress_minutes"]},{"required":["max_impressions"]}],"additionalProperties":true,"dependentRequired":{"max_impressions":["per","window"],"per":["max_impressions"],"window":["max_impressions"]}},"external:enums/reach-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/reach-unit.json","title":"Reach Unit","description":"Unit of measurement for reach and audience size metrics. Different channels and measurement providers count reach in fundamentally different units, making cross-channel comparison impossible without declaring the unit.","type":"string","enum":["individuals","households","devices","accounts","cookies","custom"],"enumDescriptions":{"individuals":"Unique people. Panel-based or identity-resolved measurement.","households":"Unique households or TV homes.","devices":"Unique device identifiers (IDFA, GAID, CTV device ID).","accounts":"Unique logged-in accounts (platform-specific identity).","cookies":"Unique browser cookies.","custom":"Seller-defined reach unit. Describe in ext. For a Product.identity declaration with persistent_identifier false, describe the unit in Product.identity.reach_methodology."}},"external:core/property-list-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/property-list-ref.json","title":"Property List Reference","description":"Reference to an externally managed property list. Enables passing large property sets (50,000+) without embedding them in requests. The receiving agent fetches and caches the list independently.","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent managing the property list"},"list_id":{"type":"string","description":"Identifier for the property list within the agent","minLength":1,"x-entity":"property_list"},"auth_token":{"type":"string","description":"JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."}},"required":["agent_url","list_id"],"additionalProperties":false},"external:core/collection-list-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/collection-list-ref.json","title":"Collection List Reference","description":"Reference to an externally managed collection list. Enables passing large collection exclusion/inclusion sets without embedding them in requests. The receiving agent fetches and caches the list independently.","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent managing the collection list"},"list_id":{"type":"string","description":"Identifier for the collection list within the agent","minLength":1,"x-entity":"collection_list"},"auth_token":{"type":"string","description":"JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."}},"required":["agent_url","list_id"],"additionalProperties":false},"external:core/placement-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/placement-selection.json","title":"Placement Selection","description":"Complete purchased placement set within a product. This is inventory targeting, not creative routing: creative_assignments[].placement_refs route a creative only within this purchased set. Requests use mode selected to name the complete required set or mode default to accept the product/seller default. Across discovery, create, and update, a selected set is satisfied inherently when it exactly equals a fixed product's complete included placement set; this exact restatement does not require overlay_support.placement_selection, while partial selection does. Included placements are never independently selectable. Products with any fixed mode:included placement cannot advertise selectable placement overlay support because the fixed placement would make a partial buyer-selected set incomplete; sellers expose separately selectable inventory when needed. Successful package readback MUST echo the committed selected set. Sellers reject unknown, duplicate, cross-publisher, incompatible, or partially applicable refs rather than silently changing the selection.","type":"object","discriminator":{"propertyName":"mode"},"oneOf":[{"title":"Selected placements","type":"object","properties":{"mode":{"type":"string","const":"selected"},"placement_refs":{"type":"array","description":"Complete required placement set. A reference normally identifies a mode targetable placement. It MAY identify a mode included placement only when the set exactly equals the product's complete fixed included set, which is an inherent match rather than independent selection. Legacy publisher refs use {publisher_domain, placement_id}; authority-discriminated 3.2 identities use placement-identity.json so seller-inline inventory is selected by {seller_agent, placement_id}. An item that exactly matches placement-identity uses that canonical identity; otherwise a released-compatible item with publisher_domain and placement_id uses legacy product-context matching, and tolerated product metadata such as kind, name, or mode has no selection effect.","items":{"anyOf":[{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1placement-ref.json"},{"required":["publisher_domain"]}]},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1placement-identity.json"}]},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["mode","placement_refs"],"additionalProperties":false},{"title":"Product default placements","type":"object","properties":{"mode":{"type":"string","const":"default"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["mode"],"additionalProperties":false}]},"external:core/placement-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/placement-ref.json","title":"Placement Reference","description":"Legacy-compatible product-context reference to a placement. For publisher-catalog placements, publisher_domain plus placement_id resolves the declaration in that publisher's adagents.json. For seller-inline placements, the enclosing seller and product supply scope. When publisher_domain is omitted on legacy inputs, receivers MAY interpret the ID relative to the enclosing single-publisher product. Use placement-identity.json when a self-contained cross-document identity is required.","type":"object","properties":{"publisher_domain":{"type":"string","description":"Domain where the adagents.json declaring a publisher-catalog placement is hosted, or the inventory publisher associated with an inline placement. Omitted only for legacy single-publisher product-context references.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"placement_id":{"type":"string","description":"Placement ID from the publisher's adagents.json placement catalog, or an inline seller-defined placement ID interpreted within the enclosing seller and product context.","x-entity":"placement"}},"required":["placement_id"],"additionalProperties":true},"external:core/placement-identity.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/placement-identity.json","title":"Placement Identity","description":"Self-contained identity for either a publisher-catalog placement or a sales-agent-defined inline placement. The discriminator names which authority owns placement_id.","oneOf":[{"title":"Publisher catalog placement identity","type":"object","properties":{"kind":{"type":"string","const":"publisher_ref"},"publisher_domain":{"type":"string","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","description":"Domain whose adagents.json declares placement_id."},"placement_id":{"type":"string","minLength":1,"x-entity":"placement"}},"required":["kind","publisher_domain","placement_id"],"additionalProperties":false},{"title":"Seller inline placement identity","type":"object","properties":{"kind":{"type":"string","const":"seller_inline"},"seller_agent":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1seller-agent-ref.json","description":"Sales agent that defines and maintains the inline placement namespace."},"placement_id":{"type":"string","minLength":1,"description":"Stable placement ID within the defining sales agent's namespace. The agent MUST NOT reuse it for a different semantic placement.","x-entity":"placement"}},"required":["kind","seller_agent","placement_id"],"additionalProperties":false}]},"external:core/seller-agent-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/seller-agent-ref.json","title":"Seller Agent Reference","description":"Structured reference to a seller agent. The canonical identifier is the agent's URL as declared in the property publisher's adagents.json `authorized_agents[].url`. The optional `id` slot is reserved for a future registry-assigned stable identifier; it is not used today. This shape mirrors `format-id` and `ProviderEntry` — URL-first, with an ID slot for forward compatibility.","x-status":"experimental","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"The seller agent's API endpoint URL as declared in the property publisher's adagents.json `authorized_agents[].url`. MUST use the `https://` scheme. Receivers compare this URL against the `authorized_agents` list using the AdCP URL canonicalization rules — not byte-equality — and reject mismatches with `seller_not_authorized`. See docs/reference/url-canonicalization."},"id":{"type":"string","description":"Reserved for a future registry-assigned stable seller identifier. Not used today — senders MUST NOT populate this field until a registry is defined. When a future release populates both `agent_url` and `id`, `agent_url` remains authoritative and `id` is advisory.","pattern":"^[a-zA-Z0-9_-]+$","minLength":1}},"required":["agent_url"],"additionalProperties":false,"examples":[{"agent_url":"https://agent.acme.example"}]},"external:core/collection-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/collection-selection.json","title":"Collection Selection","description":"Complete purchased collection set within a product. Mode selected names the complete required set (partial selection requires product collection_targeting_allowed: true; exactly restating the full bundle is an inherent match); mode default accepts the product's full bundle. Package readback MUST echo the committed selection here as concrete selectors, materializing any collection_list composition; a purchase made with mode default therefore reads back as mode selected naming the product's complete bundle. Rejection of a schema-valid selector that references an unknown collection_id or publisher_domain uses REFERENCE_NOT_FOUND per the error-code registry (INVALID_REQUEST applies only to schema-invalid shapes such as a selected-mode item omitting collection_ids). Sellers reject unknown, duplicate, or partially applicable selectors rather than silently changing the selection.","type":"object","discriminator":{"propertyName":"mode"},"oneOf":[{"title":"Selected collections","type":"object","properties":{"mode":{"type":"string","const":"selected"},"collections":{"type":"array","description":"Complete required collection set as domain-qualified selectors with explicit collection_ids; the domain-only bulk-grant form is authorization scoping, not selection. publisher_domain may be an external channel owner's domain.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1collection-selector.json"},{"required":["collection_ids"]}]},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["mode","collections"],"additionalProperties":false},{"title":"Product default collections","type":"object","properties":{"mode":{"type":"string","const":"default"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["mode"],"additionalProperties":false}]},"external:core/collection-selector.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/collection-selector.json","title":"Collection Selector","description":"References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json — the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).","type":"object","properties":{"publisher_domain":{"type":"string","description":"Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"collection_ids":{"type":"array","description":"Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.","items":{"type":"string","x-entity":"collection"},"minItems":1}},"required":["publisher_domain"],"additionalProperties":true},"external:enums/device-platform.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/device-platform.json","title":"Device Platform","description":"Operating system platforms for device targeting. Browser values from Sec-CH-UA-Platform standard, extended for CTV.","type":"string","enum":["ios","android","windows","macos","linux","chromeos","tvos","tizen","webos","fire_os","roku_os","unknown"]},"external:enums/device-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/device-type.json","title":"Device Type","description":"Device form factor categories for targeting and reporting. Complements device-platform (operating system) with hardware classification. OpenRTB mapping: 1 (Mobile/Tablet General) → mobile, 2 (PC) → desktop, 4 (Phone) → mobile, 5 (Tablet) → tablet, 6 (Connected Device) → ctv, 7 (Set Top Box) → ctv. DOOH inventory uses dooh.","type":"string","enum":["desktop","mobile","tablet","ctv","dooh","unknown"]},"external:enums/browser-family.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/browser-family.json","title":"Browser Family","description":"Portable browser families for targeting the impression delivery and rendering environment, not a post-click landing-page browser. Values identify browser families, not versions or seller-native browser IDs, and MUST NOT be inferred solely from operating system, device, web/mobile-web inventory, or placement. android_webview means an impression reliably classified as rendering in Android WebView. other means a seller-recognized browser family that is not explicitly enumerated; unknown means the seller cannot classify the browser into a recognized family.","type":"string","enum":["chrome","safari","firefox","edge","opera","samsung_internet","android_webview","other","unknown"]},"external:core/locale-tag.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/locale-tag.json","title":"Language Tag","description":"A well-formed BCP 47 language tag used by AdCP only as language identity. Script and region may refine that identity; other valid BCP 47 subtags remain part of tag matching but do not make this a general locale-settings object. It does not determine currency, time zone, number/date formatting, market, or legal jurisdiction. The AdCP canonical wire profile requires lower-case language and variants, title-case script, and upper-case region (for example `en-US`, `zh-Hant-TW`, or `x-private`). RFC 5646 comparisons are case-insensitive and its case regularization is optional; AdCP intentionally requires this stricter single wire spelling and receivers MUST reject differently cased tags rather than silently normalizing them. The schema pattern enforces the AdCP casing profile and extension structure for commonly used tags; conforming receivers additionally validate the complete RFC 5646 grammar and registry rules. Every new AdCP field carrying BCP 47 language identity or a concrete language range MUST reference this schema instead of declaring independent string constraints.","x-adcp-validation":{"verifier_constraints":{"well_formed":"rfc5646","semantic_scope":"language_identity_only","canonical_wire_profile":"adcp_bcp47_casing","rfc5646_comparison":"case_insensitive","non_profile":"reject"},"spec":"docs/protocol/language-and-localization.mdx#one-language-tag-primitive"},"type":"string","minLength":2,"maxLength":63,"pattern":"^(?:[a-z]{2,8}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?|x(?:-[a-z0-9]{1,8})+)$","examples":["en-US","es-ES","zh-Hant-TW","x-private"]},"external:core/negative-keyword.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/negative-keyword.json","title":"Negative Keyword","description":"An excluded keyword.","type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to exclude"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1match-type.json"}},"required":["keyword","match_type"],"additionalProperties":false},"external:core/targeting-unknown-age-eligibility-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/targeting-unknown-age-eligibility-constraint.json","title":"Targeting Unknown Age Eligibility Constraint","description":"Unknown-age delivery cannot satisfy a minimum-age eligibility policy. When demographic audience targeting and age_restriction are both present, include_unknown must be false.","if":{"required":["demographics","age_restriction"]},"then":{"properties":{"demographics":{"properties":{"age":{"properties":{"include_unknown":{"const":false}}}}}}}},"external:core/targeting-verified-age-basis-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/targeting-verified-age-basis-constraint.json","title":"Targeting Verified Age Basis Constraint","description":"A legal verification requirement always narrows demographic targeting. When the buyer supplies accepted_bases and age_restriction requires verification, verified must be accepted; otherwise the constraints have an empty intersection and the request is invalid.","if":{"properties":{"age_restriction":{"properties":{"verification_required":{"const":true}},"required":["verification_required"]},"demographics":{"properties":{"age":{"required":["accepted_bases"]}},"required":["age"]}},"required":["demographics","age_restriction"]},"then":{"properties":{"demographics":{"properties":{"age":{"properties":{"accepted_bases":{"contains":{"const":"verified"}}}}}}}}},"external:core/media-buy-frequency-cap.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/media-buy-frequency-cap.json","title":"Media Buy Frequency Cap","description":"A MediaBuy-level maximum-impression cap. The counter is shared across participating packages for the declared per unit. Duration windows are rolling elapsed windows; campaign spans the MediaBuy flight. Aggregate suppression is not defined in 3.2 because suppress-only FrequencyCap values do not identify a counter entity.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap.json"},{"required":["max_impressions"],"not":{"anyOf":[{"required":["suppress"]},{"required":["suppress_minutes"]}]}}]},"external:core/targeting-overlay-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/targeting-overlay-requirements.json","title":"Targeting Overlay Requirements","description":"Buyer minimum requirements for targeting dimensions that will be selected on packages later. This request shape deliberately excludes seller limits such as max_values_per_package and max_packages. Matching is capability containment: where a field permits a boolean form, a requirement value of true matches product support true or any valid positive support object, and product support true satisfies every protocol-valid structured requirement except daypart_targets, where true promises inventory_local only. Otherwise, structured product support must contain the structured requirement. For geo_regions and geo_regions_exclude, every requested country must exist; requested all_values requires supported all_values; and requested values must be a subset of supported values unless support declares all_values. For geo_places and geo_places_exclude, every requested system and country key must exist and each requested place-type and system-version array must be a subset of the corresponding product array. Include and exclude fields match independently. Every valid structured requirement or support object represents a positive capability; empty, extension-only, and false-only objects are invalid. Object fields the buyer did not request do not participate. Missing or unknown required fields do not match. Numeric seller limits are disclosed only in Product.overlay_support and never participate in matching. Legacy frequency_cap: true matches only the unchanged broad declaration. frequency_cap_support matches either legacy true or a containing structured declaration; an empty object requests either positive form. A requirement carries at most one of the two.","type":"object","properties":{"geo_countries":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"geo_countries_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"geo_regions":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-region-requirement.json","x-adcp-schema-uri":"/schemas/core/geo-region-requirement.json"}]},"geo_regions_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-region-requirement.json","x-adcp-schema-uri":"/schemas/core/geo-region-requirement.json"}]},"geo_metros":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/metroRequirement"},"geo_metros_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/metroRequirement"},"geo_places":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-requirement.json","x-adcp-schema-uri":"/schemas/core/geo-place-requirement.json"},"geo_places_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-requirement.json","x-adcp-schema-uri":"/schemas/core/geo-place-requirement.json"},"geo_postal_areas":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1positive-postal-area-support.json"}]},"geo_postal_areas_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1positive-postal-area-support.json"}]},"geo_proximity":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","properties":{"radius":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"travel_time":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"geometry":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"transport_modes":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1transport-mode.json"},"minItems":1,"uniqueItems":true}},"anyOf":[{"required":["radius"]},{"required":["travel_time"]},{"required":["geometry"]},{"required":["transport_modes"]}],"additionalProperties":false}]},"daypart_targets":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/daypartRequirement"},"audience_include":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"audience_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"signal_targeting_groups":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"demographics":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","properties":{"age":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"}},"required":["age"],"additionalProperties":false}]},"frequency_cap":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"frequency_cap_support":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap-requirements.json","description":"Minimum structured package-cap support. Matches a broad legacy frequency_cap: true or a containing frequency_cap_support object. Mutually exclusive with a frequency_cap: true requirement, which would exclude every constrained product."},"property_list":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"property_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"collection_list":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"collection_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"placement_selection":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"age_restriction":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"device_platform":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"device_platform_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"device_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"device_type_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"browser":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/browserRequirement"},"browser_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/browserRequirement"},"store_catchments":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"language":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"keyword_targets":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/keywordRequirement"},"negative_keywords":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/keywordRequirement"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"minProperties":1,"not":{"required":["frequency_cap","frequency_cap_support"]},"additionalProperties":false,"$defs":{"required":{"type":"boolean","const":true},"metroRequirement":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","properties":{"systems":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json"},"minItems":1,"uniqueItems":true}},"required":["systems"],"additionalProperties":false}]},"keywordRequirement":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","properties":{"supported_match_types":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1match-type.json"},"minItems":1,"uniqueItems":true}},"required":["supported_match_types"],"additionalProperties":false}]},"browserRequirement":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","description":"Require later package-level selection for the listed canonical browser families. The requirement matches unrestricted true support or structured support containing every requested family.","properties":{"families":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true}},"required":["families"],"additionalProperties":false}]},"daypartRequirement":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","description":"Require later package-level daypart selection using each listed timezone mode. Structured product support must contain every requested mode. For backward compatibility, daypart_targets support true satisfies inventory_local requirements only and does not satisfy requirements for iana.","properties":{"timezone_modes":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1daypart-timezone-mode.json"},"minItems":1,"uniqueItems":true},"iana_timezones":{"type":"array","description":"Exact concrete IANA timezone identifiers that must remain selectable after discovery. Valid only when timezone_modes includes iana.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1iana-timezone.json"},"minItems":1,"uniqueItems":true}},"required":["timezone_modes"],"allOf":[{"if":{"required":["iana_timezones"]},"then":{"properties":{"timezone_modes":{"contains":{"const":"iana"}}}}}],"additionalProperties":false}]}}},"external:enums/daypart-timezone-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/daypart-timezone-mode.json","title":"Daypart Timezone Mode","description":"Clock modes a product supports for daypart targeting.","type":"string","enum":["inventory_local","iana"],"x-added-in":"3.2.0"},"external:core/geo-region-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-region-requirement.json","title":"Geographic Region Requirement","description":"Buyer minimum requirements for ISO 3166-2 subdivision values that must remain independently selectable later. Country keys prevent a false cross-country capability claim. all_values requires support for every protocol-valid ISO subdivision active in the seller's support snapshot when the declaration is issued; values requests an exact finite candidate set. Exact delivery values known now belong in get_products.targeting_overlay instead.","type":"object","properties":{"countries":{"type":"object","description":"Required ISO subdivision support keyed by ISO 3166-1 alpha-2 country.","propertyNames":{"pattern":"^[A-Z]{2}$"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"all_values":{"type":"boolean","const":true,"description":"Require every protocol-valid ISO 3166-2 subdivision active in the seller's returned support snapshot for this country to remain selectable."}},"required":["all_values"],"additionalProperties":false},{"type":"object","properties":{"values":{"type":"array","description":"Exact finite set of ISO 3166-2 identifiers the buyer may select later.","items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1,"uniqueItems":true}},"required":["values"],"additionalProperties":false}]},"minProperties":1}},"required":["countries"],"additionalProperties":false,"x-adcp-validation":{"verifier_constraints":{"country_prefix_matches_map_key":{"map_field":"countries","values_field":"values"}},"spec":"docs/media-buy/advanced-topics/targeting.mdx#geo_regions"}},"external:core/geo-place-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-place-requirement.json","title":"Geographic Place Requirement","description":"Identifier systems and collision-safe country/type pairs the buyer must be allowed to select later.","type":"object","properties":{"systems":{"type":"object","propertyNames":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-system.json"},"additionalProperties":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-requirement.json/$defs/catalogRequirement"},"minProperties":1}},"required":["systems"],"additionalProperties":false,"$defs":{"catalogRequirement":{"type":"object","description":"Required country/type pairs and optional exact catalog versions for one identifier system. Country keys prevent a false Cartesian product between countries and place types.","properties":{"countries":{"type":"object","propertyNames":{"pattern":"^[A-Z]{2}$"},"additionalProperties":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-type.json"},"minItems":1,"uniqueItems":true},"minProperties":1},"system_versions":{"type":"array","description":"Optional exact catalog versions that must remain selectable. Versions are opaque strings, not ordered ranges.","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true}},"required":["countries"],"additionalProperties":false}}},"external:core/positive-postal-area-support.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/positive-postal-area-support.json","title":"Positive Postal Area Support","description":"Non-vacuous postal capability used for hard targeting requirements and product overlay support. At least one native system array or true-valued deprecated alias is required. The general seller-capabilities postal schema remains permissive for backward compatibility, but an empty or false-only map cannot satisfy a hard discovery requirement.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-area-support.json"},{"type":"object","minProperties":1,"properties":{"us_zip":{"const":true},"us_zip_plus_four":{"const":true},"gb_outward":{"const":true},"gb_full":{"const":true},"ca_fsa":{"const":true},"ca_full":{"const":true},"de_plz":{"const":true},"fr_code_postal":{"const":true},"au_postcode":{"const":true},"ch_plz":{"const":true},"at_plz":{"const":true}}}]},"external:core/postal-area-support.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/postal-area-support.json","title":"Postal Area Support","description":"Declares supported postal area systems. Native support is keyed by ISO 3166-1 alpha-2 country with arrays of country-local postal systems. Deprecated country-fused boolean aliases may be included during migration.","type":"object","properties":{"US":{"type":"array","items":{"enum":["zip","zip_plus_four"]},"minItems":1,"uniqueItems":true},"GB":{"type":"array","items":{"enum":["outward","full"]},"minItems":1,"uniqueItems":true},"CA":{"type":"array","items":{"enum":["fsa","full"]},"minItems":1,"uniqueItems":true},"DE":{"type":"array","items":{"const":"plz"},"minItems":1,"uniqueItems":true},"CH":{"type":"array","items":{"const":"plz"},"minItems":1,"uniqueItems":true},"AT":{"type":"array","items":{"const":"plz"},"minItems":1,"uniqueItems":true},"FR":{"type":"array","items":{"const":"code_postal"},"minItems":1,"uniqueItems":true},"AU":{"type":"array","items":{"const":"postcode"},"minItems":1,"uniqueItems":true},"BR":{"type":"array","items":{"const":"cep"},"minItems":1,"uniqueItems":true},"IN":{"type":"array","items":{"const":"pin"},"minItems":1,"uniqueItems":true},"ZA":{"type":"array","items":{"const":"postal_code"},"minItems":1,"uniqueItems":true},"us_zip":{"type":"boolean","deprecated":true},"us_zip_plus_four":{"type":"boolean","deprecated":true},"gb_outward":{"type":"boolean","deprecated":true},"gb_full":{"type":"boolean","deprecated":true},"ca_fsa":{"type":"boolean","deprecated":true},"ca_full":{"type":"boolean","deprecated":true},"de_plz":{"type":"boolean","deprecated":true},"fr_code_postal":{"type":"boolean","deprecated":true},"au_postcode":{"type":"boolean","deprecated":true},"ch_plz":{"type":"boolean","deprecated":true},"at_plz":{"type":"boolean","deprecated":true}},"propertyNames":{"anyOf":[{"pattern":"^[A-Z]{2}$"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1legacy-postal-system.json"}]},"additionalProperties":{"type":"array","items":{"enum":["postal_code","custom"]},"minItems":1,"uniqueItems":true}},"external:core/frequency-cap-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/frequency-cap-requirements.json","title":"Frequency Cap Requirements","description":"Buyer minimums for structured product frequency-cap support. An empty object requests any positive support. Otherwise each array must be a subset of the product's resolved support, where a product field omitted from frequency_cap_support inherits the seller-wide media_buy.frequency_capping declaration (an omitted seller-wide list means every value). Duration units resolve the same way: a requested window or suppression unit matches when the product lists it in window_constraints or suppression_constraints, or, when the product omits that list, when the seller-wide supported_window_units includes it or is omitted. A legacy package declaration of frequency_cap: true satisfies every requirement because its broad meaning is unchanged. Exact count and interval values belong in a concrete cap supplied during discovery.","type":"object","properties":{"mutable_fields":{"type":"array","description":"Require each listed logical field to be mutable after creation. Matches a product whose mutable_fields contains every listed value, or a product that omits mutable_fields, or legacy frequency_cap: true. A product declaring mutable_fields: [] is create-only and never matches a non-empty list.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1frequency-cap-mutable-field.json"},"minItems":1,"uniqueItems":true},"supported_control_modes":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1frequency-cap-control-mode.json"},"minItems":1,"uniqueItems":true},"supported_per_units":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1reach-unit.json"},"minItems":1,"uniqueItems":true},"supported_window_units":{"type":"array","description":"Require each listed unit to be a supported max_impressions.window unit after seller-wide inheritance.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap-duration-unit.json"},"minItems":1,"uniqueItems":true},"supported_suppression_units":{"type":"array","description":"Require each listed unit to be a supported suppress unit after seller-wide inheritance.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap-duration-unit.json"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"external:enums/frequency-cap-mutable-field.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/frequency-cap-mutable-field.json","title":"Frequency Cap Mutable Field","description":"A logical frequency-cap field that a product implementation can change after creation. suppress covers the effective cooldown whether represented by suppress or the deprecated suppress_minutes alias.","type":"string","enum":["max_impressions","per","window","suppress"]},"external:enums/frequency-cap-control-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/frequency-cap-control-mode.json","title":"Frequency Cap Control Mode","description":"A supported package frequency-cap control shape.","type":"string","enum":["max_impressions","suppress","max_impressions_and_suppress"]},"external:core/frequency-cap-duration-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/frequency-cap-duration-unit.json","title":"Frequency Cap Duration Unit","description":"A duration unit supported for a frequency-cap window or suppression period.","type":"string","enum":["seconds","minutes","hours","days","campaign"]},"external:core/media-buy-support-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/media-buy-support-requirements.json","title":"Product Media Buy Support Requirements","description":"Buyer minimums for product participation in shared MediaBuy-level execution. Missing or unknown required capabilities exclude the product.","type":"object","properties":{"frequency_cap":{"type":"boolean","const":true,"description":"Require product participation in one shared MediaBuy frequency-cap counter."},"frequency_cap_constraints":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1media-buy-frequency-cap-requirement.json"}},"minProperties":1,"additionalProperties":false,"dependentRequired":{"frequency_cap_constraints":["frequency_cap"]}},"external:core/media-buy-frequency-cap-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/media-buy-frequency-cap-requirement.json","title":"Media Buy Frequency Cap Requirement","description":"Buyer minimum product-support detail for an aggregate MediaBuy frequency cap. Aggregate support in 3.2 is max-impressions only.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap-requirements.json"},{"type":"object","properties":{"supported_control_modes":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1media-buy-frequency-cap-control-mode.json"},"minItems":1,"uniqueItems":true}},"not":{"required":["supported_suppression_units"]}}]},"external:enums/media-buy-frequency-cap-control-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/media-buy-frequency-cap-control-mode.json","title":"Media Buy Frequency Cap Control Mode","description":"The aggregate MediaBuy frequency-cap control shape supported in 3.2.","type":"string","enum":["max_impressions"]},"external:media-buy/product-fields.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/media-buy/product-fields.json","title":"Product Response Fields","description":"Canonical product fields a buyer requests from list_products. Required product_id and name fields are always returned. list_applications also overrides projection whenever a property or collection list is in the effective targeting because it is the decision receipt for seller-specific list matching. targeting_resolution and expires_at override projection whenever the seller returns modifications, as does collection_targeting_allowed whenever returned overlay_support declares collection_list. Legacy named-format fields remain available only through get_products.","type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["product_id","name","description","publisher_properties","channels","video_placement_types","audio_distribution_types","sponsored_placement_types","social_placement_surfaces","format_options","placements","delivery_type","exclusivity","pricing_options","forecast","reporting_capabilities","measurement_terms","performance_standards","catalog_types","signal_targeting_allowed","signal_targeting_rules","demographic_targeting","overlay_support","collections","collection_targeting_allowed","media_buy_support","audience_evidence","audience_evidence_selections","max_optimization_goals","catalog_match","list_applications","brief_relevance","targeting_resolution","acceptance_policy_profile_ids","identity","execution_requirements","expires_at","allowed_actions"]}},"external:core/push-notification-config.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/push-notification-config.json","title":"Push Notification Config","description":"Webhook configuration for asynchronous task notifications. Uses A2A-compatible PushNotificationConfig structure. By default, webhooks are signed with the AdCP RFC 9421 profile (see docs/building/by-layer/L1/security.mdx#webhook-callbacks) — the seller signs outbound with a key published at the jwks_uri on its own brand.json `agents[]` entry and the buyer verifies against that JWKS, so no shared secret crosses the wire. The optional `authentication` block selects the legacy Bearer or HMAC-SHA256 fallback for compatibility with receivers that have not yet adopted the 9421 profile; this fallback is deprecated and will be removed in AdCP 4.0. Note: the `idempotency_key` that receivers dedup on lives inside the webhook **payload** body (see docs/building/by-layer/L3/webhooks.mdx#reliability and the mcp-webhook-payload schema), not in this configuration object — this schema only describes the receiver-side transport config sent to the seller. This schema is designed for composition via allOf - consuming schemas should define their own additionalProperties constraints.","type":"object","properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint URL for task status notifications. The wire contract is unconstrained beyond `format: \"uri\"` — in particular, publishers SHOULD NOT enforce a destination-port allowlist by default, since buyers legitimately host receivers on non-standard TLS ports (`:9443`, `:4443`, path-routed multi-tenant gateways). The SSRF guard the protocol relies on is the IP-range check + DNS-rebinding-resistant connect pin defined in [Webhook URL validation (SSRF)](/docs/building/by-layer/L1/security#webhook-url-validation-ssrf), not port filtering. Operators who want a hardened destination-port allowlist as defense-in-depth (e.g., locked-down enterprise egress) opt in explicitly — see [Destination port: permissive by default](/docs/building/by-layer/L1/security#destination-port-permissive-by-default)."},"operation_id":{"type":"string","description":"Buyer-supplied correlation identifier for the operation that will produce webhooks against this registration. The seller MUST echo this value verbatim into every webhook payload's `operation_id` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) and [Webhooks — Operation IDs](/docs/building/by-layer/L3/webhooks#operation-ids-and-url-templates)). Buyers SHOULD generate a unique value per task invocation (UUID recommended). This field is the canonical registration channel for `operation_id`; buyers MAY additionally embed routing values in the URL path or query as an aid for their own HTTP server, but the URL is opaque to the seller and the wire-level source of truth is this field. Sellers MUST NOT parse the URL to recover `operation_id`. For 3.x schema compatibility the member remains optional, but a seller MUST reject a task that registers an AdCP webhook without it using `INVALID_REQUEST`; otherwise the required webhook envelope cannot be emitted.","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{1,255}$"},"token":{"type":"string","description":"Optional client-provided token for webhook validation. The seller MUST echo this value verbatim in every webhook payload's `token` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) for the receiver-side validation obligation). Length bounds give receivers a defensive range check on the echoed value; senders SHOULD generate tokens with at least 128 bits of entropy (≥22 base64url characters). This is a complementary authenticity mechanism that can layer on top of the RFC 9421 webhook signature — unlike the `authentication` block below, it is not on the 4.0 removal track. Receivers that registered both a signing key (RFC 9421) and a `token` MUST NOT treat a valid token echo as authorization to skip signature verification; both checks remain independent obligations.","minLength":16,"maxLength":4096},"authentication":{"type":"object","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication configuration (A2A-compatible). Opts the seller into Bearer or HMAC-SHA256 signing instead of the default RFC 9421 webhook profile. Deprecated; removed in AdCP 4.0. **Precedence is a switch, not a fallback:** presence of this block selects the legacy scheme; absence selects 9421. A seller MUST NOT sign the same webhook both ways, and a buyer MUST NOT attempt 'try 9421 first, fall back to HMAC' verification — signature mode is determined solely by whether this block was present at registration time. The seller's baseline 9421 webhook key is published at its brand.json `agents[]` `jwks_uri` using `adcp_use: \"request-signing\"` (deprecated `webhook-signing` keys remain accepted during the compatibility window); it does not override this selector and is only used when `authentication` is omitted. See docs/building/by-layer/L1/security.mdx#webhook-callbacks for the full precedence and downgrade-resistance rules (including the `webhook_mode_mismatch` rejection a buyer MUST apply when a received webhook's signing mode does not match the registered mode).","properties":{"schemes":{"type":"array","description":"Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit `authentication` and use the RFC 9421 webhook profile.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1auth-scheme.json"},"minItems":1,"maxItems":1},"credentials":{"type":"string","description":"Credentials for the legacy scheme. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.","minLength":32}},"required":["schemes","credentials"],"additionalProperties":false}},"required":["url"]},"external:enums/auth-scheme.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/auth-scheme.json","title":"Authentication Scheme","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication schemes for the webhook auth block. Bearer: token sent in Authorization header. HMAC-SHA256: legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit the authentication block and use the RFC 9421 webhook signing profile (applicable on schemas where authentication is optional). Removed in AdCP 4.0.","type":"string","enum":["Bearer","HMAC-SHA256"]},"external:core/pagination-request.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/pagination-request.json","title":"Pagination Request","description":"Standard cursor-based pagination parameters for list operations","type":"object","properties":{"max_results":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Maximum number of items to return per page"},"cursor":{"type":"string","description":"Opaque cursor from a previous response to fetch the next page"}},"additionalProperties":false},"external:core/context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/context.json","title":"Context Object","description":"Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.","type":"object","additionalProperties":true}},"dependentRequired":{"catalog":["brand"],"if_pricing_version":["if_wholesale_feed_version"]}}
1
+ {"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json","title":"Get Products Request","description":"AdCP 3.x compatibility request for discovering and changing advertising products and proposals. Buyers SHOULD express every campaign constraint that has a structured field in that field rather than relying on prose: structured input is cheaper to transmit, deterministic to process, and avoids lossy inference. Exact targeting_overlay values scope returned products, pricing, and forecasts; required_overlay_support identifies targeting dimensions whose values will be supplied on packages later. Explicit hard targeting stated only in a brief remains binding. AdCP 3.2 introduces the narrower list_products, request_proposals, refine_proposals, and decline_proposals tasks; new callers SHOULD use those tasks while existing get_products payloads remain valid throughout 3.x.","type":"object","x-mutates-state":true,"x-idempotency-key-required":false,"x-operation-family":"get_products","x-deprecated-in":"3.2.0","x-superseded-by":["list_products","request_proposals","refine_proposals","decline_proposals"],"properties":{"adcp_version":{"type":"string","description":"Release-precision AdCP version (VERSION.RELEASE, e.g. \"3.0\", \"3.1\", \"3.1-beta\"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = \"3.1.0-beta.1\") MUST normalize to release-precision (\"3.1-beta.1\") before emitting on the wire — meta-field values are NOT valid wire values.","pattern":"^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?)?$","examples":["3.0","3.1","3.1-beta","3.1-rc.1"]},"adcp_major_version":{"type":"integer","deprecated":true,"x-removed-in":"4.0.0","description":"DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.","minimum":1,"maximum":99},"idempotency_key":{"type":"string","description":"Optional client-generated key on the AdCP 3.x compatibility facade. The field remains optional on every arm for wire compatibility. A seller MAY ignore a supplied key on a guaranteed side-effect-free synchronous read. Buyers SHOULD supply a key whenever the request may allocate a task, finalize a proposal, or otherwise change observable state. When a key is supplied on such a request and the seller declares adcp.idempotency.supported: true, the seller MUST apply the AdCP replay contract before that effect. If the key is omitted or the seller declares adcp.idempotency.supported: false, the buyer has no portable at-most-once retry guarantee after an ambiguous result. New callers SHOULD use the compact 3.2 tasks; each stateful split task has its own idempotency identity, so callers MUST retry with the same tool name. Keys MUST be unique per seller and logical request.","minLength":16,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{16,255}$"},"buying_mode":{"type":"string","enum":["brief","wholesale","refine"],"description":"Declares buyer intent for this request. 'brief': publisher curates product recommendations from the provided brief. 'wholesale': buyer requests raw product inventory to apply their own audiences — brief must not be provided, and proposals are omitted. 'refine': iterate on products and proposals from a previous get_products response using the refine array of change requests. v3 clients MUST include buying_mode. Sellers receiving requests from pre-v3 clients without buying_mode SHOULD default to 'brief'. Timing semantics: 'wholesale' is a wholesale product feed read — sellers SHOULD return a synchronous response and MUST NOT route a 'wholesale' request through the async/Submitted arm; partial completion is signalled via the response's incomplete[] field (with optional estimated_wait), not via a task-handoff envelope. 'brief' and 'refine' MAY complete synchronously, or MAY return a Submitted envelope (see get-products-async-response-submitted.json) when curation requires upstream-system queries or HITL review the seller cannot complete inside time_budget. Buyers needing predictable fast wholesale product feed access MUST use 'wholesale'; buyers open to slower curation use 'brief' or 'refine'."},"brief":{"type":"string","description":"Natural language description of campaign requirements. Required when buying_mode is 'brief'. Must not be provided when buying_mode is 'wholesale' or 'refine'. Buyers SHOULD use structured fields for every requirement that can be expressed structurally, and reserve brief prose for goals, context, preferences, and requirements without a structured representation. Sellers MUST apply explicit hard requirements stated in the brief even when the buyer did not duplicate them in a structured field. When a seller translates hard prose into structured targeting that materially affects product eligibility, pricing, or forecasting, it MUST confirm that interpretation once in GetProductsResponse.targeting_resolution.brief_targeting; otherwise confirmation remains a best practice. If hard prose contradicts a structured field, sellers MUST reject the request with INVALID_REQUEST rather than choose one interpretation or return an unexplained empty result."},"refine":{"type":"array","description":"Array of change requests for iterating on products and proposals from a previous get_products response. Each entry declares a scope (request, product, or proposal) and what the buyer is asking for. Only valid when buying_mode is 'refine'. The seller responds to each entry via refinement_applied in the response, matched by position.\n\nFinalize-exclusivity rule: if any entry has `action: 'finalize'`, ALL entries in the array MUST be proposal-scoped with `action: 'finalize'` — mixing finalize entries with `include`/`omit` entries or with request- / product-scoped entries MUST be rejected by the seller with `INVALID_REQUEST`. Finalize is a commit, not a refinement; the buyer expressing intent to commit means refinements have already converged. Buyers needing to refine AND commit in close succession sequence the calls: first a refine call (no finalize), then a finalize call against the resulting `proposal_id`(s).\n\nMulti-finalize semantics: multiple finalize entries against different `proposal_id` values in a single call are allowed and MUST be **atomic at the observation point** — sellers MUST NOT return a success response unless every named proposal has both completed and been persisted as committed. Pre-commit validation runs before any side-effects (inventory pull, terms lock, governance attestation); if any proposal fails validation, the seller MUST reject the entire call without committing any of the named proposals. There is no rollback operation in the spec — an `unfinalize` would itself be a new mutation surface; the atomicity guarantee runs entirely on the seller's pre-commit validation gate, not on post-commit reversal. Sellers that cannot guarantee atomic pre-commit validation MUST reject multi-finalize arrays with `MULTI_FINALIZE_UNSUPPORTED` (preferred — distinguishes seller-side capability gap from a malformed request) or `INVALID_REQUEST` (acceptable fallback for sellers on a pre-3.1 error catalog). If a mid-commit failure occurs *after* validation passed but before all proposals persist (e.g., a downstream ad server fails between commits one and two), the seller MUST return `INTERNAL_ERROR` with `refinement_applied[]` carrying per-position outcomes — the spec does NOT define a recovery path for this case, and buyers SHOULD treat the resulting state as undefined and re-read via `get_media_buys` / equivalent before retrying. Buyers MUST NOT assume multi-finalize support without a successful first attempt — there is no capability flag for this; the failure response is the discovery surface. Buyers whose intent specifically requires atomic commit (e.g., budget-shared proposals where one finalizing without the other is incoherent) MUST be prepared to abandon the intent if the seller returns `MULTI_FINALIZE_UNSUPPORTED` — there is no recovery for that loss of buyer intent beyond sequencing single-finalize calls and accepting the looser commit guarantee.","minItems":1,"items":{"type":"object","discriminator":{"propertyName":"scope"},"oneOf":[{"properties":{"scope":{"type":"string","const":"request","description":"Change scoped to the overall request — direction for the selection as a whole."},"ask":{"type":"string","minLength":1,"description":"What the buyer is asking for at the request level (e.g., 'more video options and less display', 'suggest how to combine these products')."}},"required":["scope","ask"],"additionalProperties":false},{"properties":{"scope":{"type":"string","const":"product","description":"Change scoped to a specific product."},"product_id":{"type":"string","minLength":1,"description":"Product ID from a previous get_products response."},"action":{"type":"string","enum":["include","omit","more_like_this"],"default":"include","description":"'include' (default): return this product with updated pricing and data. 'omit': exclude this product from the response. 'more_like_this': find additional products similar to this one (the original is also returned). Optional — when omitted, the seller treats the entry as action: 'include'."},"ask":{"type":"string","minLength":1,"description":"What the buyer is asking for on this product. For 'include': specific changes to request (e.g., 'add 16:9 format'). For 'more_like_this': what 'similar' means (e.g., 'same audience but video format'). Ignored when action is 'omit'."}},"required":["scope","product_id"],"additionalProperties":false},{"properties":{"scope":{"type":"string","const":"proposal","description":"Change scoped to a specific proposal."},"proposal_id":{"type":"string","minLength":1,"description":"Proposal ID from a previous get_products response."},"action":{"type":"string","enum":["include","omit","finalize"],"default":"include","description":"'include' (default): return this proposal with updated allocations and pricing. 'omit': exclude this proposal from the response. 'finalize': request firm pricing and inventory hold. New callers use refine_proposals with action revise for a draft successor or action finalize for a committed held successor; terminal feedback is available through decline_proposals.\n\nLegacy finalize is exclusive within the parent `refine[]` array: see the array-level description for the finalize-exclusivity rule (mixing finalize with non-finalize entries is rejected) and multi-finalize atomicity contract."},"ask":{"type":"string","minLength":1,"description":"What the buyer is asking for on this proposal (e.g., 'shift more budget toward video', 'reduce total by 10%'). Ignored when action is omit."}},"required":["scope","proposal_id"],"additionalProperties":false}]}},"brand":{"$ref":"#/$defs/external:core~1brand-ref.json","description":"Brand reference for product discovery context. Resolved to full brand identity at execution time."},"acceptance_context":{"$ref":"#/$defs/external:media-buy~1acceptance-context.json","x-adcp-schema-uri":"/schemas/media-buy/acceptance-context.json","description":"Structured campaign and advertiser facts for seller acceptance-policy preflight. Sellers may infer omitted facts from brand and brief, but uncertainty never implies acceptance."},"catalog":{"$ref":"#/$defs/external:core~1catalog.json","description":"Catalog of items the buyer wants to promote. The seller matches catalog items against its inventory and returns products where matches exist. Supports all catalog types: a job catalog finds job ad products, a product catalog finds sponsored product slots. Reference a synced catalog by catalog_id, or provide inline items."},"account":{"$ref":"#/$defs/external:core~1account-ref.json","description":"Account for product lookup. Returns products with pricing specific to this account's rate card. The account must already be provisioned: a reference that does not resolve returns ACCOUNT_NOT_FOUND rather than public products, unless the seller provisions lazily. Omit account (and send brand for discovery context) until sync_accounts succeeds. See /docs/accounts/overview#account-references-before-provisioning."},"preferred_delivery_types":{"type":"array","description":"Delivery types the buyer prefers, in priority order. Unlike filters.delivery_type which excludes non-matching products, this signals preference for curation — the publisher may still include other delivery types when they match the brief well.","items":{"$ref":"#/$defs/external:enums~1delivery-type.json"},"minItems":1,"uniqueItems":true},"filters":{"$ref":"#/$defs/external:core~1product-filters.json","description":"Offer filters. Valid in brief, wholesale, and refine modes. In every mode, sellers MUST exclude products that do not satisfy them: brief controls curation, wholesale controls feed behavior, and refine controls iteration, but none changes filter semantics. On refine, presence is the complete replacement filter state; when omitted, each referenced product's bound discovery constraints remain in force. Targeting-like legacy fields remain accepted during migration but are deprecated in favor of targeting_overlay and required_overlay_support."},"targeting_overlay":{"$ref":"#/$defs/external:core~1targeting.json","description":"Concrete delivery constraints the buyer expects to carry into create_media_buy. Buyers SHOULD use this field instead of putting equivalent exact targeting only in brief prose. Sellers evaluate these constraints during discovery and scope returned pricing and forecasts to the effective targeting. If a product cannot honor the request exactly, the seller may omit it or return a request-scoped configured product with Product targeting_resolution modifications. Absence of Product targeting_resolution means exact acceptance of this structured overlay; it does not confirm how targeting in the brief was interpreted. On refine, presence is complete replacement state for returned configurations; when omitted, each referenced product's bound targeting remains in force."},"media_buy_frequency_cap":{"$ref":"#/$defs/external:core~1media-buy-frequency-cap.json","description":"Concrete aggregate max-impression cap intended for the MediaBuy root. Every returned product must participate in one shared counter for this exact value. Legacy proposals echo it as proposals[].frequency_cap; direct buyers repeat it at purchase."},"required_overlay_support":{"$ref":"#/$defs/external:core~1targeting-overlay-requirements.json","description":"Minimum product-scoped targeting dimensions the buyer must be able to set independently on packages later. This requests selectable capability, not current targeting values, value-specific availability or forecasts, and not one product per possible value. A requirement true matches support true or any valid support object; an object requirement matches support true or an object containing every requested boolean and requested array subset. The backward-compatible daypart_targets support true is the exception: it satisfies inventory_local requirements only, not iana requirements. Unrequested object fields and numeric limits do not participate. Missing or unknown requirement fields do not match. Seller limit fields are response-only and cannot be requested here. On refine, presence is complete replacement state; when omitted, each referenced product's bound future-support requirements remain in force."},"required_media_buy_support":{"$ref":"#/$defs/external:core~1media-buy-support-requirements.json","description":"Minimum product participation in shared MediaBuy-level controls. For a frequency cap, every returned product must be composable in one seller-maintained aggregate counter for every requested per unit. On refine, presence is complete replacement state."},"property_list":{"$ref":"#/$defs/external:core~1property-list-ref.json","description":"DEPRECATED discovery-only property filter. On compact discovery tasks use criteria.offer_filters.property_list to preserve product eligibility. Use targeting_overlay.property_list only when the buyer intends a delivery constraint, or required_overlay_support.property_list for future selectability. A facade MUST NOT convert this discovery filter into delivery targeting.","deprecated":true},"fields":{"type":"array","description":"Specific product fields to include in the response. When omitted, all fields are returned. Use for lightweight discovery calls where only a subset of product data is needed. product_id and name are always included. `format_ids` is a deprecated 3.x compatibility projection; new integrations request canonical `format_options`. Safety-critical request-specific fields override projection: Product.targeting_resolution and expires_at MUST be included whenever the seller returns modifications, overlay_support MUST be included when required_overlay_support was requested, media_buy_support MUST be included when required_media_buy_support or media_buy_frequency_cap was requested, list_applications MUST be included when a property or collection list is in the effective targeting, and audience_evidence_selections MUST be included when filters.audience_evidence_requirements affects eligibility or ranking. fields controls the optional audience_evidence payload, not either decision receipt. Response-level brief targeting confirmation is not a projected product field.","minItems":1,"items":{"anyOf":[{"$ref":"#/$defs/external:media-buy~1product-fields.json/items"},{"type":"string","enum":["format_ids","outcome_measurement","delivery_measurement","creative_policy","metric_optimization","conversion_tracking","data_provider_signals","included_signals","signal_targeting_options","overlay_support","media_buy_support","installments","is_custom","product_card","product_card_detailed","enforced_policies","trusted_match"]}]}},"time_budget":{"allOf":[{"$ref":"#/$defs/external:core~1duration.json"}],"description":"Maximum time the buyer will commit to this request. The seller returns the best results achievable within this budget and does not start processes (human approvals, expensive external queries) that cannot complete in time. When omitted, the seller decides timing."},"push_notification_config":{"$ref":"#/$defs/external:core~1push-notification-config.json","description":"Optional webhook configuration for async terminal completion/failure notifications on curated discovery. Meaningful only for `buying_mode: \"brief\"` and `buying_mode: \"refine\"` requests that enter the async lifecycle. Submitted envelopes with `task_id` remain pollable through `get_task_status` (legacy `tasks/get`) whether or not this field is present. If a brief/refine request includes this field and the seller returns a Submitted envelope, the seller MUST deliver at least the terminal completion/failure notification to the configured URL; intermediate progress notifications are MAY. If the seller cannot honor the webhook channel, it MUST reject the request with a structured error instead of silently accepting. This field does not change wholesale timing semantics: sellers MUST NOT route `buying_mode: \"wholesale\"` requests through the async/Submitted arm or emit async delivery solely because `push_notification_config` is present; partial wholesale completion is reported via `incomplete[]`."},"pagination":{"$ref":"#/$defs/external:core~1pagination-request.json","description":"Cursor-based pagination controls for get_products. Valid in all buying modes. In brief mode, pagination bounds the seller's returned products[] for the curated answer to the brief and is not an exhaustive catalog-enumeration contract. In refine mode, pagination bounds the refined products[] result implied by refine[] and filters; proposals may accompany a page as plan metadata but are not independently counted by this pagination envelope. In wholesale mode, pagination walks the wholesale product feed and may be combined with wholesale feed versioning."},"if_wholesale_feed_version":{"type":"string","description":"Opaque wholesale_feed_version token returned by a prior wholesale-mode get_products response from this agent. Only valid when buying_mode is wholesale. When provided, the seller compares against its current wholesale product feed version for the buyer's cache_scope and MAY return an unchanged: true response (with products omitted) if nothing has changed. The token is scope-keyed: buyers cache `(cache_scope, wholesale_feed_version)` pairs. Scoping dimensions: (agent, buying_mode, filters, targeting_overlay, media_buy_frequency_cap, required_overlay_support, required_media_buy_support, deprecated property_list, catalog) for cache_scope: 'public'; that tuple plus account identity for cache_scope: 'account'. pagination.cursor is NOT part of the scoping tuple. Backward-compatible: pre-v3.1 agents that ignore this field simply return the full payload, same as the unchanged-server path. See specs/wholesale-feed-webhooks.md for the full sync pattern."},"if_pricing_version":{"type":"string","description":"Opaque pricing_version token from a prior get_products response. MUST only be sent together with if_wholesale_feed_version — pricing version has no structural baseline to compare against on its own. Evaluation order: (1) if_wholesale_feed_version mismatch → seller returns the full payload (pricing is implicitly stale); (2) if_wholesale_feed_version matches but if_pricing_version mismatches → seller returns the full payload so the buyer sees updated pricing_options; (3) both match → seller MAY return unchanged: true. Agents that don't track pricing separately ignore if_pricing_version and fall back to if_wholesale_feed_version semantics. Useful for storefronts that re-price compositions far more often than they re-render product mirrors."},"context":{"$ref":"#/$defs/external:core~1context.json"},"required_policies":{"type":"array","items":{"type":"string"},"description":"Registry policy IDs that the buyer requires to be enforced for products in this response. Sellers filter products to only those that comply with or already enforce the requested policies."},"ext":{"$ref":"#/$defs/external:core~1ext.json"}},"required":["buying_mode"],"additionalProperties":true,"$defs":{"external:core/version-envelope.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/version-envelope.json","title":"AdCP Version Envelope","description":"Release-precision AdCP protocol version negotiation fields. Composed via `allOf` into AdCP request schemas and shared response components so the version semantics live in one place. Strict (`additionalProperties: false`) request schemas also redeclare these two fields in their own `properties` via `$ref`, because draft-07 does not evaluate properties across `allOf`. The Trusted Match match requests are the exception: they inline both fields for their strict privacy boundary. Distinct from `core/protocol-envelope.json`, which wraps responses at the transport layer (context_id / task_id / status / payload). This envelope is part of the payload itself.","type":"object","properties":{"adcp_version":{"type":"string","description":"Release-precision AdCP version (VERSION.RELEASE, e.g. \"3.0\", \"3.1\", \"3.1-beta\"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = \"3.1.0-beta.1\") MUST normalize to release-precision (\"3.1-beta.1\") before emitting on the wire — meta-field values are NOT valid wire values.","pattern":"^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?)?$","examples":["3.0","3.1","3.1-beta","3.1-rc.1"]},"adcp_major_version":{"type":"integer","deprecated":true,"x-removed-in":"4.0.0","description":"DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.","minimum":1,"maximum":99}}},"external:core/brand-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/brand-ref.json","title":"Brand Reference","description":"Reference to a brand by domain and optional brand_id. The domain hosts /.well-known/brand.json or is registered in the brand registry. For single-brand domains, brand_id can be omitted. For house-of-brands domains, brand_id identifies the specific brand. For creative production, brand.json is the canonical source of master brand identity (logo, palette, fonts, voice, and visual guidelines), subject only to the supported per-call fields in brand_kit_override. Catalogs supply product or item payload; catalog item asset groups, including property- or franchise-level logos, are item identity and do not override these master brand fields.","type":"object","properties":{"domain":{"type":"string","description":"Domain where /.well-known/brand.json is hosted, or the brand's operating domain","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"brand_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-id.json","description":"Brand identifier within the house portfolio. Optional for single-brand domains."},"countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1,"uniqueItems":true,"description":"Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting."},"industries":{"type":"array","items":{"type":"string"},"description":"Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json."},"data_subject_contestation":{"type":"object","description":"Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand → house → missing.","properties":{"url":{"type":"string","format":"uri","pattern":"^https://"},"email":{"type":"string","format":"email"},"languages":{"type":"array","items":{"type":"string"}}},"anyOf":[{"required":["url"]},{"required":["email"]}],"additionalProperties":false},"brand_kit_override":{"type":"object","description":"Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call — e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` — the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently — when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently — a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.","properties":{"logo":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1assets~1image-asset.json","description":"Override logo asset."},"colors":{"type":"object","description":"Override brand colors (hex strings).","properties":{"primary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"secondary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"additionalProperties":true},"voice":{"type":"string","description":"Override brand-voice description for surface-composed text/audio output."},"tagline":{"type":"string","description":"Override tagline."}},"additionalProperties":true}},"required":["domain"],"additionalProperties":false,"examples":[{"domain":"nova-brands.com","brand_id":"spark"},{"domain":"nova-brands.com","brand_id":"glow"},{"domain":"acme-corp.com"},{"domain":"nova-athletics.example","countries":["NL"]}]},"external:core/brand-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/brand-id.json","title":"Brand ID","description":"Identifier for a brand within a house portfolio. Must be lowercase alphanumeric with underscores only. The house chooses this identifier.","type":"string","pattern":"^[a-z0-9_]+$","x-entity":"advertiser_brand","examples":["tide","cheerios","air_jordan","nike","pampers"]},"external:core/assets/image-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/image-asset.json","title":"Image Asset","description":"Image asset with URL and dimensions","type":"object","properties":{"asset_type":{"type":"string","const":"image","description":"Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL to the image asset"},"width":{"type":"integer","minimum":1,"description":"Width in pixels"},"height":{"type":"integer","minimum":1,"description":"Height in pixels"},"file_size_bytes":{"type":"integer","minimum":1,"description":"Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint."},"pixel_ratio":{"type":"number","exclusiveMinimum":0,"description":"Intrinsic pixels per logical render pixel (for example `2` for a 600×500 image intended to render at 300×250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields."},"state_id":{"type":"string","description":"Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots."},"breakpoint_id":{"type":"string","description":"Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots."},"focal_point":{"type":"array","items":{"type":"number","minimum":0,"maximum":1},"minItems":2,"maxItems":2,"description":"Normalized `[x, y]` coordinates (0–1 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults."},"format":{"type":"string","description":"Image file format (jpg, png, gif, webp, etc.)"},"alt_text":{"type":"string","description":"Alternative text for accessibility","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url","width","height"],"additionalProperties":true},"external:core/provenance.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/provenance.json","title":"Provenance","description":"Declares how content was produced, whether AI was involved, and what disclosure obligations apply. Attaches to creative manifests, individual assets, or content-standards artifacts. When present at multiple levels, the most specific provenance object replaces the inherited one entirely (no field-level merging). Provenance is a claim by the declaring party — receiving parties should verify claims independently via their own detection tools.","type":"object","properties":{"digital_source_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1digital-source-type.json","description":"IPTC-aligned classification of AI involvement in producing this content"},"synthetic_depiction":{"type":"boolean","description":"Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`."},"ai_tool":{"type":"object","description":"AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.","properties":{"name":{"type":"string","description":"Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"},"version":{"type":"string","description":"Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version."},"provider":{"type":"string","description":"Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')"}},"required":["name"]},"human_oversight":{"type":"string","description":"Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` — the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.","enum":["none","prompt_only","selected","edited","directed"],"enumDescriptions":{"none":"Fully automated with no human involvement in generation","prompt_only":"Human provided the prompt or instructions but did not review outputs","selected":"Human selected from multiple AI-generated candidates","edited":"Human edited or refined AI-generated output","directed":"Human directed the creative process with AI as an assistive tool"}},"declared_by":{"type":"object","description":"Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent or service that declared this provenance"},"role":{"type":"string","enum":["creator","advertiser","agency","platform","tool"],"description":"Role of the declaring party in the supply chain","enumDescriptions":{"creator":"The party that created or generated the content","advertiser":"The brand or advertiser that owns the content","agency":"Agency acting on behalf of the advertiser","platform":"Ad platform or publisher that processed the content","tool":"Automated tool or service that attached provenance metadata"}}},"required":["role"]},"declared_at":{"type":"string","format":"date-time","description":"When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance."},"created_time":{"type":"string","format":"date-time","description":"When this content was created or generated (ISO 8601)"},"c2pa":{"type":"object","description":"C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.","properties":{"manifest_url":{"type":"string","format":"uri","description":"URL to the C2PA manifest store for this content"}},"required":["manifest_url"]},"embedded_provenance":{"type":"array","description":"Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).","minItems":1,"items":{"type":"object","properties":{"method":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1embedded-provenance-method.json","description":"How provenance data is carried within the content"},"standard":{"type":"string","description":"Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)"},"provider":{"type":"string","description":"Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context — not a wire identifier."},"verify_agent":{"type":"object","description":"Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing — the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."},"feature_id":{"type":"string","description":"Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog."}},"required":["agent_url"],"additionalProperties":false},"embedded_at":{"type":"string","format":"date-time","description":"When the provenance data was embedded (ISO 8601)"}},"required":["method","provider"]}},"watermarks":{"type":"array","description":"Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).","minItems":1,"items":{"type":"object","properties":{"media_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1watermark-media-type.json","description":"Media category of the watermarked content"},"provider":{"type":"string","description":"Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context — not a wire identifier."},"verify_agent":{"type":"object","description":"Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing — the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."},"feature_id":{"type":"string","description":"Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog."}},"required":["agent_url"],"additionalProperties":false},"c2pa_action":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1c2pa-watermark-action.json","description":"C2PA action classification for this watermark"},"embedded_at":{"type":"string","format":"date-time","description":"When the watermark was applied (ISO 8601)"}},"required":["media_type","provider"]}},"disclosure":{"type":"object","description":"Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.","properties":{"required":{"type":"boolean","description":"The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain — useful as a routing and audit input — not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."},"jurisdictions":{"type":"array","description":"Jurisdictions where disclosure obligations apply","items":{"type":"object","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"},"region":{"type":"string","description":"Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)"},"regulation":{"type":"string","description":"Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"},"label_text":{"type":"string","description":"Required disclosure label text for this jurisdiction, in the local language"},"render_guidance":{"type":"object","description":"How the disclosure should be rendered for this jurisdiction. Expresses the declaring party's intent for persistence and position based on regulatory requirements. Publishers control actual rendering but governance agents can audit whether guidance was followed.","minProperties":1,"properties":{"persistence":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1disclosure-persistence.json","description":"How long the disclosure must persist during content playback or display"},"min_duration_ms":{"type":"integer","minimum":1,"description":"Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial — without it, the duration is at the publisher's discretion. At serve time the publisher reads this from provenance since the brief is not available."},"positions":{"type":"array","description":"Preferred disclosure positions in priority order. The first position a format supports should be used.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1disclosure-position.json"},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}}}},"required":["country","regulation"]},"minItems":1}},"required":["required"]},"verification":{"type":"array","description":"Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.","minItems":1,"items":{"type":"object","properties":{"verified_by":{"type":"string","description":"Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"},"verified_time":{"type":"string","format":"date-time","description":"When the verification was performed (ISO 8601)"},"result":{"type":"string","enum":["authentic","ai_generated","ai_modified","inconclusive"],"description":"Verification outcome"},"confidence":{"type":"number","minimum":0,"maximum":1,"description":"Confidence score of the verification result (0.0 to 1.0)"},"details_url":{"type":"string","format":"uri","description":"URL to the full verification report"}},"required":["verified_by","result"]}},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}}},"external:enums/digital-source-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/digital-source-type.json","title":"Digital Source Type","description":"Classification of AI involvement in content creation, aligned with IPTC digitalsourcetype vocabulary. Used in provenance metadata to declare how a creative asset, artifact, or individual asset was produced.","type":"string","enum":["digital_capture","digital_creation","trained_algorithmic_media","composite_with_trained_algorithmic_media","algorithmic_media","composite_capture","composite_synthetic","human_edits","data_driven_media"],"enumDescriptions":{"digital_capture":"Captured by a digital device (camera, scanner, screen recording) with no AI involvement","digital_creation":"Created by a human using digital tools (Photoshop, Illustrator, After Effects) without AI generation","trained_algorithmic_media":"Generated entirely by a trained AI model (DALL-E, Midjourney, Stable Diffusion, Sora)","composite_with_trained_algorithmic_media":"Human-created content combined with AI-generated elements (e.g., photo with AI background)","algorithmic_media":"Produced by deterministic algorithms without machine learning (procedural generation, rule-based systems)","composite_capture":"Multiple digital captures composited together without AI","composite_synthetic":"Composite of multiple elements where at least one is AI-generated (e.g., stock photo composited with AI-generated background)","human_edits":"Content augmented, corrected, or enhanced by humans using non-generative tools","data_driven_media":"Assembled from structured data feeds (DCO templates, product catalogs, weather-triggered variants)"}},"external:enums/embedded-provenance-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/embedded-provenance-method.json","title":"Embedded Provenance Method","description":"How provenance data is carried within the content stream. Distinguishes between format-level manifest embedding (where the manifest travels inside the file container) and provenance markers (where invisible markers in the content itself encode or reference a provenance record). Both survive operations that strip sidecar metadata, but provenance markers additionally survive content-level transformations such as copy-paste, reformatting, and CMS re-encoding.","type":"string","enum":["manifest_wrapper","provenance_markers"],"enumDescriptions":{"manifest_wrapper":"A provenance manifest embedded in the file container per format-specific rules (e.g., JUMBF box in JPEG, C2PATextManifestWrapper in plaintext per C2PA Section A.7). The manifest travels with the file but is tied to the file's byte structure.","provenance_markers":"Invisible markers embedded within the content stream that encode or reference a provenance record. Designed to survive reformatting, copy-paste, CMS ingestion, and ad-server transcoding that breaks file-level bindings."}},"external:enums/watermark-media-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/watermark-media-type.json","title":"Watermark Media Type","description":"Media category of a content watermark. Identifies what kind of content the watermark is applied to, which determines the detection and verification methods required.","type":"string","enum":["audio","image","video","text"],"enumDescriptions":{"audio":"Watermark applied to audio content (e.g., spread-spectrum, echo hiding)","image":"Watermark applied to image content (e.g., spatial domain, frequency domain)","video":"Watermark applied to video content (e.g., per-frame image watermarking, temporal watermarking)","text":"Watermark applied to text content (e.g., synonym substitution, structural modification)"}},"external:enums/c2pa-watermark-action.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/c2pa-watermark-action.json","title":"C2PA Watermark Action","description":"C2PA action classification for a content watermark. Distinguishes watermarks that are cryptographically linked to a C2PA manifest (bound) from watermarks that exist independently (unbound). Aligns with the c2pa.watermarked.* action family in the C2PA action taxonomy.","type":"string","enum":["c2pa.watermarked.bound","c2pa.watermarked.unbound"],"enumDescriptions":{"c2pa.watermarked.bound":"Watermark linked to a C2PA manifest for this asset. The watermark and manifest are mutually reinforcing: the manifest references the watermark, and the watermark can be used to locate the manifest.","c2pa.watermarked.unbound":"Watermark independent of any C2PA manifest. Applied before any provenance signing event (e.g., by the AI generator at creation time) or in pipelines where no manifest is present."}},"external:enums/disclosure-persistence.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/disclosure-persistence.json","title":"Disclosure Persistence","description":"How long a disclosure must persist during content playback or display. Different jurisdictions and regulations require different persistence behaviors for AI-generated content labels. When multiple sources specify persistence for the same jurisdiction (e.g., brief and provenance), the most restrictive mode applies: continuous > initial > flexible.","type":"string","enum":["continuous","initial","flexible"],"enumDescriptions":{"continuous":"Disclosure must remain visible or audible throughout the entire content display duration. For video and audio, this means the full playback duration. For static formats (display, DOOH), this means the full display slot. For DOOH specifically, 'content duration' means the ad's display slot within the rotation, not the screen's full rotation cycle.","initial":"Disclosure must appear at the start of content for a minimum duration before it may be removed. Pair with min_duration_ms in render_guidance or creative brief to specify the required duration.","flexible":"Disclosure presence is sufficient; placement timing and duration are at the publisher's discretion"}},"external:enums/disclosure-position.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/disclosure-position.json","title":"Disclosure Position","description":"Where a required disclosure should appear within a creative. Used by creative briefs to specify disclosure placement and by formats to declare which positions they can render.","type":"string","enum":["prominent","footer","audio","subtitle","overlay","end_card","pre_roll","companion"]},"external:core/ext.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/ext.json","title":"Extension Object","description":"Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.","type":"object","additionalProperties":true},"external:media-buy/acceptance-context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/media-buy/acceptance-context.json","title":"Acceptance Context","description":"Buyer-declared facts used for coarse seller acceptance matching during product and proposal discovery. Sellers may infer omitted facts, but uncertainty never implies acceptance.","type":"object","properties":{"subjects":{"type":"array","items":{"type":"object","properties":{"subject_category":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","x-entity":"governance_policy_category"},"subject_facets":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","x-entity":"governance_policy_category_facet"},"minItems":1,"uniqueItems":true}},"required":["subject_category"],"additionalProperties":false},"minItems":1},"advertiser_roles":{"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"minItems":1,"uniqueItems":true},"advertiser_industry":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1advertiser-industry.json"},"advertiser_jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1,"uniqueItems":true,"description":"Jurisdictions in which the advertiser is established or legally organized. This is distinct from where an ad will be delivered."},"delivery_jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1,"uniqueItems":true,"description":"Jurisdictions in which the proposed advertising will be delivered. Seller acceptance rules' jurisdictions and jurisdiction_groups match this field."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"x-adcp-validation":{"unique_by":[{"path":"subjects","field":"subject_category"}]},"minProperties":1,"additionalProperties":false},"external:enums/advertiser-industry.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/advertiser-industry.json","title":"Advertiser Industry","description":"Standardized advertiser industry classification. Top-level categories classify the advertiser's primary business. Dot-notation subcategories (e.g., 'media_entertainment.podcasts') provide platform-specific precision where needed. Sellers map these to platform-native codes (Spotify ADV categories, LinkedIn industry IDs, IAB Content Taxonomy, etc.). Sellers MUST accept unknown values gracefully — treat unrecognized values as the parent category (strip the subcategory) or as uncategorized. This ensures forward compatibility as the taxonomy evolves.","type":"string","x-extensible":true,"x-pattern":"^[a-z][a-z0-9_]+(\\.[a-z][a-z0-9_]+)?$","enum":["automotive","automotive.electric_vehicles","automotive.parts_accessories","automotive.luxury","beauty_cosmetics","beauty_cosmetics.skincare","beauty_cosmetics.fragrance","beauty_cosmetics.haircare","cannabis","cpg","cpg.personal_care","cpg.household","dating","education","education.higher_education","education.online_learning","education.k12","energy_utilities","energy_utilities.renewable","fashion_apparel","fashion_apparel.luxury","fashion_apparel.sportswear","finance","finance.banking","finance.insurance","finance.investment","finance.cryptocurrency","food_beverage","food_beverage.alcohol","food_beverage.restaurants","food_beverage.packaged_goods","gambling_betting","gambling_betting.sports_betting","gambling_betting.casino","gaming","gaming.mobile","gaming.console_pc","gaming.esports","government_nonprofit","government_nonprofit.political","government_nonprofit.charity","healthcare","healthcare.pharmaceutical","healthcare.medical_devices","healthcare.wellness","home_garden","home_garden.furniture","home_garden.home_improvement","media_entertainment","media_entertainment.podcasts","media_entertainment.music","media_entertainment.film_tv","media_entertainment.publishing","media_entertainment.live_events","pets","professional_services","professional_services.legal","professional_services.consulting","real_estate","real_estate.residential","real_estate.commercial","recruitment_hr","retail","retail.ecommerce","retail.department_stores","sports_fitness","sports_fitness.equipment","sports_fitness.teams_leagues","technology","technology.software","technology.hardware","technology.ai_ml","telecom","telecom.mobile_carriers","telecom.internet_providers","transportation_logistics","travel_hospitality","travel_hospitality.airlines","travel_hospitality.hotels","travel_hospitality.cruise","travel_hospitality.tourism"],"enumDescriptions":{"automotive":"Automotive manufacturers, dealerships, and auto industry","automotive.electric_vehicles":"Electric vehicle manufacturers and charging infrastructure","automotive.parts_accessories":"Auto parts, accessories, and aftermarket products","automotive.luxury":"Luxury and premium automotive brands","beauty_cosmetics":"Beauty, cosmetics, and prestige skincare brands. Distinct from cpg.personal_care — use beauty_cosmetics for brands whose identity is rooted in beauty (L'Oreal Paris, Estee Lauder, Sephora) and cpg.personal_care for mass-market personal hygiene (Dove, Colgate)","beauty_cosmetics.skincare":"Skincare brands and dermatological products","beauty_cosmetics.fragrance":"Perfume and fragrance brands","beauty_cosmetics.haircare":"Professional and prestige haircare brands","cannabis":"Cannabis products and dispensaries. Subject to heavy platform restrictions — most platforms require explicit category declaration for ad acceptance","cpg":"Consumer packaged goods — mass-market products sold through retail. For food and beverage manufacturers, use food_beverage. For prestige beauty, use beauty_cosmetics","cpg.personal_care":"Mass-market personal care and hygiene products (deodorant, toothpaste, soap). For prestige beauty brands, use beauty_cosmetics","cpg.household":"Household cleaning and maintenance products","dating":"Dating apps and matchmaking services. Subject to platform restrictions similar to gambling_betting","education":"Educational institutions and learning services","education.higher_education":"Universities, colleges, and graduate programs","education.online_learning":"Online courses, MOOCs, and digital education platforms","education.k12":"Primary and secondary education","energy_utilities":"Energy companies and utilities","energy_utilities.renewable":"Renewable energy, solar, wind, and clean technology","fashion_apparel":"Clothing, footwear, and fashion accessories","fashion_apparel.luxury":"Luxury fashion and designer brands","fashion_apparel.sportswear":"Athletic and sportswear brands","finance":"Financial services, banking, and insurance","finance.banking":"Retail and commercial banking","finance.insurance":"Insurance products and services","finance.investment":"Investment, wealth management, and brokerage","finance.cryptocurrency":"Cryptocurrency exchanges and blockchain financial products","food_beverage":"Food and beverage companies — manufacturers (Coca-Cola, Nestle), restaurants, and alcohol brands. For non-food packaged goods, use cpg","food_beverage.alcohol":"Alcoholic beverages (beer, wine, spirits). Subject to platform age-gating and regional restrictions","food_beverage.restaurants":"Restaurants, fast food, and food delivery","food_beverage.packaged_goods":"Packaged food and non-alcoholic beverages","gambling_betting":"Gambling, sports betting, and wagering. Subject to heavy platform restrictions — most platforms require explicit category declaration","gambling_betting.sports_betting":"Sports betting and daily fantasy sports","gambling_betting.casino":"Online casinos and traditional gambling","gaming":"Video games and interactive entertainment","gaming.mobile":"Mobile gaming","gaming.console_pc":"Console and PC gaming","gaming.esports":"Esports teams, tournaments, and streaming","government_nonprofit":"Government agencies and nonprofit organizations","government_nonprofit.political":"Political advertising and advocacy. Subject to platform transparency and disclosure requirements","government_nonprofit.charity":"Charitable organizations and fundraising","healthcare":"Healthcare, pharmaceuticals, and medical","healthcare.pharmaceutical":"Pharmaceutical and biotech companies. Subject to platform restrictions on drug advertising","healthcare.medical_devices":"Medical devices and health technology","healthcare.wellness":"Wellness, supplements, and alternative health","home_garden":"Home furnishing, improvement, and garden","home_garden.furniture":"Furniture and home decor","home_garden.home_improvement":"Home improvement, tools, and renovation","media_entertainment":"Media, entertainment, and content","media_entertainment.podcasts":"Podcast networks and podcast-first brands","media_entertainment.music":"Music labels, streaming, and artists","media_entertainment.film_tv":"Film studios, TV networks, and streaming services","media_entertainment.publishing":"Book publishers, magazines, and digital publications","media_entertainment.live_events":"Concerts, festivals, and live entertainment","pets":"Pet food, supplies, and veterinary services","professional_services":"Professional and business services","professional_services.legal":"Law firms and legal services","professional_services.consulting":"Management and business consulting","real_estate":"Real estate, property, and construction","real_estate.residential":"Residential real estate and housing","real_estate.commercial":"Commercial real estate and property management","recruitment_hr":"Job boards, staffing agencies, and HR technology","retail":"Retail stores and e-commerce","retail.ecommerce":"Online-first retailers and marketplaces","retail.department_stores":"Department stores and multi-brand retailers","sports_fitness":"Sports, fitness, and athletics","sports_fitness.equipment":"Sports and fitness equipment","sports_fitness.teams_leagues":"Professional sports teams and leagues","technology":"Technology companies and digital services","technology.software":"Software products, platforms, and SaaS","technology.hardware":"Consumer electronics and hardware","technology.ai_ml":"Artificial intelligence and machine learning companies","telecom":"Telecommunications and connectivity","telecom.mobile_carriers":"Mobile network operators","telecom.internet_providers":"Internet service providers and broadband","transportation_logistics":"Shipping, logistics, and freight services","travel_hospitality":"Travel, hospitality, and tourism","travel_hospitality.airlines":"Airlines and air travel","travel_hospitality.hotels":"Hotels, resorts, and accommodation","travel_hospitality.cruise":"Cruise lines and ocean travel","travel_hospitality.tourism":"Tourism boards and travel agencies"}},"external:core/catalog.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/catalog.json","title":"Catalog","description":"A typed data feed. Catalogs carry the items, locations, stock levels, or pricing that publishers use to render ads. They can be synced to a platform via sync_catalogs (managed lifecycle with approval), provided inline, or fetched from an external URL. The catalog type determines the item schema and can be structural (offering, product, inventory, store, promotion) or vertical-specific (hotel, flight, job, vehicle, real_estate, education, destination, app). Selectors (ids, tags, category, query) filter items regardless of sourcing method.","type":"object","properties":{"catalog_id":{"type":"string","description":"Buyer's identifier for this catalog. Required when syncing via sync_catalogs. When used in creatives, references a previously synced catalog on the account.","x-entity":"catalog"},"name":{"type":"string","description":"Human-readable name for this catalog (e.g., 'Summer Products 2025', 'Amsterdam Store Locations')."},"type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1catalog-type.json","description":"Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema."},"url":{"type":"string","format":"uri","description":"URL to an external catalog feed. The platform fetches and resolves items from this URL. For offering-type catalogs, the feed contains an array of Offering objects. For other types, the feed format is determined by feed_format. When omitted with type 'product', the platform uses its synced copy of the brand's product catalog."},"feed_format":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1feed-format.json","description":"Format of the external feed at url. Required when url points to a non-AdCP feed (e.g., Google Merchant Center XML, Meta Product Catalog). Omit for offering-type catalogs where the feed is native AdCP JSON."},"update_frequency":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1update-frequency.json","description":"How often the platform should re-fetch the feed from url. Only applicable when url is provided. Platforms may use this as a hint for polling schedules."},"items":{"type":"array","description":"Inline catalog data. The item schema depends on the catalog type: Offering objects for 'offering', StoreItem for 'store', HotelItem for 'hotel', FlightItem for 'flight', JobItem for 'job', VehicleItem for 'vehicle', RealEstateItem for 'real_estate', EducationItem for 'education', DestinationItem for 'destination', AppItem for 'app', or freeform objects for 'product', 'inventory', and 'promotion'. Mutually exclusive with url — provide one or the other, not both. Implementations should validate items against the type-specific schema.","items":{"type":"object"},"minItems":1},"ids":{"type":"array","description":"Filter catalog to exact canonical item keys. The key field is offering_id for offering, store_id for store, hotel_id for hotel, flight_id for flight, job_id for job, vehicle_id for vehicle, listing_id for real_estate, program_id for education, destination_id for destination, and app_id for app. Product, inventory, and promotion catalogs use the stable normalized source identifier retained during ingestion (for example a retailer SKU). The same canonical key is used by catalog availability item_id.","items":{"type":"string"},"minItems":1},"gtins":{"type":"array","description":"Filter product-type catalogs by GTIN identifiers for cross-retailer catalog matching. Accepts standard GTIN formats (GTIN-8, UPC-A/GTIN-12, EAN-13/GTIN-13, GTIN-14). Only applicable when type is 'product'.","items":{"type":"string","pattern":"^[0-9]{8,14}$"},"minItems":1},"tags":{"type":"array","description":"Filter catalog to items with these tags. Tags are matched using OR logic — items matching any tag are included.","items":{"type":"string"},"minItems":1},"category":{"type":"string","description":"Filter catalog to items in this category (e.g., 'beverages/soft-drinks', 'chef-positions')."},"query":{"type":"string","description":"Natural language filter for catalog items (e.g., 'all pasta sauces under $5', 'amsterdam vacancies')."},"conversion_events":{"type":"array","description":"Event types that represent conversions for items in this catalog. Declares what events the platform should attribute to catalog items — e.g., a job catalog converts via submit_application, a product catalog via purchase. The event's content_ids field carries the item IDs that connect back to catalog items. Use content_id_type to declare what identifier type content_ids values represent.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1event-type.json"},"minItems":1,"uniqueItems":true},"content_id_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1content-id-type.json","description":"Identifier type that the event's content_ids field should be matched against for items in this catalog. For example, 'gtin' means content_ids values are Global Trade Item Numbers, 'sku' means retailer SKUs. Omit when using a custom identifier scheme not listed in the enum."},"feed_field_mappings":{"type":"array","description":"Declarative normalization rules for external feeds. Maps non-standard feed field names, date formats, price encodings, and image URLs to the AdCP catalog item schema. Applied during sync_catalogs ingestion. Supports field renames, named transforms (date, divide, boolean, split), static literal injection, and assignment of image URLs to typed asset pools.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1catalog-field-mapping.json"},"minItems":1}},"required":["type"],"additionalProperties":true,"examples":[{"description":"Synced product catalog from Google Merchant Center","data":{"catalog_id":"gmc-primary","name":"Primary Product Feed","type":"product","url":"https://feeds.acmecorp.com/products.xml","feed_format":"google_merchant_center","update_frequency":"daily"}},{"description":"Inventory feed for store-level stock data","data":{"catalog_id":"store-inventory","name":"Store Inventory","type":"inventory","url":"https://feeds.acmecorp.com/inventory.json","feed_format":"custom","update_frequency":"hourly"}},{"description":"Store locator feed","data":{"catalog_id":"retail-locations","name":"Retail Locations","type":"store","url":"https://feeds.acmecorp.com/stores.json","feed_format":"custom","update_frequency":"weekly"}},{"description":"Promotional pricing feed","data":{"catalog_id":"summer-sale","name":"Summer Sale Promotions","type":"promotion","url":"https://feeds.acmecorp.com/promotions.json","feed_format":"google_merchant_center","update_frequency":"daily"}},{"description":"Inline offering catalog (no sync needed)","data":{"type":"offering","items":[{"offering_id":"summer-sale","name":"Summer Sale","landing_url":"https://acme.com/summer"}]}},{"description":"Reference to a previously synced catalog by ID","data":{"catalog_id":"gmc-primary","type":"product","ids":["SKU-12345","SKU-67890"]}},{"description":"Product catalog with GTIN cross-retailer matching and attribution","data":{"type":"product","gtins":["00013000006040","00013000006057"],"content_id_type":"gtin","conversion_events":["purchase","add_to_cart"]}},{"description":"Inline store catalog with catchment areas","data":{"catalog_id":"retail-locations","name":"Retail Locations","type":"store","items":[{"store_id":"amsterdam-flagship","name":"Amsterdam Flagship","location":{"lat":52.3676,"lng":4.9041},"catchments":[{"catchment_id":"walk","travel_time":{"value":10,"unit":"min"},"transport_mode":"walking"},{"catchment_id":"drive","travel_time":{"value":15,"unit":"min"},"transport_mode":"driving"}]}]}}]},"external:enums/catalog-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/catalog-type.json","title":"Catalog Type","description":"The type of catalog feed. Determines the item schema and how the platform resolves catalog items. Multiple catalog types can be synced to the same account and referenced together in creatives.","type":"string","enum":["offering","product","inventory","store","promotion","hotel","flight","job","vehicle","real_estate","education","destination","app"]},"external:enums/feed-format.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/feed-format.json","title":"Feed Format","description":"Catalog feed formats. Determines how the platform (seller) parses items from an external feed URL. Each named value is an externally-documented feed specification a seller parses natively without buyer-supplied feed_field_mappings; values are vendor spec names (proper nouns), not semantic categories. Use `custom` + feed_field_mappings for any feed whose shape is not one of the named formats.","type":"string","enum":["google_merchant_center","facebook_catalog","shopify","linkedin_jobs","tiktok_shop","pinterest_catalog","openai_product_feed","custom"],"enumDescriptions":{"google_merchant_center":"Google Merchant Center / Google Shopping product data specification — the de-facto e-commerce product-feed lingua franca that the other named commerce formats derive from.","facebook_catalog":"Meta (Facebook / Instagram) product catalog feed — a Google-Merchant-Center-derived dialect, the closest clone of the GMC field set.","shopify":"Shopify product feed export.","linkedin_jobs":"LinkedIn job-posting feed (XML).","tiktok_shop":"TikTok Shop product catalog feed — a GMC-derived dialect with material deltas (sku_id as the primary identifier rather than id, and a first-class video_link) that a GMC parser keyed on id would mis-parse.","pinterest_catalog":"Pinterest product catalog feed — a GMC-derived dialect with stricter serialization (composite-encoded price and shipping, a mandatory google_product_category, space-delimited availability enums) that a strict GMC parser would mis-handle.","openai_product_feed":"OpenAI Commerce product feed for ChatGPT shopping — a GMC-derived dialect adding ChatGPT-specific eligibility flags (is_eligible_search / is_eligible_checkout / is_eligible_ads). Spec: https://developers.openai.com/commerce/specs/file-upload/products","custom":"A feed whose shape is not one of the named formats above. The buyer MUST supply feed_field_mappings to normalize it to the AdCP catalog item schema."}},"external:enums/update-frequency.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/update-frequency.json","title":"Update Frequency","description":"Frequency of product catalog updates","type":"string","enum":["realtime","hourly","daily","weekly"]},"external:enums/event-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/event-type.json","title":"Event Type","description":"Standard marketing event types for event logging, aligned with IAB ECAPI","type":"string","enum":["page_view","view_content","select_content","select_item","search","share","add_to_cart","remove_from_cart","viewed_cart","add_to_wishlist","initiate_checkout","add_payment_info","purchase","refund","lead","qualify_lead","close_convert_lead","disqualify_lead","complete_registration","subscribe","follow","content_view","watch_milestone","start_trial","app_install","app_launch","contact","schedule","donate","submit_application","custom"],"enumDescriptions":{"page_view":"User viewed a page","view_content":"User viewed specific content (product, article, etc.)","select_content":"User selected or clicked on content (article, video, etc.)","select_item":"User selected a specific product or item from a list","search":"User performed a search","share":"User shared content via social or messaging","add_to_cart":"User added an item to cart","remove_from_cart":"User removed an item from cart","viewed_cart":"User viewed their shopping cart","add_to_wishlist":"User added an item to a wishlist","initiate_checkout":"User started checkout process","add_payment_info":"User added payment information","purchase":"User completed a purchase","refund":"A purchase was fully or partially refunded (adjusts ROAS)","lead":"User expressed interest (form submission, signup, etc.)","qualify_lead":"Lead qualified by sales or scoring criteria","close_convert_lead":"Lead converted to a customer or closed deal","disqualify_lead":"Lead disqualified or marked as not viable","complete_registration":"User completed account registration","subscribe":"User started a paid subscription or paid membership","follow":"User made a free, durable opt-in to an account, channel, feed, list, podcast, or similar owned property","content_view":"User meaningfully consumed a content unit, such as a watch, listen, stream, episode play, or read","watch_milestone":"User reached a content progress threshold, such as 25%, 50%, 75%, 100%, or a seconds-viewed milestone","start_trial":"User started a free trial","app_install":"User installed an application","app_launch":"User launched an application","contact":"User initiated contact (call, message, etc.)","schedule":"User scheduled an appointment or event","donate":"User made a donation","submit_application":"User submitted an application (loan, job, etc.)","custom":"Custom event type (specify in custom_event_name)"}},"external:enums/content-id-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/content-id-type.json","title":"Content ID Type","description":"Identifier type used in content_ids on conversion events to match back to catalog items. Omit when the identifier type is custom or not listed here.","type":"string","enum":["sku","gtin","offering_id","job_id","hotel_id","flight_id","vehicle_id","listing_id","store_id","program_id","destination_id","app_id"]},"external:core/catalog-field-mapping.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/catalog-field-mapping.json","title":"Catalog Field Mapping","description":"Declares how a field in an external feed maps to the AdCP catalog item schema. Used in sync_catalogs feed_field_mappings to normalize non-AdCP feeds (Google Merchant Center, LinkedIn Jobs XML, hotel XML, etc.) to the standard catalog item schema without requiring the buyer to preprocess every feed. Multiple mappings can assemble a nested object via dot notation (e.g., separate mappings for price.amount and price.currency).","type":"object","properties":{"feed_field":{"type":"string","description":"Field name in the external feed record. Omit when injecting a static literal value (use the value property instead)."},"catalog_field":{"type":"string","description":"Target field on the catalog item schema, using dot notation for nested fields (e.g., 'name', 'price.amount', 'location.city'). Mutually exclusive with asset_group_id."},"asset_group_id":{"type":"string","description":"Places the feed field value (a URL) into a typed asset pool on the catalog item's assets array. The value is wrapped as an image or video asset in a group with this ID. Use standard group IDs: 'images_landscape', 'images_vertical', 'images_square', 'logo', 'video'. Mutually exclusive with catalog_field."},"value":{"description":"Static literal value to inject into catalog_field for every item, regardless of what the feed contains. Mutually exclusive with feed_field. Useful for fields the feed omits (e.g., currency when price is always USD, or a constant category value)."},"transform":{"type":"string","description":"Named transform to apply to the feed field value before writing to the catalog schema. See transform-specific parameters (format, timezone, by, separator).","enum":["date","divide","boolean","split"]},"format":{"type":"string","description":"For transform 'date': the input date format string (e.g., 'YYYYMMDD', 'MM/DD/YYYY', 'DD-MM-YYYY'). Output is always ISO 8601 (e.g., '2025-03-01'). Uses Unicode date pattern tokens."},"timezone":{"type":"string","description":"For transform 'date': the timezone of the input value. IANA timezone identifier (e.g., 'UTC', 'America/New_York', 'Europe/Amsterdam'). Defaults to UTC when omitted."},"by":{"type":"number","description":"For transform 'divide': the divisor to apply (e.g., 100 to convert integer cents to decimal dollars).","exclusiveMinimum":0},"separator":{"type":"string","description":"For transform 'split': the separator character or string to split on. Defaults to ','.","default":","},"default":{"description":"Fallback value to use when feed_field is absent, null, or empty. Applied after any transform would have been applied. Allows optional feed fields to have a guaranteed baseline value."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"allOf":[{"not":{"required":["feed_field","value"]}},{"not":{"required":["catalog_field","asset_group_id"]}}],"additionalProperties":true,"examples":[{"description":"Simple field rename","data":{"feed_field":"hotel_name","catalog_field":"name"}},{"description":"Date format transform — YYYYMMDD to ISO 8601","data":{"feed_field":"available_from","catalog_field":"valid_from","transform":"date","format":"YYYYMMDD","timezone":"UTC"}},{"description":"Divide cents to dollars","data":{"feed_field":"price_cents","catalog_field":"price.amount","transform":"divide","by":100}},{"description":"Static literal injection — currency not in feed","data":{"catalog_field":"price.currency","value":"USD"}},{"description":"Image URL assigned to typed asset pool","data":{"feed_field":"primary_photo_url","asset_group_id":"images_landscape"}},{"description":"Vertical photo URL assigned to vertical pool","data":{"feed_field":"portrait_photo_url","asset_group_id":"images_vertical"}},{"description":"Split comma-separated tags to array","data":{"feed_field":"amenity_list","catalog_field":"amenities","transform":"split","separator":","}},{"description":"Boolean coercion with default","data":{"feed_field":"is_available","catalog_field":"available","transform":"boolean","default":false}}]},"external:core/account-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/account-ref.json","title":"Account Reference","description":"Reference to an advertiser account by seller-assigned ID or natural key. account_id is the seller/storefront handle returned by list_accounts. The natural key is brand + operator + optional operator_unit.id + optional fixed currency + optional buyer-selected account timezone + sandbox; it describes the advertiser object the seller resolves or provisions. After a capability-gated identity rekey, the former natural key is tombstoned and returns ACCOUNT_MOVED to authorized callers rather than resolving or provisioning another account. brand.countries qualifies the advertiser's geographic identity. operator_unit identifies the operator-owned buying seat or business unit and is distinct from the seller account. operator_unit.name is display metadata and does not participate in identity. Use account_id when the seller or upstream platform owns the canonical account namespace; use the natural key for buyer-declared accounts (require_operator_auth: false).","type":"object","oneOf":[{"properties":{"account_id":{"type":"string","description":"Seller-assigned account identifier. For upstream-managed account namespaces, this value comes from list_accounts; for seller-defined namespaces without a list_accounts surface, it is supplied out-of-band. Buyer-declared account sellers MAY echo account_id from sync_accounts as an internal handle, but they MUST continue accepting the account's current natural-key AccountRef on subsequent calls. Buyers of buyer-declared accounts send the natural key; a seller MAY also accept its echoed account_id, and buyers MUST NOT assume it does. A former key tombstoned by identity reconciliation returns ACCOUNT_MOVED to authorized callers.","x-entity":"account"}},"required":["account_id"],"additionalProperties":false},{"properties":{"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Brand reference identifying the advertiser"},"operator":{"type":"string","description":"Domain of the entity operating on the brand's behalf. When the brand operates directly, this is the brand's domain.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","x-entity":"operator"},"operator_unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1operator-unit.json","description":"Optional operator-owned business unit, agency seat, or platform account. Only id participates in the natural account key; name is mutable display metadata."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Immutable ISO 4217 transaction currency when the seller's advertiser object is currency-bound. When present, this is part of the natural account key and media buys on the account MUST use it. Omit when currency is selected independently per media buy."},"timezone":{"type":"string","minLength":1,"description":"Immutable account timezone. Include it in the natural key when get_adcp_capabilities.account.timezone declares account_fixed with buyer_selected; omit it for seller_fixed or seller_assigned accounts."},"sandbox":{"type":"boolean","description":"When true, references the sandbox account for this brand/operator pair. Defaults to false (production account).","default":false}},"required":["brand","operator"],"additionalProperties":false}],"examples":[{"account_id":"acc_acme_001"},{"brand":{"domain":"acme-corp.com"},"operator":"acme-corp.com"},{"brand":{"domain":"nova-brands.com","brand_id":"spark"},"operator":"pinnacle-media.com"},{"brand":{"domain":"nova-athletics.example","countries":["NL"]},"operator":"nova-athletics.example","operator_unit":{"id":"234284238","name":"Nova EMEA"},"currency":"EUR","timezone":"Europe/Amsterdam"},{"brand":{"domain":"acme-corp.com"},"operator":"acme-corp.com","sandbox":true}]},"external:core/operator-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/operator-unit.json","title":"Operator Unit","description":"Operator-owned buying context used to distinguish business units, agency seats, or platform accounts beneath one operator domain. The id is stable identity in the operator's namespace; name is mutable display metadata and never participates in account identity.","x-entity":"operator_unit","type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*$","description":"Stable identifier assigned by the operator. Numeric platform IDs and durable slugs are both valid. Scoped by the enclosing operator domain."},"name":{"type":"string","minLength":1,"maxLength":200,"description":"Human-readable seat or business-unit name, such as Nova EMEA. This label may change and is not part of the natural account key."}},"required":["id"],"additionalProperties":false,"examples":[{"id":"234284238","name":"Nova EMEA"},{"id":"benelux-seat","name":"Nova Benelux"}]},"external:enums/delivery-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/delivery-type.json","title":"Delivery Type","description":"Type of inventory delivery","type":"string","enum":["guaranteed","non_guaranteed"],"enumDescriptions":{"guaranteed":"Reserved inventory with guaranteed delivery","non_guaranteed":"Inventory without reserved or guaranteed delivery, commonly auction-based or otherwise best-effort. Do not use for scheduled broadcast buys solely because final audience delivery is estimated from historical ranges or settles through third-party measurement."}},"external:core/product-filters.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/product-filters.json","title":"Product Filters","description":"Structured offer filters for discovery. Filters decide which products may be returned based on metadata, commercial fit, availability assumptions, dates, budget, and reporting support; they do not become package delivery targeting. targeting_overlay constrains eligible delivery. Legacy targeting-like fields remain accepted during migration but are deprecated.","type":"object","properties":{"delivery_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1delivery-type.json"},"exclusivity":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1exclusivity.json","description":"Filter by exclusivity level. Returns products matching the specified exclusivity (e.g., 'exclusive' returns only sole-sponsorship products)."},"is_fixed_price":{"type":"boolean","description":"Legacy filter for fixed versus auction pricing availability. true returns options with fixed_price; false returns auction options whose price is established through bid_price. Contingent options such as revenue_share match neither value and MUST be omitted whenever this filter is present. Use pricing_structures to discover contingent pricing. Products with both fixed and auction options match both true and false, but sellers MUST return only entries matching the requested structure."},"pricing_structures":{"type":"array","description":"Filter by how the payable price is determined. fixed selects options with fixed_price, auction selects options established through bid_price, and contingent selects options calculated from a measured business outcome after delivery (currently revenue_share). Products match when at least one pricing option has a requested structure. Sellers MUST return only matching pricing_options entries. When combined with is_fixed_price, both filters apply and the returned entries must satisfy both.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1pricing-structure.json"},"minItems":1,"uniqueItems":true,"x-canonicalization":"set"},"pricing_currencies":{"type":"array","description":"Filter by currencies the buyer can use for the media product transaction, using ISO 4217 currency codes. Products match when they offer at least one product-level pricing_options entry in one of the requested currencies and any seller-applied or otherwise mandatory product-scoped signal charges are satisfiable in one of those currencies or have no incremental price. Mandatory custom signal pricing without currency is not satisfiable for this filter unless the seller can truthfully treat it as having no incremental price. Sellers MUST return only product pricing_options entries whose currency is in this list so buyers can select deterministically from discovery. This filter does not require pruning optional signal or vendor add-on pricing; buyers should avoid optional add-ons priced only in unsupported currencies.","items":{"type":"string","description":"ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP')","pattern":"^[A-Z]{3}$"},"minItems":1,"uniqueItems":true,"x-canonicalization":"set"},"format_ids":{"type":"array","deprecated":true,"x-removed-in":"4.0.0","description":"Deprecated in AdCP 3.2; removed in AdCP 4.0. Filter by legacy named-format references. Use `format_kinds` or `format_option_refs`.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1format-id.json"},"minItems":1},"format_kinds":{"type":"array","description":"Filter to products accepting any of these canonical format kinds.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1canonical-format-kind.json"},"minItems":1,"uniqueItems":true,"x-canonicalization":"set"},"format_option_refs":{"type":"array","description":"Filter to products accepting any of these exact publisher- or product-scoped canonical format options.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1format-option-ref.json"},"minItems":1,"uniqueItems":true,"x-canonicalization":"set"},"standard_formats_only":{"type":"boolean","description":"Only return products accepting IAB standard formats"},"min_exposures":{"type":"integer","description":"Minimum exposures/impressions needed for measurement validity","minimum":1},"start_date":{"type":"string","format":"date","description":"Campaign start date (ISO 8601 date format: YYYY-MM-DD) for availability checks"},"end_date":{"type":"string","format":"date","description":"Campaign end date (ISO 8601 date format: YYYY-MM-DD) for availability checks"},"budget_range":{"type":"object","description":"Budget range to filter appropriate products","properties":{"min":{"type":"number","description":"Minimum budget amount","minimum":0},"max":{"type":"number","description":"Maximum budget amount","minimum":0},"currency":{"type":"string","description":"ISO 4217 currency code (e.g., 'USD', 'EUR', 'GBP')","pattern":"^[A-Z]{3}$"}},"required":["currency"],"anyOf":[{"required":["min"]},{"required":["max"]}],"additionalProperties":true},"countries":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.countries. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"regions":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.regions. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]+$"},"minItems":1},"metros":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.metros. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json","description":"Metro classification system"},"code":{"type":"string","description":"Metro code within the system (e.g., '501' for NYC DMA)"}},"required":["system","code"],"additionalProperties":false},"minItems":1},"channels":{"type":"array","description":"Filter by advertising channels (e.g., ['display', 'ctv', 'dooh'])","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1channels.json"},"minItems":1},"video_placement_types":{"type":"array","description":"Filter product metadata by declared video placement types, using IAB Tech Lab/OpenRTB 2.6 video.plcmt definitions with AdCP-native names. A product matches when its declared array intersects the requested array. This is discovery classification only and does not promise delivery exclusively on a requested type; buyers needing exact placement inventory use targeting_overlay.placement_selection against targetable placements. This filter has set semantics for wholesale feed canonicalization.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1video-placement-type.json"},"uniqueItems":true,"minItems":1,"x-canonicalization":"set"},"audio_distribution_types":{"type":"array","description":"Filter product metadata by declared audio distribution types, using IAB Tech Lab/OpenRTB 2.6 audio.feed definitions with AdCP-native names. A product matches when its declared array intersects the requested array. This is discovery classification only and does not promise delivery exclusively on a requested type. This filter has set semantics for wholesale feed canonicalization.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audio-distribution-type.json"},"uniqueItems":true,"minItems":1,"x-canonicalization":"set"},"sponsored_placement_types":{"type":"array","description":"Filter retail-media product metadata by declared sponsored-placement types (sponsored search, sponsored display, or sponsored native). A product matches when its declared array intersects the requested array. This is discovery classification only and does not promise delivery exclusively on a requested type. This filter has set semantics for wholesale feed canonicalization.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1sponsored-placement-type.json"},"uniqueItems":true,"minItems":1,"x-canonicalization":"set"},"social_placement_surfaces":{"type":"array","description":"Filter social-product metadata by declared placement surfaces (feed, stories, short_video, explore, or search). A product matches when its declared array intersects the requested array. This is discovery classification only and does not promise delivery exclusively on a requested surface; buyers needing an exact public placement use targeting_overlay.placement_selection. This filter has set semantics for wholesale feed canonicalization.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1social-placement-surface.json"},"uniqueItems":true,"minItems":1,"x-canonicalization":"set"},"required_axe_integrations":{"type":"array","description":"Deprecated: Use trusted_match filter instead. Filter to products executable through specific agentic ad exchanges. URLs are canonical identifiers.","deprecated":true,"items":{"type":"string","format":"uri"},"minItems":1},"trusted_match":{"type":"object","description":"Filter products by Trusted Match Protocol capabilities. Only products with matching TMP support are returned.","properties":{"providers":{"type":"array","description":"Filter to products with specific TMP providers and match types. Each entry identifies a provider by agent_url and optionally requires specific match capabilities. Products must match at least one entry.","items":{"type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"Provider's agent URL from the registry."},"context_match":{"type":"boolean","description":"When true, require this provider to support context match."},"identity_match":{"type":"boolean","description":"When true, require this provider to support identity match."}},"required":["agent_url"],"additionalProperties":true},"minItems":1},"response_types":{"type":"array","description":"Filter to products supporting specific TMP response types (e.g., 'activation', 'creative', 'catalog_items'). Products must support at least one of the listed types.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1response-type.json"},"minItems":1}},"additionalProperties":false},"audience_activation_methods":{"type":"array","x-status":"experimental","description":"Filter to products whose audience_activation.methods matches at least one requested entry (OR across entries). Within an entry every specified field must match (AND); omitted optional fields are wildcards; directions matches on non-empty intersection, and a method that omits directions matches any requested directions; vendor matches on domain, plus brand_id when specified. Fields inapplicable to the requested pattern (e.g. transport on a clean_room entry) make that entry unsatisfiable. Sellers MUST exclude products with no audience_activation declaration when this filter is present; exclusions MAY be reported via filter_diagnostics.excluded_by. Experimental: part of the media_buy.audience_activation surface — buyers SHOULD check the seller's experimental_features before filtering on it; sellers that do not list the feature ignore this filter.","items":{"oneOf":[{"type":"object","description":"Filter by AdCP audience sync path.","properties":{"pattern":{"type":"string","const":"sync_audiences"}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by TMP identity-match path, optionally pinned to a specific buyer agent.","properties":{"pattern":{"type":"string","const":"tmp_identity_match"},"buyer_agent":{"type":"object","description":"Require this buyer agent on tmp_identity_match entries. Buyers typically filter on their own agent_url.","properties":{"agent_url":{"type":"string","format":"uri"}},"required":["agent_url"],"additionalProperties":false}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by bucket-addressed file exchange, optionally pinning transport, directions, or vendor.","properties":{"pattern":{"type":"string","const":"file_transfer"},"transport":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1cloud-storage-protocol.json","description":"Require this storage protocol (file_transfer only)."},"directions":{"type":"array","description":"Require a non-empty intersection with the method's declared directions (file_transfer only).","items":{"type":"string","enum":["buyer_to_seller","seller_to_buyer"]},"minItems":1,"uniqueItems":true},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Require the method's vendor to match this reference."}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by vendor-mediated dataset query path.","properties":{"pattern":{"type":"string","const":"dataset_query"},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Require the method's vendor to match this reference."}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by clean-room path.","properties":{"pattern":{"type":"string","const":"clean_room"},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Require the method's vendor to match this reference."}},"required":["pattern"],"additionalProperties":false},{"type":"object","description":"Filter by platform distribution path.","properties":{"pattern":{"type":"string","const":"platform_distribution"},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Require the method's vendor to match this reference."}},"required":["pattern"],"additionalProperties":false}]},"minItems":1,"uniqueItems":true},"required_features":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1media-buy-features.json","description":"Filter to products from sellers supporting specific protocol features. Only features set to true are used for filtering."},"required_geo_targeting":{"type":"array","description":"DEPRECATED. Use get_products.required_overlay_support, which is product-scoped and applies consistently to geographic and non-geographic targeting dimensions.","deprecated":true,"items":{"type":"object","properties":{"level":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1geo-level.json","description":"Geographic targeting level (country, region, metro, postal_area)"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code. Required for native postal_area system filters; not applicable to country, region, or metro filters."},"system":{"type":"string","description":"Optional classification system within the level. Use for a specific metro system (e.g., 'nielsen_dma'), native postal_area system (e.g., 'zip' with country 'US'), or deprecated legacy postal alias (e.g., 'us_zip'). Not applicable for country/region which use ISO standards."}},"required":["level"],"allOf":[{"if":{"properties":{"level":{"enum":["country","region"]}},"required":["level"]},"then":{"not":{"anyOf":[{"required":["country"]},{"required":["system"]}]}}},{"if":{"properties":{"level":{"const":"metro"}},"required":["level"]},"then":{"anyOf":[{"not":{"required":["system"]}},{"properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json"}},"required":["system"]}],"not":{"required":["country"]}}},{"if":{"properties":{"level":{"const":"postal_area"}},"required":["level"]},"then":{"anyOf":[{"not":{"anyOf":[{"required":["country"]},{"required":["system"]}]}},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-country-system.json"},{"properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1legacy-postal-system.json"}},"required":["system"],"not":{"required":["country"]}}]}}],"additionalProperties":false},"minItems":1},"signal_targeting":{"type":"array","description":"DEPRECATED legacy signal-option eligibility filter. Retained get_products handlers MUST preserve the signal identity, value predicate, and requested include/exclude capability. This does not activate delivery targeting. Native buyers use criteria.targeting_overlay.signal_targeting_groups only for concrete delivery selections, preserving exclusion through group operators; copying targeting_mode into targeting_overlay.signal_targeting does not preserve it.","deprecated":true,"items":{"type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-targeting.json"}],"properties":{"targeting_mode":{"type":"string","description":"Desired use of this signal on the product. 'include' requires the product option to allow use in an any group. 'exclude' requires the product option to allow use in a none group.","enum":["include","exclude"],"default":"include"}}},"minItems":1},"postal_areas":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.postal_areas. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_proximity":{"type":"array","description":"DEPRECATED legacy coverage filter. On compact discovery tasks use criteria.offer_filters.geo_proximity. Return products whose inventory covers at least one requested area; this does not impose delivery targeting or require selectable targeting support. Retained get_products handlers MUST preserve the original coverage predicate.","deprecated":true,"items":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees (WGS 84)"},"lng":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees (WGS 84)"},"label":{"type":"string","description":"Human-readable label (e.g., 'Düsseldorf', 'Heathrow Airport')"},"travel_time":{"type":"object","description":"Travel time limit for isochrone calculation","properties":{"value":{"type":"number","minimum":1,"description":"Travel time limit"},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1travel-time-unit.json"}},"required":["value","unit"],"additionalProperties":false},"transport_mode":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1transport-mode.json","description":"Transportation mode for isochrone calculation. Required when travel_time is provided."},"radius":{"type":"object","description":"Simple radius from the point","properties":{"value":{"type":"number","exclusiveMinimum":0,"description":"Radius distance"},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1distance-unit.json","description":"Distance unit"}},"required":["value","unit"],"additionalProperties":false},"geometry":{"type":"object","description":"Pre-computed GeoJSON geometry defining the proximity boundary","properties":{"type":{"type":"string","enum":["Polygon","MultiPolygon"],"description":"GeoJSON geometry type"},"coordinates":{"type":"array","description":"GeoJSON coordinates array"}},"required":["type","coordinates"],"additionalProperties":false}},"oneOf":[{"required":["lat","lng","travel_time","transport_mode"],"not":{"anyOf":[{"required":["radius"]},{"required":["geometry"]}]}},{"required":["lat","lng","radius"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["geometry"]}]}},{"required":["geometry"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["radius"]}]}}],"additionalProperties":true},"minItems":1},"required_performance_standards":{"type":"array","description":"Filter to products that can meet the buyer's performance standard requirements. Each entry specifies a metric, minimum threshold, and optionally a required vendor and standard. Products that cannot meet these thresholds or do not support the specified vendors are excluded. Use this to tell the seller upfront: 'I need DoubleVerify for viewability at 70% MRC.'","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1performance-standard.json"},"minItems":1},"required_metrics":{"type":"array","description":"Filter to products whose `reporting_capabilities.available_metrics` is a superset of these metrics — i.e., products that commit to reporting all listed metrics in delivery responses. Use this for capability-level discovery (e.g., 'I need products that report `completed_views` for a CTV CPCV buy'); guarantee-level requirements with thresholds belong in `required_performance_standards` and `measurement_terms`. Sellers MUST silently exclude products that cannot meet this list (filter-not-fail; do not return an error). Under the container-subsumption rule in `enums/available-metric.json`, `viewability` satisfies numeric leaves such as `viewable_rate`; structured distributions require explicit `viewed_seconds_percentiles` or `viewed_seconds_histogram` declarations. The product's declared `available_metrics` becomes the binding reporting contract carried into the resulting media buy — the same metric vocabulary is used to compute `missing_metrics` on `get_media_buy_delivery`.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1available-metric.json"},"minItems":1,"uniqueItems":true,"examples":[["completed_views"],["completed_views","completion_rate"],["impressions","spend","engagements"]]},"required_vendor_metrics":{"type":"array","description":"Filter to products whose `reporting_capabilities.vendor_metrics` matches these criteria. Each entry pins a `vendor` (matches any metric from that vendor), a `metric_id` (matches the metric across any vendor that uses that identifier), or both (specific vendor's specific metric). A product matches if its declared `vendor_metrics` covers ALL listed entries (AND across entries; pins within an entry are conjunctive). Cross-vendor discovery (e.g., 'I need attention measurement from any vendor that does it') is the buyer agent's responsibility — the agent resolves which vendors offer a category via the vendors' `brand.json` records, then enumerates them as filter entries. AdCP does not carry vendor-side metric metadata (category, methodology, standard alignment) in the filter surface; that lives at the vendor and is queried out-of-band. Sellers MUST silently exclude non-matching products (filter-not-fail; do not return an error) — same convention as the other `required_*` filters.","items":{"type":"object","properties":{"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Pin to a specific vendor. Optional — omit to match any vendor offering this `metric_id`."},"metric_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1vendor-metric-id.json","description":"Pin to an exact metric identifier within a vendor's vocabulary. Optional — omit to match any metric from the pinned vendor. Cross-vendor identifier matching only works after vendors converge on identifiers (typically post-standardization)."}},"anyOf":[{"required":["vendor"]},{"required":["metric_id"]}],"additionalProperties":false},"minItems":1,"examples":[[{"vendor":{"domain":"attentionvendor.example"}}],[{"vendor":{"domain":"panelmeasurement.example"},"metric_id":"demographic_reach"}],[{"vendor":{"domain":"attentionvendor.example"}},{"vendor":{"domain":"secondattentionvendor.example"}}]]},"keywords":{"type":"array","description":"DEPRECATED legacy product eligibility filter. Retained get_products handlers MUST preserve the requested keyword eligibility and match_type (default broad). This is not an instruction to add package keyword targeting. Native buyers use criteria.targeting_overlay.keyword_targets only when they intend a delivery constraint, or criteria.required_overlay_support.keyword_targets for future selectability.","deprecated":true,"items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to target"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1match-type.json","default":"broad"}},"required":["keyword"],"additionalProperties":false},"minItems":1},"audience_evidence_requirements":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1audience-evidence-requirements.json","description":"Buyer policy for evaluating Product.audience_evidence. In required mode, sellers MUST apply the evidence_presence and admissibility semantics and exclude non-matching products; they MUST NOT ignore an unsupported hard requirement. In preferred mode, sellers use matches for ranking and explain the evidence selected. Buyers SHOULD inspect media_buy.audience_evidence capabilities before sending this object."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json","description":"Vendor-namespaced extension parameters for seller-specific filter criteria not covered by standard fields. Keys MUST be namespaced under a vendor or platform key (e.g., ext.gam, ext.platform_x). Sellers MUST treat all values as untrusted buyer input; do not interpolate into LLM prompts, SQL queries, or system commands without sanitization. Persistent use of an extension key across multiple buyers is a signal to propose standardization."}},"additionalProperties":true},"external:enums/exclusivity.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/exclusivity.json","title":"Exclusivity","description":"Whether a product offers exclusive access to its inventory","type":"string","enum":["none","category","exclusive"],"enumDescriptions":{"none":"No exclusivity — multiple advertisers can buy this product simultaneously","category":"Category-exclusive — only one advertiser per industry category (e.g., one auto brand per collection sponsorship)","exclusive":"Sole sponsorship — only one advertiser can buy this product"}},"external:enums/pricing-structure.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/pricing-structure.json","title":"Pricing Structure","description":"How the payable price is determined. Fixed pricing has a seller-declared monetary unit price, auction pricing is established through a buyer bid, and contingent pricing is calculated from a measured business outcome after delivery.","type":"string","enum":["fixed","auction","contingent"],"enumDescriptions":{"fixed":"Seller-declared monetary unit price through fixed_price","auction":"Buyer bid against optional floor_price and price_guidance","contingent":"Price calculated from a measured business outcome after delivery"}},"external:core/format-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/format-id.json","title":"Format Reference (Structured Object)","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format reference retained for 3.x compatibility. This JSON object — never a plain string — identifies a format by its declaring agent and local slug, and may carry legacy logical dimensions, pixel ratio, or duration parameters. New products and manifests use canonical `format_options`, `format_kind`, and `format_option_ref`; creative-agent build routing uses `creative.supported_formats[].capability_id`.","x-entity":"creative_format","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent that defines this format (e.g., 'https://creative.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats). Callers comparing two `format-id` values MUST canonicalize `agent_url` per the AdCP URL canonicalization rules before treating two formats as the same. See docs/reference/url-canonicalization."},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant."},"width":{"type":"integer","minimum":1,"description":"Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."},"height":{"type":"integer","minimum":1,"description":"Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."},"duration_ms":{"type":"number","minimum":1,"description":"Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters."},"pixel_ratio":{"type":"number","exclusiveMinimum":0,"description":"Required intrinsic-pixel density for a parameterized visual format, expressed as intrinsic pixels per logical pixel. Requires `width` and `height`. Example: `{id: \"display_image\", width: 300, height: 250, pixel_ratio: 2}` identifies a 300×250 logical render supplied by a 600×500 image. Omit for the backward-compatible 1x variant."}},"required":["agent_url","id"],"additionalProperties":true,"dependentRequired":{"width":["height"],"height":["width"],"pixel_ratio":["width","height"]}},"external:core/canonical-format-kind.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/canonical-format-kind.json","title":"Canonical Format Kind","description":"Discriminator naming one of the 15 AdCP 3.2 canonical creative formats, plus `custom` for adopter-defined shapes. AdCP 3.2 adds `audio_vast` for VAST-tag-delivered audio (the standards-conformant profile starts at VAST 4.1, with older versions available only as seller-declared legacy interoperability) and promotes the legacy `multi_state_display` and `multi_placement_takeover` custom shapes to `seller_rendered_stateful_display` and `coordinated_placements`. When `format_kind` is `custom`, the declaration also carries `format_shape` and `format_schema`. The enum mirrors the branches in `product-format-declaration.json` and is closed for producer validation: sellers do not mint ad-hoc values. SDKs may retain unknown future values in tolerant in-memory parsers, but that does not change versioned JSON Schema validation. A seller responding to a 3.1-or-earlier request MUST project away 3.2-only kinds and emit a compatible legacy declaration; a strict older schema correctly rejects an unprojected newer kind. See adcp#3666 and the promotion migration contract in canonical-formats.mdx.","type":"string","enum":["image","html5","display_tag","image_carousel","video_hosted","video_vast","audio_hosted","audio_vast","audio_daast","sponsored_placement","native_in_feed","responsive_creative","agent_placement","seller_rendered_stateful_display","coordinated_placements","custom"]},"external:core/format-option-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/format-option-ref.json","title":"Format Option Reference","description":"Discriminated reference to a product format option. The global canonical shape is still named by `format_kind`; this reference selects one concrete product `format_options[]` entry. `scope: \"publisher\"` identifies a publisher-declared catalog option by `{ publisher_domain, format_option_id }`. `scope: \"product\"` identifies a product-local option by `format_option_id`; the enclosing package/product context supplies the namespace.","type":"object","discriminator":{"propertyName":"scope"},"oneOf":[{"title":"Publisher Catalog Format Option Reference","description":"Selects a publisher-catalog-backed product format option by publisher domain and format option ID.","type":"object","properties":{"scope":{"type":"string","const":"publisher","description":"Reference resolves against the named publisher's adagents.json top-level `formats[]` catalog."},"publisher_domain":{"type":"string","description":"Publisher domain where the adagents.json declaring this format option is hosted.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"format_option_id":{"type":"string","description":"Stable format option ID from the publisher's adagents.json top-level `formats[]`, matching a publisher-catalog-backed entry in the target product's `format_options[]`."}},"required":["scope","publisher_domain","format_option_id"],"additionalProperties":true},{"title":"Product-Local Format Option Reference","description":"Selects a product-local format option by ID within the enclosing package/product context. This branch deliberately forbids `publisher_domain` (`publisher_domain: false` in the schema) because product-local references are namespaced by the enclosing product only; include `scope: \"publisher\"` when the selector must cross into a publisher catalog.","type":"object","properties":{"scope":{"type":"string","const":"product","description":"Reference resolves only against the target product's inline `format_options[]`."},"format_option_id":{"type":"string","description":"Stable format option ID from the target product's inline `format_options[]`."},"publisher_domain":false},"required":["scope","format_option_id"],"additionalProperties":true}],"additionalProperties":true},"external:enums/metro-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/metro-system.json","title":"Metro Area System","description":"Metro area classification systems for geographic targeting","type":"string","enum":["nielsen_dma","uk_itl1","uk_itl2","eurostat_nuts2","custom"]},"external:enums/channels.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/channels.json","title":"Media Channel","description":"Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.","type":"string","enum":["display","olv","social","search","ctv","linear_tv","radio","streaming_audio","podcast","dooh","ooh","print","cinema","email","gaming","retail_media","influencer","affiliate","product_placement","sponsored_intelligence"],"enumDescriptions":{"display":"Digital display advertising (banners, native, rich media) across web and app","olv":"Online video advertising outside CTV (pre-roll, outstream, in-app video)","social":"Social media platforms (Facebook, Instagram, TikTok, LinkedIn, etc.)","search":"Search engine advertising and search networks","ctv":"Connected TV and streaming on television screens","linear_tv":"Traditional broadcast and cable television","radio":"Traditional AM/FM radio broadcast","streaming_audio":"Digital audio streaming services (Spotify, Pandora, etc.)","podcast":"Podcast advertising (host-read or dynamically inserted)","dooh":"Digital out-of-home buying context, including inventory on venue-operated screens and audio players","ooh":"Classic out-of-home (physical billboards, transit, etc.)","print":"Newspapers, magazines, and other print publications","cinema":"Movie theater advertising","email":"Email advertising and sponsored newsletter content","gaming":"In-game advertising across platforms","retail_media":"Retail media networks and commerce marketplaces (Amazon, Walmart, Instacart)","influencer":"Creator and influencer marketing partnerships","affiliate":"Affiliate networks, comparison sites, and performance-based partnerships","product_placement":"Product placement, branded content, and sponsorship integrations","sponsored_intelligence":"Sponsored Intelligence — advertising within AI assistants, AI search, and generative AI experiences via the reversed data flow"}},"external:enums/video-placement-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/video-placement-type.json","title":"Video Placement Type","description":"Declared video placement classification for OLV and other video inventory, using the IAB Tech Lab/OpenRTB 2.6 video.plcmt definitions with AdCP-native value names. This is seller-declared discovery metadata, not independent verification of inventory quality or delivery context.","type":"string","enum":["instream","accompanying_content","interstitial","standalone"],"enumDescriptions":{"instream":"OpenRTB 2.6 video.plcmt=1: video ads played before, during, or after streaming video content requested by the user.","accompanying_content":"OpenRTB 2.6 video.plcmt=2: video ads played with accompanying video content in a player associated with the page or app content.","interstitial":"OpenRTB 2.6 video.plcmt=3: video ads shown as an interstitial experience, typically between content or app states.","standalone":"OpenRTB 2.6 video.plcmt=4: video ads shown without associated video content, also called no-content or standalone video."}},"external:enums/audio-distribution-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/audio-distribution-type.json","title":"Audio Distribution Type","description":"Declared audio distribution classification for radio, streaming-audio, podcast, and other audio inventory, using IAB Tech Lab/OpenRTB 2.6 audio.feed definitions with AdCP-native value names. This is seller-declared discovery metadata, not independent verification of inventory quality or delivery context.","type":"string","enum":["music_streaming_service","fm_am_broadcast","podcast","catch_up_radio","web_radio","video_game","text_to_speech"],"enumDescriptions":{"music_streaming_service":"OpenRTB 2.6 audio.feed=1: music streaming service.","fm_am_broadcast":"OpenRTB 2.6 audio.feed=2: FM/AM broadcast, including live content broadcast over the air and also available via online streaming.","podcast":"OpenRTB 2.6 audio.feed=3: original, pre-recorded content distributed as episodes in a series.","catch_up_radio":"OpenRTB 2.6 audio.feed=4: recorded segment of a radio show that was originally broadcast live.","web_radio":"OpenRTB 2.6 audio.feed=5: live audio content only available via online streaming, not as FM/AM broadcast.","video_game":"OpenRTB 2.6 audio.feed=6: background audio in video games.","text_to_speech":"OpenRTB 2.6 audio.feed=7: text-to-speech audio such as audio books or website/plugin article narration."}},"external:enums/sponsored-placement-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/sponsored-placement-type.json","title":"Sponsored Placement Type","description":"Declared sponsored-placement classification for catalog-driven retail-media inventory, distinguishing where the sponsored placement renders on the retailer surface. This is seller-declared discovery metadata, not independent verification of inventory quality or delivery context.","type":"string","enum":["sponsored_search","sponsored_display","sponsored_native"],"enumDescriptions":{"sponsored_search":"Sponsored placements rendered against retailer on-site search results, keyed to the shopper's query (e.g., Amazon Sponsored Products on search, Walmart Connect Sponsored Search).","sponsored_display":"Sponsored placements rendered in display slots across retailer browse, category, and product-detail pages outside the search results stream (e.g., Criteo Sponsored Display, Amazon Sponsored Display on-site).","sponsored_native":"Sponsored placements rendered using the retailer's native in-grid product template, blending into the organic product listing (e.g., CitrusAd native product cards, Pinterest catalog-driven collections)."}},"external:enums/social-placement-surface.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/social-placement-surface.json","title":"Social Placement Surface","description":"Declared social-placement surface classification for social inventory, distinguishing the in-app surface where a social placement renders. Values name the semantic surface, not platform brands. This is seller-declared discovery metadata, not independent verification of inventory quality or delivery context.","type":"string","enum":["feed","stories","short_video","explore","search"],"enumDescriptions":{"feed":"The primary scrolling home or timeline surface where posts and ads are interleaved with followed and recommended content.","stories":"The full-screen, ephemeral tap-through surface presented between or alongside users' story content.","short_video":"The full-screen, sound-on, swipe-past, algorithmically-recommended vertical short-video surface. Subsumes the platform brand names for this surface (Reels, Shorts, Spotlight, and TikTok's For You short-video experience) — platform identity belongs to a property/publisher axis, not here.","explore":"The discovery or browse surface presenting recommended content outside the user's followed graph.","search":"The in-app search-results surface, keyed to the user's query."}},"external:enums/response-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/response-type.json","title":"TMP Response Type","description":"What the publisher wants back from a TMP context match. Determines the richness level of the buyer's offer response.","type":"string","enum":["activation","catalog_items","creative","deal"],"enumDescriptions":{"activation":"Binary activation with GAM key-values. Offers identify the package via package_id.","catalog_items":"Preferred catalog items for rendering. Offers may include catalog item references.","creative":"Inline creative manifest. Offers include full rendering details.","deal":"Deal ID for programmatic execution. Offers include deal metadata."}},"external:enums/cloud-storage-protocol.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/cloud-storage-protocol.json","title":"Cloud Storage Protocol","description":"Cloud storage protocols supported for offline file delivery","type":"string","enum":["s3","gcs","azure_blob"]},"external:core/media-buy-features.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/media-buy-features.json","title":"Media Buy Features","description":"Optional media-buy protocol features. Used in capability declarations (seller declares support) and product filters (buyer requires support). If a seller declares a feature as true, they MUST honor requests using that feature.","type":"object","properties":{"inline_creative_management":{"type":"boolean","deprecated":true,"x-removed-in":"4.0.0","description":"Deprecated 3.x compatibility capability for creatives provided inline in create_media_buy and update_media_buy package payloads. buy_products, accept_proposal, and control_media_buy never accept inline creatives. New integrations use the dedicated creative lifecycle. Removed in 4.0."},"property_list_filtering":{"type":"boolean","description":"Honors property_list parameter in get_products to filter results to buyer-approved properties"},"catalog_management":{"type":"boolean","description":"Supports sync_catalogs task for catalog feed management with platform review and approval"},"catalog_item_availability_updates":{"type":"boolean","description":"Supports buyer-pushed item_availability_updates and item_availability_queries on sync_catalogs for immediate suppression/restoration and current-state readback in buyer-managed catalogs. Seller declarations may be true only with catalog_management: true; buyer required_features filters may request this feature alone. Requests containing availability operations are synchronous and accept at most 1,000 combined update and query entries. A successful suppress covers selection, dynamic rendering, and cached or pre-generated creatives materialized from the item. Internal lineage MUST retain resolved_account_id, catalog_id, catalog_generation, and item_id. Static creatives supplied or promoted by the buyer without catalog lineage remain outside this automatic guarantee. Suppression persists across feed refreshes and ordinary upserts until restore, expires_at, or catalog deletion. A seller that does not declare true MUST reject availability operations with UNSUPPORTED_FEATURE before lookup or mutation and MUST NOT interpret them as discovery. This does not control seller-owned wholesale inventory or let restore bypass seller controls."},"committed_metrics_supported":{"type":"boolean","description":"Seller has per-package snapshot infrastructure for the reporting contract. When true, the seller MUST populate `package.committed_metrics` on committed `create_media_buy` responses where `confirmed_at` is non-null, MUST omit `package.committed_metrics` while `confirmed_at` is null for a provisional buy, and MUST honor append-only mid-flight metric additions via `update_media_buy`. The unified `committed_metrics` array (per the metric-accountability design) covers both standard and vendor-defined metric entries, so a single flag is load-bearing. Buyers filtering on this flag are detecting 'this seller can stamp the reporting contract,' which closes the audit gap from PR #3510 where absence of `committed_metrics` was indistinguishable between 'didn't snapshot' and 'snapshot infrastructure not implemented.'"},"seller_optimized_budget":{"type":"boolean","description":"Supports the core seller-optimized shared-budget contract for budget_allocation.mode `seller_optimized`: one hard shared total_budget, seller allocation of that total across the buy's packages against budget_allocation.optimization_goals, media-buy-level pacing, and echo of the allocation configuration on buy read surfaces. Sellers declaring true MUST accept eligible explicit-package and proposal executions that use only these core controls and MUST enforce the aggregate budget. Core media-buy pacing: sellers declaring true MUST accept omitted media-buy pacing (which defaults to even when total_budget is present) and pacing `even` on seller-optimized buys; they MAY reject `asap` or `front_loaded` with `UNSUPPORTED_FEATURE` (error.field `pacing`) before any provider mutation, and MUST NOT silently coerce them to `even`. Package-level controls inside a seller-optimized buy are separate capabilities: package budget caps (seller_optimized_package_budgets), package minimum-spend targets (seller_optimized_min_spend_targets), and package pacing (seller_optimized_package_pacing). A seller declaring this feature but not one of those sub-capabilities MUST reject any request that would leave that package control on a seller-optimized buy with `UNSUPPORTED_FEATURE` before any over-subscription validation or provider mutation, and MUST NOT silently drop, soften, or coerce it. Over-subscription validation (`INVALID_REQUEST`) applies only to package controls the seller has declared; see seller_optimized_min_spend_targets. Product combinations may still be rejected when their currencies, optimization capabilities, pricing terms, or delivery constraints are incompatible. Sellers that do not declare this feature MUST reject any request carrying `budget_allocation.mode: 'seller_optimized'` with `UNSUPPORTED_FEATURE` before any provider mutation, and MUST NOT coerce the request to fixed allocation."},"seller_optimized_package_budgets":{"type":"boolean","description":"Honors package `budget` as an optional hard lifetime package spend cap inside a seller-optimized buy: packages[].budget and new_packages[].budget on create_media_buy and update_media_buy, purchases[].budget on buy_products, package budget controls on control_media_buy, and max_spend_percentage on seller-optimized proposal allocations. The cap is a ceiling, not a reserved or current allocation, and package caps may sum above total_budget. Meaningful only with seller_optimized_budget: true; seller declarations may be true only with seller_optimized_budget: true, while buyer required_features filters may request this feature alone. A seller that declares seller_optimized_budget without this feature MUST reject a request that would leave a package budget on a seller-optimized buy, including an allocation-mode switch that retains fixed-mode package budgets (the buyer clears them with null in the same atomic update), with `UNSUPPORTED_FEATURE` before any over-subscription validation or provider mutation, and MUST NOT issue seller-optimized proposals carrying max_spend_percentage. Does not govern fixed allocation, where package budgets remain required."},"seller_optimized_min_spend_targets":{"type":"boolean","description":"Honors package `min_spend_target` as a soft lifetime minimum-spend target inside a seller-optimized buy: packages[].min_spend_target and new_packages[].min_spend_target on create_media_buy and update_media_buy, purchases[].min_spend_target on buy_products, package min_spend_target controls on control_media_buy, and min_spend_target_percentage on seller-optimized proposal allocations. The seller SHOULD attempt to deliver at least the target before allocating incremental spend elsewhere; it is not a billing or delivery guarantee. Meaningful only with seller_optimized_budget: true; seller declarations may be true only with seller_optimized_budget: true, while buyer required_features filters may request this feature alone. Sellers declaring this feature MUST reject package minimum-spend targets summing above total_budget with `INVALID_REQUEST` before mutation, and, when they also declare seller_optimized_package_budgets, MUST likewise reject a min_spend_target above its own package budget. A seller that declares seller_optimized_budget without this feature MUST reject a request carrying a numeric min_spend_target with `UNSUPPORTED_FEATURE` before any over-subscription validation or provider mutation, so an over-subscribed target sent to such a seller yields `UNSUPPORTED_FEATURE`, and MUST NOT issue seller-optimized proposals carrying min_spend_target_percentage."},"seller_optimized_package_pacing":{"type":"boolean","description":"Honors package `pacing` as subordinate per-package pacing inside a seller-optimized buy, in addition to the media-buy-level pacing covered by seller_optimized_budget: packages[].pacing and new_packages[].pacing on create_media_buy and update_media_buy, purchases[].pacing on buy_products, package pacing controls on control_media_buy, and allocation pacing on seller-optimized proposals. Package pacing MUST NOT cause delivery to exceed aggregate media-buy pacing. Meaningful only with seller_optimized_budget: true; seller declarations may be true only with seller_optimized_budget: true, while buyer required_features filters may request this feature alone. Package pacing equal to the effective media-buy pacing adds no subordinate constraint and does not require this feature; buyers SHOULD omit package pacing on seller-optimized buys unless this feature is advertised. A seller that declares seller_optimized_budget without this feature MUST reject a request that would leave package pacing differing from media-buy pacing on a seller-optimized buy, including an allocation-mode switch that retains such fixed-mode package pacing (the buyer can align it in the same update), with `UNSUPPORTED_FEATURE` before any provider mutation, and MUST NOT issue seller-optimized proposals carrying allocation pacing. Does not govern package pacing in fixed allocation."},"bidding_policy":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json"}],"description":"Structured support for canonical bidding by authored scope, allocation context, mode, strength, and strength-qualified multi-field combination. Presence does not imply support for both scopes, both allocation modes, or every policy shape. Sellers MUST preserve every advertised semantic exactly and reject unadvertised policies rather than translating them."}},"additionalProperties":{"type":"boolean"}},"external:core/bidding-policy-capability.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/bidding-policy-capability.json","title":"Bidding Policy Capability","description":"Structured declaration of the canonical bidding policies a seller can preserve without semantic translation. Media-buy/package authored scope and fixed/seller-optimized allocation context are advertised independently. Buyers MUST inspect the exact scope, allocation context, mode, strength, and combination rather than treating presence of this object as blanket support.","x-adcp-hoist":true,"type":"object","properties":{"media_buy":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/scope_capability","description":"Policies accepted at media-buy scope and inherited by packages that omit a package override."},"package":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/scope_capability","description":"Policies accepted as package-authored policies, including explicit automatic overrides."}},"minProperties":1,"additionalProperties":false,"$defs":{"scope_capability":{"type":"object","description":"Support at one authored scope, partitioned by the media buy's resulting allocation mode. Omitted contexts are unsupported; claims in one context make no claim about the other.","properties":{"fixed":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/policy_profile","description":"Policies supported when budget allocation is fixed or omitted."},"seller_optimized":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/policy_profile","description":"Policies supported when budget_allocation.mode is seller_optimized."}},"minProperties":1,"additionalProperties":false},"policy_profile":{"type":"object","properties":{"modes":{"type":"array","description":"Standalone policy modes accepted in this exact scope and allocation context. Combination-only components belong only in supported_combinations and need not appear here. `automatic` means the seller accepts and preserves an explicit `{automatic:true}` authored block; omission only invokes inheritance/default behavior.","items":{"type":"string","enum":["automatic","bid_amount","max_bid","cost_per","roas"]},"minItems":1,"uniqueItems":true},"cost_per_strengths":{"type":"array","description":"Supported standalone cost_per strengths in this profile. Required exactly when modes includes cost_per.","items":{"type":"string","enum":["cap","target"]},"minItems":1,"uniqueItems":true},"roas_strengths":{"type":"array","description":"Supported standalone roas strengths in this profile. Required exactly when modes includes roas.","items":{"type":"string","enum":["floor","target"]},"minItems":1,"uniqueItems":true},"supported_combinations":{"type":"array","description":"Multi-field policies supported in this exact scope and allocation context. Each entry independently qualifies the strengths supported in that combination; standalone strength support does not imply combination support. Absence means no multi-field combination is claimed.","items":{"oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/max_bid_with_cost_per"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1bidding-policy-capability.json/$defs/max_bid_with_roas"}]},"minItems":1}},"anyOf":[{"required":["modes"]},{"required":["supported_combinations"]}],"allOf":[{"if":{"properties":{"modes":{"contains":{"const":"cost_per"}}},"required":["modes"]},"then":{"required":["cost_per_strengths"]},"else":{"not":{"required":["cost_per_strengths"]}}},{"if":{"properties":{"modes":{"contains":{"const":"roas"}}},"required":["modes"]},"then":{"required":["roas_strengths"]},"else":{"not":{"required":["roas_strengths"]}}}],"additionalProperties":false},"max_bid_with_cost_per":{"type":"object","properties":{"kind":{"type":"string","const":"max_bid_with_cost_per"},"cost_per_strengths":{"type":"array","description":"cost_per strengths supported when combined with max_bid.","items":{"type":"string","enum":["cap","target"]},"minItems":1,"uniqueItems":true}},"required":["kind","cost_per_strengths"],"additionalProperties":false},"max_bid_with_roas":{"type":"object","properties":{"kind":{"type":"string","const":"max_bid_with_roas"},"roas_strengths":{"type":"array","description":"roas strengths supported when combined with max_bid.","items":{"type":"string","enum":["floor","target"]},"minItems":1,"uniqueItems":true}},"required":["kind","roas_strengths"],"additionalProperties":false}}},"external:enums/geo-level.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/geo-level.json","title":"Geographic Targeting Level","description":"Geographic targeting granularity levels. Some levels (metro, postal_area) require a system specification.","type":"string","enum":["country","region","metro","postal_area"]},"external:core/postal-country-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/postal-country-system.json","title":"Postal Country System","description":"Valid country-local postal system pairing. Registered countries only accept their registered local systems; countries without a registered local system use postal_code or custom.","type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1postal-system.json","description":"Country-local postal code system."}},"required":["country","system"],"anyOf":[{"properties":{"country":{"const":"US"},"system":{"enum":["zip","zip_plus_four"]}}},{"properties":{"country":{"const":"GB"},"system":{"enum":["outward","full"]}}},{"properties":{"country":{"const":"CA"},"system":{"enum":["fsa","full"]}}},{"properties":{"country":{"enum":["DE","CH","AT"]},"system":{"const":"plz"}}},{"properties":{"country":{"const":"FR"},"system":{"const":"code_postal"}}},{"properties":{"country":{"const":"AU"},"system":{"const":"postcode"}}},{"properties":{"country":{"const":"BR"},"system":{"const":"cep"}}},{"properties":{"country":{"const":"IN"},"system":{"const":"pin"}}},{"properties":{"country":{"const":"ZA"},"system":{"const":"postal_code"}}},{"properties":{"country":{"not":{"enum":["US","GB","CA","DE","CH","AT","FR","AU","BR","IN","ZA"]}},"system":{"enum":["postal_code","custom"]}}}]},"external:enums/postal-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/postal-system.json","title":"Postal Code System","description":"Postal code system names for geographic targeting. Prefer country-local values with an explicit ISO 3166-1 alpha-2 country. Deprecated country-fused values remain in this published enum for 3.x compatibility.","type":"string","enum":["postal_code","zip","zip_plus_four","outward","full","fsa","plz","code_postal","postcode","cep","pin","custom","us_zip","us_zip_plus_four","gb_outward","gb_full","ca_fsa","ca_full","de_plz","fr_code_postal","au_postcode","ch_plz","at_plz"]},"external:enums/legacy-postal-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/legacy-postal-system.json","title":"Country-Fused Postal Code System","description":"Deprecated country-fused postal code systems for geographic targeting. Prefer postal-system with an explicit ISO 3166-1 alpha-2 country on postal area objects.","type":"string","deprecated":true,"enum":["us_zip","us_zip_plus_four","gb_outward","gb_full","ca_fsa","ca_full","de_plz","fr_code_postal","au_postcode","ch_plz","at_plz"]},"external:core/signal-targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/signal-targeting.json","title":"Signal Targeting","description":"Targeting constraint for a specific signal. Uses value_type as discriminator to determine the targeting expression format.","discriminator":{"propertyName":"value_type"},"oneOf":[{"type":"object","description":"Binary signal targeting - user either matches or doesn't","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"binary","description":"Discriminator for binary signals"},"value":{"type":"boolean","description":"Whether to include (true) or exclude (false) users matching this signal"}},"required":["value_type","value"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true},{"type":"object","description":"Categorical signal targeting - target users with specific values","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"categorical","description":"Discriminator for categorical signals"},"values":{"type":"array","description":"Values to target. Users with any of these values will be included.","items":{"type":"string"},"minItems":1}},"required":["value_type","values"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true},{"type":"object","description":"Numeric signal targeting - target users within a value range. If min_value is provided, it must be <= max_value. Values should be within the signal's defined range (see signal definition).","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"numeric","description":"Discriminator for numeric signals"},"min_value":{"type":"number","description":"Minimum value (inclusive). Omit for no minimum. Must be <= max_value when both are provided. Should be >= signal's range.min if defined."},"max_value":{"type":"number","description":"Maximum value (inclusive). Omit for no maximum. Must be >= min_value when both are provided. Should be <= signal's range.max if defined."}},"required":["value_type"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true}]},"external:core/signal-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/signal-ref.json","title":"Signal Ref","description":"Reference to a named signal definition. Uses scope as discriminator: 'data_provider' for a signal resolved through published adagents.json signals[], 'signal_source' for a source-native signal resolved through the issuing signal source, or 'product' for a product-local signal option. Scope is the resolution path, not provenance; authoritative enrichment lives on the seller, signal source, or data-provider signal definition, not on this reference.","x-entity":"signal","discriminator":{"propertyName":"scope"},"oneOf":[{"type":"object","description":"Product-scoped signal. The signal_id is meaningful only within the selected product/package context and MUST match a Product.included_signals[].signal_ref.signal_id or Product.signal_targeting_options[].signal_ref.signal_id for that product, depending on whether the signal is descriptive or selectable.","properties":{"scope":{"type":"string","const":"product","description":"Discriminator indicating the signal resolves through the selected product's included_signals or signal_targeting_options."},"signal_id":{"type":"string","description":"Product-local signal identifier. For local signals exposed on both get_signals and get_products, this MUST match get_signals.signals[].signal_ref.signal_id for the same signal.","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","signal_id"],"not":{"anyOf":[{"required":["data_provider_domain"]},{"required":["signal_source_url"]},{"required":["agent_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true},{"type":"object","description":"Data-provider-scoped signal. The signal_id resolves through the data provider's published adagents.json signals[] and can be authorization-verified there.","properties":{"scope":{"type":"string","const":"data_provider","description":"Discriminator indicating the signal resolves through a data provider's published adagents.json signals[]."},"data_provider_domain":{"type":"string","description":"Domain that publishes the signal definition in its adagents.json signals[].","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"signal_id":{"type":"string","description":"Signal identifier within the data provider's published adagents.json signals[].","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","data_provider_domain","signal_id"],"not":{"anyOf":[{"required":["agent_url"]},{"required":["signal_source_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true},{"type":"object","description":"Signal-source-scoped signal. Use this for source-native signals that are not published in upstream adagents.json signals[]. The buyer trusts the issuing signal source for this identity; use scope 'data_provider' instead when the signal is published in adagents.json signals[], even if the publisher is also the seller or signal source.","properties":{"scope":{"type":"string","const":"signal_source","description":"Discriminator indicating the signal resolves through the issuing signal source."},"signal_source_url":{"type":"string","format":"uri","description":"URL of the signal source that issues this source-native signal."},"signal_id":{"type":"string","description":"Signal identifier within the issuing signal source's signal set.","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","signal_source_url","signal_id"],"not":{"anyOf":[{"required":["data_provider_domain"]},{"required":["agent_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true}]},"external:core/signal-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/signal-id.json","title":"Signal ID","description":"DEPRECATED. Use SignalRef for new discovery, activation, and media-buy signal identity surfaces. Legacy universal signal identifier used by older Signals Protocol clients. Uses 'source' as discriminator: 'catalog' for signals from a data provider's published catalog (verifiable), or 'agent' for signals native to a signal source identified by agent_url.","deprecated":true,"x-entity":"signal","discriminator":{"propertyName":"source"},"oneOf":[{"type":"object","description":"Data-provider signal - references a signal from a data provider's published adagents.json signals[]. Buyers can verify authorization by checking the data provider's adagents.json.","properties":{"source":{"type":"string","const":"catalog","description":"Discriminator indicating this signal is from a data provider's published adagents.json signals[]"},"data_provider_domain":{"type":"string","description":"Domain of the data provider that owns this signal (e.g., 'pinnacle-data.example'). The signal definition is published at this domain's /.well-known/adagents.json","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Signal identifier within the data provider's catalog (e.g., 'likely_ev_buyers', 'income_100k_plus')"}},"required":["source","data_provider_domain","id"],"additionalProperties":true},{"type":"object","description":"Agent signal - references a signal native to a signal source identified by agent_url. Not externally verifiable through an upstream catalog; buyer trusts the issuing signal source's claim about the signal.","properties":{"source":{"type":"string","const":"agent","description":"Discriminator indicating this signal is native to the signal source identified by agent_url, not from a data provider's published signal definitions."},"agent_url":{"type":"string","format":"uri","description":"URL of the signal source that provides this signal (e.g., 'https://signals.example/.well-known/adcp/signals')"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Signal identifier within the agent's signal set (e.g., 'custom_auto_intenders')"}},"required":["source","agent_url","id"],"additionalProperties":true}]},"external:core/postal-area.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/postal-area.json","title":"Postal Area","description":"Postal area values. Prefer the native country + postal system form. Deprecated legacy country-fused postal-system tokens remain accepted for compatibility.","anyOf":[{"title":"PostalArea","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-country-system.json"}],"properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code for the postal values."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1postal-system.json","description":"Country-local postal code system (e.g., 'zip', 'outward', 'plz', 'postal_code')."},"values":{"type":"array","description":"Postal codes within the country and system.","items":{"type":"string"},"minItems":1}},"required":["country","system","values"],"additionalProperties":false},{"title":"PostalAreaWithFusedSystem","deprecated":true,"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1legacy-postal-system.json","deprecated":true,"description":"Deprecated country-fused postal code system (e.g., 'us_zip', 'gb_outward'). Prefer country + postal-system."},"values":{"type":"array","description":"Postal codes within the legacy system.","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false}]},"external:enums/travel-time-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/travel-time-unit.json","title":"Travel Time Unit","description":"Time unit for isochrone (travel-time catchment) calculations.","type":"string","enum":["min","hr"],"enumDescriptions":{"min":"Minutes","hr":"Hours"}},"external:enums/transport-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/transport-mode.json","title":"Transport Mode","description":"Transportation modes for isochrone-based catchment area calculations. Determines how travel time translates to geographic reach.","type":"string","enum":["walking","cycling","driving","public_transport"],"enumDescriptions":{"walking":"Pedestrian travel on walkable paths and sidewalks","cycling":"Bicycle travel on roads and cycle paths","driving":"Motor vehicle travel on road networks","public_transport":"Public transit including bus, rail, metro, and ferry"}},"external:enums/distance-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/distance-unit.json","title":"Distance Unit","description":"Units of distance measurement for radius-based catchment areas.","type":"string","enum":["km","mi","m"],"enumDescriptions":{"km":"Kilometers","mi":"Miles","m":"Meters"}},"external:core/performance-standard.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/performance-standard.json","title":"Performance Standard","description":"A rate threshold for a performance metric, measured by a specified vendor. The threshold is a floor or ceiling depending on the metric: viewability, completion_rate, brand_safety, and attention_score are floors (must exceed); ivt is a ceiling (must not exceed).","type":"object","properties":{"metric":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1performance-standard-metric.json","description":"The performance metric this standard applies to."},"threshold":{"type":"number","minimum":0,"maximum":1,"description":"Rate threshold as a decimal (e.g., 0.70 for 70%). Whether this is a floor or ceiling depends on the metric: for viewability, completion_rate, brand_safety, attention_score the actual rate must be >= threshold; for ivt the actual rate must be <= threshold."},"standard":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1viewability-standard.json","description":"Measurement standard. Required when metric is 'viewability' (MRC and GroupM define materially different thresholds). Omit for other metrics."},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor measuring this metric (e.g., { domain: 'doubleverify.com' }). The vendor's brand.json agents array (type: 'measurement') is the discovery point for their measurement agent. When specified on a confirmed package, creatives MUST include tracker_script or tracker_pixel assets from this vendor."}},"required":["metric","threshold","vendor"],"additionalProperties":true},"external:enums/performance-standard-metric.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/performance-standard-metric.json","title":"Performance Standard Metric","description":"Performance metrics that support rate thresholds on media buys — the verification subset of the broader metric vocabulary. Each metric specifies whether its threshold is a floor (must exceed) or ceiling (must not exceed). Shared values with `available-metric.json` mirror the delivery vocabulary (`viewability` → `viewable_rate` family, `completion_rate` → same name); verification-only values (`ivt`, `brand_safety`, `attention_score`) are typically vendor-attested and do not appear in `available-metric.json` because they're not seller-reportable scalars — they flow through `vendor_metric_values` or vendor-scope `committed_metrics` entries with the matching `performance_standard.vendor` BrandRef anchoring identity.","type":"string","enum":["viewability","ivt","completion_rate","brand_safety","attention_score"],"enumDescriptions":{"viewability":"Viewable impression rate (floor — must exceed threshold). Requires viewability_standard. Denominator: measurable_impressions.","ivt":"Invalid Traffic rate (ceiling — must not exceed threshold). Denominator: total_impressions.","completion_rate":"Video or audio completion rate (floor — must exceed threshold). Denominator: total_impressions.","brand_safety":"Brand-safe impression rate (floor — must exceed threshold). Denominator: total_impressions.","attention_score":"Attention score rate (floor — must exceed threshold). Denominator: measurable_impressions."}},"external:enums/viewability-standard.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/viewability-standard.json","title":"Viewability Standard","description":"Viewability measurement standard applied to determine whether an impression qualifies as viewable. These are materially different thresholds and should not be compared across standards.","type":"string","enum":["mrc","groupm"],"enumDescriptions":{"mrc":"MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).","groupm":"GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."}},"external:enums/available-metric.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/available-metric.json","title":"Available Metric","description":"Standard delivery and performance metrics available for reporting. Most values name flat numeric fields of `core/delivery-metrics.json`. Leaf identities address a single numeric value nested inside an object-shaped metric so it can be declared, committed, aggregated, and sorted individually: `quartile_25`/`quartile_50`/`quartile_75`/`quartile_100` resolve to `quartile_data.q1_views`–`q4_views`, and `viewable_rate`/`viewable_impressions`/`measurable_impressions`/`viewed_seconds` resolve to the same-named fields of `viewability`. Structured nested identities `viewed_seconds_percentiles` and `viewed_seconds_histogram` make the corresponding optional distribution carriers discoverable, committable, and requestable, but not aggregatable or sortable. The nested object or array remains the canonical carrier — nested identities never introduce duplicate flat response fields. Container tokens such as `viewability`, `quartile_data`, `dooh_metrics`, and `time_based_views` declare their documented nested surface. **Container subsumption applies only to numeric leaves**: `viewability` subsumes `viewable_rate`, `viewable_impressions`, `measurable_impressions`, and `viewed_seconds`; `quartile_data` subsumes `quartile_25`, `quartile_50`, `quartile_75`, and `quartile_100`. This rule applies to capability declaration, `required_metrics` filtering, format `reported_metrics` intersection, and `requested_metrics` selection. Optional structured identities MUST be declared explicitly: `viewability` alone does not satisfy `viewed_seconds_percentiles` or `viewed_seconds_histogram`. Requesting any nested identity selects its canonical carrier in the response. A nested identity declaration does not imply sibling values or the carrier's non-metric fields.","type":"string","enum":["impressions","spend","clicks","ctr","views","completed_views","completion_rate","conversions","conversion_value","commissionable_value","roas","cost_per_acquisition","new_to_brand_rate","leads","reach","frequency","grps","engagements","engagement_rate","follows","saves","profile_visits","viewability","viewable_rate","viewable_impressions","measurable_impressions","viewed_seconds","viewed_seconds_percentiles","viewed_seconds_histogram","quartile_data","quartile_25","quartile_50","quartile_75","quartile_100","time_based_views","dooh_metrics","ooh_metrics","cost_per_click","cost_per_completed_view","cpm","downloads","units_sold","new_to_brand_units","plays","incremental_sales_lift","brand_lift","foot_traffic","conversion_lift","brand_search_lift"]},"external:core/vendor-metric-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/vendor-metric-id.json","title":"Vendor Metric ID","description":"Identifier for a vendor-defined metric within the vendor's vocabulary. Stable lookup key; the vendor publishes the canonical list (with category, methodology, and standard alignment) in `brand.json` `agents[type='measurement']`. Lowercase with underscores so a future enum promotion into `available-metric.json` is a literal string lift. Identifier is namespaced by the vendor — the same `metric_id` may mean different things in different vendors' vocabularies.","type":"string","x-entity":"vendor_metric","minLength":1,"maxLength":64,"pattern":"^[a-z][a-z0-9_]*$","examples":["attention_units","gco2e_per_impression","demographic_reach","co_view_index","incremental_lift_percent"]},"external:enums/match-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/match-type.json","title":"Match Type","description":"Keyword targeting match type. broad: ads may serve on queries semantically related to the keyword. phrase: ads serve when the query contains the keyword phrase. exact: ads serve only when the query matches the keyword exactly.","type":"string","enum":["broad","phrase","exact"],"enumDescriptions":{"broad":"Ads may serve on queries semantically related to the keyword","phrase":"Ads serve when the query contains the keyword phrase in order","exact":"Ads serve only when the query matches the keyword exactly"}},"external:core/audience-evidence-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/audience-evidence-requirements.json","title":"Audience Evidence Requirements","description":"Buyer-authored admissibility and ranking policy for product audience evidence. This reusable object attaches to get_products filters in 3.2, so the same semantics apply in brief, wholesale, and refine modes. It never requests exact audience targeting.","type":"object","properties":{"requirement_mode":{"type":"string","enum":["required","preferred"],"description":"required excludes products whose published evidence violates the constraints; preferred only affects ranking and explanation. When this policy affects inclusion or ranking, the seller MUST return the exact matching audience_evidence_selections even if get_products.fields omitted that field."},"evidence_presence":{"type":"string","enum":["required","when_available"],"description":"required applies the mode to evidence presence itself. when_available applies constraints only when a product publishes evidence: with requirement_mode required, a product with no evidence remains eligible but a product with evidence must have an admissible item; with preferred, presence and admissibility only affect ranking."},"accepted_methodologies":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audience-evidence-methodology.json"},"minItems":1,"uniqueItems":true,"description":"Allowed methodologies. excluded_methodologies always wins if a value appears in both lists."},"excluded_methodologies":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audience-evidence-methodology.json"},"minItems":1,"uniqueItems":true,"description":"Disallowed methodologies. Exclusion wins over accepted_methodologies when the lists overlap."},"accepted_evidence_types":{"type":"array","items":{"type":"string","enum":["measured","forecast","seller_declared"]},"minItems":1,"uniqueItems":true},"accepted_providers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json"},"minItems":1,"description":"Allowed evidence providers. excluded_providers always wins if the same canonical BrandRef appears in both lists."},"excluded_providers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json"},"minItems":1,"description":"Disallowed evidence providers. Exclusion wins over accepted_providers when the lists overlap."},"accepted_subject_types":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audience-subject-type.json"},"minItems":1,"uniqueItems":true},"accepted_resolution_methods":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1audience-resolution-method.json"},"minItems":1,"uniqueItems":true},"minimum_confidence":{"type":"number","minimum":0,"maximum":1},"maximum_age":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1duration.json"},{"properties":{"unit":{"enum":["seconds","minutes","hours","days"]}}}],"description":"Maximum age at evaluation time measured from last_updated. Campaign-relative duration is not valid for evidence age."},"methodology_documentation_required":{"type":"boolean","default":false,"description":"Whether an admissible item must carry methodology_url."},"independent_attestation_required":{"type":"boolean","default":false,"description":"Whether an admissible item must have at least one exact reference/evaluation pair whose outcome is verified, whose reference is published in the evidence, and whose claim type and issuer match the buyer's accepted lists as well as the seller's issuer and resolver policy. Setting true requires accepted_attestation_issuers."},"accepted_attestation_issuers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1attestation-issuer.json"},"minItems":1,"uniqueItems":true,"description":"Buyer allowlist for independent attestation issuers. An exact reference/evaluation pair satisfies the requirement only when reference.issuer matches an entry here. This list narrows and never broadens the seller's accepted issuer policy."},"accepted_attestation_claim_types":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1,"uniqueItems":true,"description":"Optional acceptable claim types when attestation is used. Buyer-supplied claim types further constrain but never broaden seller policy."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["requirement_mode","evidence_presence"],"allOf":[{"if":{"properties":{"independent_attestation_required":{"const":true}},"required":["independent_attestation_required"]},"then":{"required":["accepted_attestation_issuers"]}}],"additionalProperties":false},"external:enums/audience-evidence-methodology.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/audience-evidence-methodology.json","title":"Audience Evidence Methodology","description":"How a population-level audience-evidence estimate was produced. This vocabulary is intentionally separate from signal-definition methodology: `projected` describes expansion of a sample or panel to a reference population and does not become a user-level signal-membership method.","type":"string","enum":["observed","declared","derived","inferred","modeled","projected"]},"external:enums/audience-subject-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/audience-subject-type.json","title":"Audience Subject Type","description":"The kind of subject characterized by audience data or population-level evidence.","type":"string","enum":["individual","household","business","contextual","none"]},"external:enums/audience-resolution-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/audience-resolution-method.json","title":"Audience Resolution Method","description":"How subjects were resolved when producing a signal or population-level evidence estimate.","type":"string","enum":["deterministic_id","probabilistic_device","browser","geographic","content_signal","mixed"]},"external:core/duration.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/duration.json","title":"Duration","description":"A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.","type":"object","properties":{"interval":{"type":"integer","minimum":1,"description":"Number of time units. Must be 1 when unit is 'campaign'."},"unit":{"type":"string","enum":["seconds","minutes","hours","days","campaign"],"description":"Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."}},"required":["interval","unit"],"additionalProperties":false},"external:core/attestation-issuer.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/attestation-issuer.json","title":"Attestation Issuer","description":"Canonical identity of the party that issued an attestation credential. The discriminator selects an existing AdCP identity when one exists and falls back to an HTTPS origin for other attestors. This identity is a claim carried by the presentation; evaluators MUST match it against their configured trust policy and verify it from the resolved or embedded credential before relying on it.","discriminator":{"propertyName":"type"},"oneOf":[{"title":"AttestationBrandIssuer","type":"object","properties":{"type":{"type":"string","const":"brand","description":"The issuer is identified by an AdCP BrandRef."},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["type","brand"],"additionalProperties":false},{"title":"AttestationAgentIssuer","type":"object","properties":{"type":{"type":"string","const":"agent","description":"The issuer is an AdCP agent identified by its canonical HTTPS endpoint."},"agent_url":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$","description":"Canonical HTTPS endpoint of the issuing agent. Evaluators compare it using AdCP URL canonicalization rules."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["type","agent_url"],"additionalProperties":false},{"title":"AttestationOriginIssuer","type":"object","properties":{"type":{"type":"string","const":"origin","description":"The issuer is identified by a canonical HTTPS origin because no AdCP brand or agent identity applies."},"origin":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+$","description":"Canonical HTTPS origin with no path, query, fragment, or userinfo. This identifies the issuer; it does not authorize a fetch."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["type","origin"],"additionalProperties":false}],"examples":[{"type":"brand","brand":{"domain":"nova-brands.example","brand_id":"nova_motors"}},{"type":"agent","agent_url":"https://attestor.example/adcp"},{"type":"origin","origin":"https://credentials.example"}]},"external:core/targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/targeting.json","title":"Targeting Overlay","description":"Strict non-null targeting state used during product discovery, commercial snapshots, and media-buy readback. Targeting includes both audience eligibility and purchased-inventory selection: geography, demographics, placements, properties, collections, device compatibility, language, keywords, and other explicit controls. Sellers resolve requested outcomes against inherent product scope or selectable execution. Request-side create and update mutations use targeting-input.json so null can explicitly clear one dimension; resolved effective targeting omits cleared dimensions and MUST NOT contain null. A fresh create/update request MUST be applied exactly or rejected; get_products may instead return a request-scoped configured product with sparse, buyer-reviewable targeting_resolution modifications.","x-adcp-validation":{"disjoint_place_fields":{"include":"geo_places","exclude":"geo_places_exclude","identity":["country","system","place_type","value"]},"description":"JSON Schema draft-07 cannot compare values across sibling arrays. Conformance tooling MUST reject any place identity present in both geo_places and geo_places_exclude. Catalog version is deliberately not part of place identity: a stable ID cannot be both included and excluded by assigning different versions."},"type":"object","properties":{"geo_countries":{"type":"array","description":"Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"geo_countries_exclude":{"type":"array","description":"Exclude specific countries from delivery. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"geo_regions":{"type":"array","description":"Restrict delivery to exact canonical ISO 3166-2 subdivisions (states, provinces, regions, departments, or other subdivision categories). Unknown identifiers are invalid. At create or update, sellers MUST reject unsupported identifiers and MUST NOT silently widen, drop, or partially apply the list. During get_products, a seller may instead return a sparse, buyer-reviewable targeting_resolution modification for a valid but unsupported requested outcome. Exact internal translation preserves accepted identifiers in package readback.","items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1},"geo_regions_exclude":{"type":"array","description":"Exclude exact canonical ISO 3166-2 subdivisions. Support is independent from geo_regions inclusion support. Unknown identifiers and values also present in geo_regions are invalid. At create or update, sellers MUST reject unsupported identifiers and partial application; during get_products, a seller may instead return a sparse, buyer-reviewable targeting_resolution modification for a valid but unsupported requested outcome.","x-adcp-validation":{"disjoint_with":"geo_regions","spec":"docs/media-buy/advanced-topics/targeting.mdx#geo_regions_exclude"},"items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1},"geo_metros":{"title":"Targeting Geo Metros","type":"array","description":"Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-metro.json"},"minItems":1},"geo_metros_exclude":{"type":"array","description":"Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.","items":{"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json","description":"Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"},"values":{"type":"array","description":"Metro codes to exclude within the system (e.g., ['501', '602'] for Nielsen DMAs)","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false},"minItems":1},"geo_postal_areas":{"type":"array","description":"Restrict delivery to specific postal areas. Prefer the native country + postal system form. The deprecated legacy country-fused postal-system tokens remain accepted for compatibility. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_postal_areas_exclude":{"type":"array","description":"Exclude specific postal areas from delivery. Prefer the native country + postal system form. The deprecated legacy country-fused postal-system tokens remain accepted for compatibility. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_places":{"type":"array","description":"Restrict delivery to catalog-backed named places. Values MUST be stable identifiers in the declared system, not display names. Sellers must declare supported systems, countries, and place types in get_adcp_capabilities and reject unsupported entries rather than silently dropping them.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-area.json","x-adcp-schema-uri":"/schemas/core/geo-place-area.json"},"minItems":1},"geo_places_exclude":{"type":"array","description":"Exclude catalog-backed named places. Uses the same identifier-based shape as geo_places. Sellers MUST reject overlap with geo_places for the same country, system, place_type, and value.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-area.json","x-adcp-schema-uri":"/schemas/core/geo-place-area.json"},"minItems":1},"daypart_targets":{"type":"array","description":"Restrict delivery to specific time windows. Each entry specifies days of week, an hour range, and an optional timezone that defaults to inventory_local. A concrete IANA zone uses one shared civil-time clock, while inventory_local evaluates each inventory unit in its seller-assigned local timezone. Entries are independent and MAY use different clocks.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1daypart-target.json"},"minItems":1},"axe_include_segment":{"type":"string","description":"Deprecated: Use TMP provider fields instead. AXE segment ID to include for targeting.","deprecated":true},"axe_exclude_segment":{"type":"string","description":"Deprecated: Use TMP provider fields instead. AXE segment ID to exclude from targeting.","deprecated":true},"audience_include":{"type":"array","description":"Restrict delivery to members of these first-party CRM audiences. Only users present in the uploaded lists are eligible. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Not for lookalike expansion — express that intent in the campaign brief. Seller must declare support in get_adcp_capabilities.","items":{"type":"string"},"minItems":1},"audience_exclude":{"type":"array","description":"Suppress delivery to members of these first-party CRM audiences. Matched users are excluded regardless of other targeting. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Seller must declare support in get_adcp_capabilities.","items":{"type":"string"},"minItems":1},"signal_targeting_groups":{"title":"Targeting Signal Groups","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1package-signal-targeting-groups.json","description":"Basic Boolean grouping for seller-offered signals. v1 supports a required top-level operator 'all' and child groups with operator 'any' for include groups or 'none' for exclusion groups. Example semantics: group 1 any(A, B) plus group 2 none(C, D) means (A OR B) AND NOT (C OR D). Signal entries reference named signal definitions with signal_ref scope 'product' for product-local signal options or scope 'data_provider' for external signals published in adagents.json signals[]. For simple include-only targeting, send one child group with operator 'any'. Sellers SHOULD reject entries that are not available for the product through inline signal_targeting_options or get_signals, are not active for the account, or exceed the product's signal_targeting_allowed/signal_targeting_rules/product terms. Signal targeting limits are product-scoped, not declared in get_adcp_capabilities, because products may be backed by different ad servers. Sellers MUST echo applied signal_targeting_groups on the resulting package state, including fixed/default selections. Sellers MAY return REQUOTE_REQUIRED when a targeting mutation changes commercial terms."},"signal_targeting":{"type":"array","description":"DEPRECATED. Use signal_targeting_groups for package-level signal targeting. Legacy flat signal_targeting remains accepted during the SignalRef migration window but cannot express grouped include/exclude composition or product-scoped pricing.","deprecated":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-targeting.json"},"minItems":1},"demographics":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1demographic-targeting-intent.json","description":"Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis."},"frequency_cap":{"title":"Targeting Frequency Cap","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap.json"},"property_list":{"title":"Targeting Property List","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false."},"property_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list whose properties must not carry the buyer's ads. Matched properties are removed from delivery. Use for brand-safety do-not-run lists (apps, sites). Exclude wins on overlap with property_list, and applies regardless of the product's property_targeting_allowed flag. Seller must declare support in get_adcp_capabilities."},"collection_list":{"title":"Targeting Collection List","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for including specific collections (programs, publications, channels) within this product. The package runs on the intersection of matched collections and this list. Use for inclusion-based collection targeting. Seller must declare support in get_adcp_capabilities."},"collection_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for excluding specific collections (programs, publications, channels) from this product. Matched collections must not carry the buyer's ads. Use for brand safety do-not-air lists. Seller must declare support in get_adcp_capabilities."},"placement_selection":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1placement-selection.json","description":"Purchased placement selection within the product. This constrains package inventory; it is distinct from creative_assignments[].placement_refs, which only route individual creatives within the purchased set. On create, mode selected supplies the complete selected set and mode default uses the product default. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},"collection_selection":{"title":"Targeting Collection Selection","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1collection-selection.json","description":"Purchased collection selection within the product. On create, mode selected supplies the complete selected set and mode default uses the product's full bundle. On package readback this is the committed selection sellers MUST echo as concrete selectors, materializing any collection_list composition; collection_list fields remain the buyer-managed list mechanism. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},"age_restriction":{"type":"object","description":"Age restriction for compliance. Use for legal requirements (alcohol, gambling), not audience targeting.","properties":{"min":{"type":"integer","minimum":13,"maximum":99,"description":"Minimum age required"},"verification_required":{"type":"boolean","default":false,"description":"Whether verified age (not inferred) is required for compliance"},"accepted_methods":{"type":"array","description":"Accepted verification methods. If omitted, any method the platform supports is acceptable.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1age-verification-method.json"},"minItems":1}},"required":["min"],"additionalProperties":false},"device_platform":{"type":"array","description":"Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1device-platform.json"},"minItems":1},"device_platform_exclude":{"type":"array","description":"Exclude specific operating-system platforms from delivery. When a platform appears in both device_platform and device_platform_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1device-platform.json"},"minItems":1},"device_type":{"type":"array","description":"Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1device-type.json"},"minItems":1},"device_type_exclude":{"type":"array","description":"Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1device-type.json"},"minItems":1},"browser":{"type":"array","description":"Restrict delivery to specific canonical browser families in the impression delivery and rendering environment, not the post-click landing-page browser. Values MUST NOT be inferred solely from operating system, device, web/mobile-web inventory, or placement. Values in this array use OR semantics. When browser is supplied, families not listed are ineligible: other includes a seller-recognized family that is not explicitly enumerated, while unknown includes a browser the seller cannot classify into a recognized family. When the same family appears in browser and browser_exclude, exclusion wins. Browser and device constraints intersect; a seller that cannot enforce the exact combination MUST exclude or explicitly reconfigure the product during discovery and MUST reject it at create or update rather than silently widening delivery. Browser versions and seller-native IDs are intentionally unsupported.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true},"browser_exclude":{"type":"array","description":"Exclude specific canonical browser families from delivery. other excludes seller-recognized families that are not explicitly enumerated; unknown excludes browsers the seller cannot classify into a recognized family. When the same family appears in browser and browser_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true},"store_catchments":{"type":"array","description":"Target users within store catchment areas from a synced store catalog. Each entry references a store-type catalog and optionally narrows to specific stores or catchment zones.","items":{"type":"object","properties":{"catalog_id":{"type":"string","description":"Synced store-type catalog ID from sync_catalogs."},"store_ids":{"type":"array","description":"Filter to specific stores within the catalog. Omit to target all stores.","items":{"type":"string"},"minItems":1},"catchment_ids":{"type":"array","description":"Catchment zone IDs to target (e.g., 'walk', 'drive'). Omit to target all catchment zones.","items":{"type":"string"},"minItems":1}},"required":["catalog_id"],"additionalProperties":true},"minItems":1},"geo_proximity":{"type":"array","description":"Target users within travel time, distance, or a custom boundary around arbitrary geographic points. Multiple entries use OR semantics — a user within range of any listed point is eligible. For campaigns targeting 10+ locations, consider using store_catchments with a location catalog instead. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees (WGS 84). Required for travel_time and radius methods."},"lng":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees (WGS 84). Required for travel_time and radius methods."},"label":{"type":"string","description":"Human-readable label for this entry (e.g., 'Düsseldorf', 'Heathrow Airport', 'Primary trade area')."},"travel_time":{"type":"object","description":"Travel time limit for isochrone calculation. The platform resolves this to a geographic boundary based on actual transportation networks.","properties":{"value":{"type":"number","minimum":1,"description":"Travel time limit."},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1travel-time-unit.json"}},"required":["value","unit"],"additionalProperties":false},"transport_mode":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1transport-mode.json","description":"Transportation mode for isochrone calculation. Required when travel_time is provided."},"radius":{"type":"object","description":"Simple radius from the point. The platform draws a circle of this distance around the coordinates.","properties":{"value":{"type":"number","exclusiveMinimum":0,"description":"Radius distance."},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1distance-unit.json","description":"Distance unit."}},"required":["value","unit"],"additionalProperties":false},"geometry":{"type":"object","description":"Pre-computed GeoJSON geometry defining the proximity boundary. Use when the buyer has already calculated isochrones (via TravelTime, Mapbox, etc.) or has custom boundaries. When geometry is provided, lat/lng are not required.","properties":{"type":{"type":"string","enum":["Polygon","MultiPolygon"],"description":"GeoJSON geometry type."},"coordinates":{"type":"array","description":"GeoJSON coordinates array. For Polygon: array of linear rings. For MultiPolygon: array of polygons."}},"required":["type","coordinates"],"additionalProperties":false},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"oneOf":[{"required":["lat","lng","travel_time","transport_mode"],"not":{"anyOf":[{"required":["radius"]},{"required":["geometry"]}]}},{"required":["lat","lng","radius"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["geometry"]}]}},{"required":["geometry"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["radius"]}]}}],"additionalProperties":true},"minItems":1},"language":{"title":"Targeting Languages","type":"array","description":"Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1locale-tag.json"},"minItems":1},"keyword_targets":{"title":"Targeting Keywords","type":"array","description":"Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to target"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1match-type.json"},"bid_price":{"type":"number","minimum":0,"description":"Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies."}},"required":["keyword","match_type"],"additionalProperties":false},"minItems":1},"negative_keywords":{"title":"Targeting Negative Keywords","type":"array","description":"Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1negative-keyword.json"},"minItems":1}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-unknown-age-eligibility-constraint.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-verified-age-basis-constraint.json"}],"additionalProperties":true},"external:core/geo-metro.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-metro.json","title":"Geo Metro","description":"A targeted metro area.","type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json","description":"Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"},"values":{"type":"array","description":"Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false},"external:core/geo-place-area.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-place-area.json","title":"Geographic Place Area","description":"A catalog-backed named place target. Values are stable identifiers in the declared system. Entries within geo_places form a union; different geographic inclusion dimensions intersect. value_labels are diagnostic only and MUST NOT be used to resolve targeting.","x-adcp-validation":{"map_keys_subset_of_array":{"map_field":"value_labels","array_field":"values"},"description":"Every value_labels key MUST also appear in values. JSON Schema draft-07 cannot express this sibling-field key membership constraint, so conformance tooling must enforce it."},"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code containing the place."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-system.json"},"system_version":{"type":"string","minLength":1,"description":"Optional exact catalog version from the seller's declared supported_versions. When omitted, the seller applies catalog.current_version and MUST echo that version on persisted package state."},"place_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-type.json"},"values":{"type":"array","description":"Stable place identifiers in the declared system. Display names are not valid targeting values.","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true},"value_labels":{"type":"object","description":"Optional human-readable diagnostic labels keyed by identifiers present in values. Extra keys are a conformance error. Labels are non-authoritative and MUST NOT be used to resolve or apply targeting.","additionalProperties":{"type":"string","minLength":1}},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["country","system","place_type","values"],"allOf":[{"if":{"properties":{"system":{"enum":["geonames","google_ads","microsoft_ads"]}},"required":["system"]},"then":{"properties":{"values":{"items":{"type":"string","pattern":"^[0-9]+$"}}}}}],"additionalProperties":false},"external:core/geo-place-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-place-system.json","title":"Geographic Place Identifier System","description":"Collision-safe identifier namespace for geographic places. Registered tokens have protocol-defined semantics. Unregistered systems MUST use an absolute HTTPS URI controlled by the catalog owner; consumers compare URI systems as exact opaque strings.","anyOf":[{"type":"string","enum":["geonames","google_ads","microsoft_ads"]},{"type":"string","format":"uri","pattern":"^https://"}],"examples":["geonames","google_ads","microsoft_ads","https://seller.example/geo/catalogs/places"]},"external:core/geo-place-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-place-type.json","title":"Geographic Place Type","description":"Canonical place classification. Registered tokens have protocol-defined meanings. Catalog-specific classifications without a registered mapping MUST use an absolute HTTPS URI controlled by the vocabulary owner; consumers compare URI types as exact opaque strings.","anyOf":[{"type":"string","enum":["airport","borough","city","city_region","commune","county","district","municipality","neighborhood","post_town","prefecture","province","quarter","state","territory","ward"]},{"type":"string","format":"uri","pattern":"^https://"}],"examples":["city","municipality","borough","neighborhood","post_town","city_region","county","https://seller.example/geo/place-types/trade-area"]},"external:core/daypart-target.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/daypart-target.json","title":"Daypart Target","description":"A time window for daypart targeting. Specifies days of week, an hour range, and the civil-time clock used to evaluate it. start_hour is inclusive, end_hour is exclusive (e.g., 6-10 = 6:00am to 10:00am). Follows the Google Ads AdScheduleInfo / DV360 DayPartTargeting pattern.","type":"object","properties":{"days":{"type":"array","description":"Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1day-of-week.json"},"minItems":1},"start_hour":{"type":"integer","description":"Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm.","minimum":0,"maximum":23},"end_hour":{"type":"integer","description":"End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour.","minimum":1,"maximum":24},"timezone":{"description":"Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and hour with the half-open window: a skipped DST hour has no matching instants, while both occurrences of a repeated hour match. This delivery clock is independent of reporting_capabilities.timezone.","default":"inventory_local","x-added-in":"3.2.0","anyOf":[{"type":"string","const":"inventory_local"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1iana-timezone.json"}]},"label":{"type":"string","description":"Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')"}},"required":["days","start_hour","end_hour"],"additionalProperties":false},"external:enums/day-of-week.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/day-of-week.json","title":"Day of Week","description":"Days of the week for daypart targeting","type":"string","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"external:core/iana-timezone.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/iana-timezone.json","title":"IANA Timezone Identifier","description":"Concrete timezone identifier in the implementation's supported IANA Time Zone Database, such as America/New_York, CET, or UTC.","type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._+-]+(?:/[A-Za-z0-9._+-]+)*$","not":{"const":"inventory_local"},"x-added-in":"3.2.0","x-adcp-validation":{"iana_timezone":"value_must_resolve_in_the_implementations_supported_IANA_TZDB"}},"external:core/package-signal-targeting-groups.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/package-signal-targeting-groups.json","title":"Package Signal Targeting Groups","description":"Top-level basic Boolean composition for package signal targeting. The groups-level operator is required; v1 supports operator 'all', meaning every child group must be satisfied. This represents the portable baseline: (any of include group 1) AND (any of include group 2) AND NOT (any of exclude group N).","type":"object","properties":{"operator":{"type":"string","enum":["all"],"description":"Groups-level operator. Required even though v1 only supports 'all': every child group must be satisfied."},"groups":{"type":"array","description":"Signal targeting groups to evaluate. Use operator 'any' for include groups and 'none' for exclusion groups.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1package-signal-targeting-group.json"},"minItems":1}},"required":["operator","groups"],"additionalProperties":true},"external:core/package-signal-targeting-group.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/package-signal-targeting-group.json","title":"Package Signal Targeting Group","description":"A basic Boolean group of package-level signal targeting entries. 'any' means the user must match at least one signal in the group. 'none' means the user must match none of the signals in the group. Use groups for portable include/exclude composition such as (A OR B) AND NOT (C OR D).","type":"object","properties":{"operator":{"type":"string","description":"How to evaluate the signals in this group. 'any' is an OR include group. 'none' is an exclusion group equivalent to NOT (A OR B OR C).","enum":["any","none"]},"signals":{"type":"array","description":"Signal targeting entries evaluated by this group. Each entry uses the package signal targeting shape, including signal_ref, value expression, and optional pricing, execution-handle, or activation fields.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1package-signal-targeting.json"},"minItems":1}},"required":["operator","signals"],"additionalProperties":true},"external:core/package-signal-targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/package-signal-targeting.json","title":"Package Signal Targeting","description":"Buy-time selection of one seller-offered signal inside a package signal targeting group. The signal_ref uses scope 'product' for a product-local signal option, scope 'data_provider' for a signal defined in a data provider's published adagents.json signals[], or scope 'signal_source' for a source-native signal that is not published in adagents.json signals[]. The selected product's inline Product.signal_targeting_options, get_signals feed when inline options are omitted, and signal_targeting_rules define buy-time eligibility. Inclusion and exclusion are controlled by the parent group operator: use operator 'any' to include users matching the signal expression and operator 'none' to exclude users matching the signal expression. For binary signals, value MUST be true; do not use value=false for exclusion inside signal_targeting_groups. Use audience_include/audience_exclude only for buyer-managed first-party audiences registered through sync_audiences.","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-targeting-expression.json"}],"properties":{"pricing_option_id":{"type":"string","description":"Pricing option selected for this signal. Use the pricing_option_id from the product's signal_targeting_options entry when product-scoped pricing is present; otherwise use the seller get_signals pricing only when the product option does not override it. Required when the selected signal has pricing_options; omit only when the signal is bundled into the product price or has no incremental cost.","x-entity":"vendor_pricing_option"},"signal_agent_segment_id":{"type":"string","description":"Optional opaque resolved-segment or seller execution handle for this signal. Omit when signal_ref plus the value expression is sufficient for the seller to resolve the signal. Include when the product option exposes a separate runtime or activation handle, and pass it verbatim. Buyers SHOULD prefer an exposed segment handle over reconstructing condition identity from categorical values because the handle can carry provider namespace and methodology distinctions.","x-entity":"signal_activation_id"},"activation_key":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1activation-key.json","description":"Destination-specific activation key returned by get_signals or activate_signal. Usually omitted for seller-offered signals selected directly through the same seller; include only when the selected signal was separately activated and the seller requires the activation key to correlate the package selection."}},"additionalProperties":true},"external:core/signal-targeting-expression.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/signal-targeting-expression.json","title":"Signal Targeting Expression","description":"Predicate over a named signal definition. Signals are typed dimensions, similar to feature values: binary signals match true, categorical signals match one of a set of values, and numeric signals match a range. In package signal targeting groups, include/exclude semantics are controlled by the parent group operator, not by negating the expression.","discriminator":{"propertyName":"value_type"},"oneOf":[{"type":"object","description":"Binary signal expression. In grouped package targeting, value is always true; use a parent group with operator 'none' for exclusion.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"binary","description":"Discriminator for binary signals."},"value":{"type":"boolean","const":true,"description":"Binary package signal entries match users for whom the signal is true. Use the parent group operator for include/exclude."}},"required":["signal_ref","value_type","value"],"additionalProperties":true},{"type":"object","description":"Categorical signal expression - target users with one of the listed values.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"categorical","description":"Discriminator for categorical signals."},"values":{"type":"array","description":"Values to target. Users with any of these values match the expression.","items":{"type":"string"},"minItems":1}},"required":["signal_ref","value_type","values"],"additionalProperties":true},{"type":"object","description":"Numeric signal expression - target users within a value range. At least one of min_value or max_value is required. If both min_value and max_value are provided, min_value MUST be <= max_value.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"numeric","description":"Discriminator for numeric signals."},"min_value":{"type":"number","description":"Minimum value, inclusive. Omit for no minimum. Should be within the signal definition's range when declared."},"max_value":{"type":"number","description":"Maximum value, inclusive. Omit for no maximum. Should be within the signal definition's range when declared."}},"required":["signal_ref","value_type"],"anyOf":[{"required":["min_value"]},{"required":["max_value"]}],"additionalProperties":true}]},"external:core/activation-key.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/activation-key.json","title":"Activation Key","description":"Universal identifier for using a signal on a destination platform. Can be either a segment ID or a key-value pair depending on the platform's targeting mechanism.","type":"object","discriminator":{"propertyName":"type"},"oneOf":[{"properties":{"type":{"type":"string","const":"segment_id","description":"Segment ID based targeting"},"segment_id":{"type":"string","description":"The platform-specific segment identifier to use in campaign targeting"}},"required":["type","segment_id"],"additionalProperties":true},{"properties":{"type":{"type":"string","const":"key_value","description":"Key-value pair based targeting"},"key":{"type":"string","description":"The targeting parameter key"},"value":{"type":"string","description":"The targeting parameter value"}},"required":["type","key","value"],"additionalProperties":true}]},"external:core/demographic-targeting-intent.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/demographic-targeting-intent.json","title":"Demographic Targeting Intent","description":"Portable demographic targeting intent plus buyer constraints on how the seller may determine user eligibility. The age predicate retains its canonical interval meaning; accepted_bases narrows execution provenance without changing which ages are requested.","type":"object","properties":{"age":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1demographic-age-range.json"},{"type":"object","properties":{"accepted_bases":{"type":"array","description":"User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1age-determination-basis.json"},"minItems":1,"uniqueItems":true},"accepted_verification_methods":{"type":"array","description":"Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1age-verification-method.json"},"minItems":1,"uniqueItems":true}},"allOf":[{"if":{"required":["accepted_verification_methods"]},"then":{"required":["accepted_bases"],"properties":{"accepted_bases":{"contains":{"const":"verified"}}}}}],"additionalProperties":true}]}},"required":["age"],"additionalProperties":true},"external:core/demographic-age-range.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/demographic-age-range.json","title":"Demographic Age Range","description":"A canonical audience-age predicate in completed integer years. min and max are inclusive; omitting one bound means no restriction in that direction. At least one bound is required. include_unknown is always explicit because people whose age is unavailable are not members of any numeric interval. Implementations MUST reject min greater than max; JSON Schema draft-07 cannot compare sibling numeric values.","type":"object","properties":{"min":{"type":"integer","minimum":0,"maximum":150,"description":"Inclusive minimum age in completed years. Omit for an open lower bound."},"max":{"type":"integer","minimum":0,"maximum":150,"description":"Inclusive maximum age in completed years. Omit for an open upper bound."},"include_unknown":{"type":"boolean","description":"Whether delivery to people whose age is unavailable is part of this predicate. This field has no default and MUST be supplied."}},"required":["include_unknown"],"anyOf":[{"required":["min"]},{"required":["max"]}],"additionalProperties":true},"external:enums/age-determination-basis.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/age-determination-basis.json","title":"Age Determination Basis","description":"User-level bases that may resolve age for demographic targeting execution. Population estimates are deliberately absent because aggregate composition cannot establish an individual impression's age.","type":"string","enum":["verified","declared","inferred"],"enumDescriptions":{"verified":"The user's applicable age claim was established through an age-assurance or identity-verification method.","declared":"The user supplied an age, date of birth, or threshold affirmation without independent verification.","inferred":"The user's age was predicted from behavior, attributes, or another model."}},"external:enums/age-verification-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/age-verification-method.json","title":"Age Verification Method","description":"Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.","type":"string","enum":["facial_age_estimation","id_document","digital_id","credit_card","world_id"]},"external:core/frequency-cap.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/frequency-cap.json","title":"Frequency Cap","description":"Frequency capping settings for package-level application. Two types of frequency control can be used independently or together: suppress enforces a cooldown between consecutive exposures; max_impressions + per + window caps total exposures per entity in a time window. When both suppress and max_impressions are set, an impression is delivered only if both constraints permit it (AND semantics). At least one of suppress, suppress_minutes, or max_impressions must be set. Field location determines scope; this value has no scope discriminator. The MediaBuy root uses the narrower media-buy-frequency-cap schema, which permits maximum impressions only in 3.2.","type":"object","properties":{"suppress":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1duration.json"}],"description":"Cooldown period between consecutive exposures to the same entity. Prevents back-to-back ad delivery (e.g. {\"interval\": 60, \"unit\": \"minutes\"} for a 1-hour cooldown). Preferred over suppress_minutes."},"suppress_minutes":{"type":"number","deprecated":true,"description":"Deprecated — use suppress instead. Cooldown period in minutes between consecutive exposures to the same entity (e.g. 60 for a 1-hour cooldown).","minimum":0},"max_impressions":{"type":"integer","description":"Maximum number of impressions per entity per window. For duration windows, implementations typically use a rolling window. campaign applies across the owning field's full flight: the package flight for a targeting overlay, or the MediaBuy flight for a root cap.","minimum":1},"per":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1reach-unit.json"}],"description":"Entity granularity for impression counting. Required when max_impressions is set."},"window":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1duration.json"}],"description":"Time window for the max_impressions cap (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Required when max_impressions is set."}},"anyOf":[{"required":["suppress"]},{"required":["suppress_minutes"]},{"required":["max_impressions"]}],"additionalProperties":true,"dependentRequired":{"max_impressions":["per","window"],"per":["max_impressions"],"window":["max_impressions"]}},"external:enums/reach-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/reach-unit.json","title":"Reach Unit","description":"Unit of measurement for reach and audience size metrics. Different channels and measurement providers count reach in fundamentally different units, making cross-channel comparison impossible without declaring the unit.","type":"string","enum":["individuals","households","devices","accounts","cookies","custom"],"enumDescriptions":{"individuals":"Unique people. Panel-based or identity-resolved measurement.","households":"Unique households or TV homes.","devices":"Unique device identifiers (IDFA, GAID, CTV device ID).","accounts":"Unique logged-in accounts (platform-specific identity).","cookies":"Unique browser cookies.","custom":"Seller-defined reach unit. Describe in ext. For a Product.identity declaration with persistent_identifier false, describe the unit in Product.identity.reach_methodology."}},"external:core/property-list-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/property-list-ref.json","title":"Property List Reference","description":"Reference to an externally managed property list. Enables passing large property sets (50,000+) without embedding them in requests. The receiving agent fetches and caches the list independently.","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent managing the property list"},"list_id":{"type":"string","description":"Identifier for the property list within the agent","minLength":1,"x-entity":"property_list"},"auth_token":{"type":"string","description":"JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."}},"required":["agent_url","list_id"],"additionalProperties":false},"external:core/collection-list-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/collection-list-ref.json","title":"Collection List Reference","description":"Reference to an externally managed collection list. Enables passing large collection exclusion/inclusion sets without embedding them in requests. The receiving agent fetches and caches the list independently.","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent managing the collection list"},"list_id":{"type":"string","description":"Identifier for the collection list within the agent","minLength":1,"x-entity":"collection_list"},"auth_token":{"type":"string","description":"JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."}},"required":["agent_url","list_id"],"additionalProperties":false},"external:core/placement-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/placement-selection.json","title":"Placement Selection","description":"Complete purchased placement set within a product. This is inventory targeting, not creative routing: creative_assignments[].placement_refs route a creative only within this purchased set. Requests use mode selected to name the complete required set or mode default to accept the product/seller default. Across discovery, create, and update, a selected set is satisfied inherently when it exactly equals a fixed product's complete included placement set; this exact restatement does not require overlay_support.placement_selection, while partial selection does. Included placements are never independently selectable. Products with any fixed mode:included placement cannot advertise selectable placement overlay support because the fixed placement would make a partial buyer-selected set incomplete; sellers expose separately selectable inventory when needed. Successful package readback MUST echo the committed selected set. Sellers reject unknown, duplicate, cross-publisher, incompatible, or partially applicable refs rather than silently changing the selection.","type":"object","discriminator":{"propertyName":"mode"},"oneOf":[{"title":"Selected placements","type":"object","properties":{"mode":{"type":"string","const":"selected"},"placement_refs":{"type":"array","description":"Complete required placement set. A reference normally identifies a mode targetable placement. It MAY identify a mode included placement only when the set exactly equals the product's complete fixed included set, which is an inherent match rather than independent selection. Legacy publisher refs use {publisher_domain, placement_id}; authority-discriminated 3.2 identities use placement-identity.json so seller-inline inventory is selected by {seller_agent, placement_id}. An item that exactly matches placement-identity uses that canonical identity; otherwise a released-compatible item with publisher_domain and placement_id uses legacy product-context matching, and tolerated product metadata such as kind, name, or mode has no selection effect.","items":{"anyOf":[{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1placement-ref.json"},{"required":["publisher_domain"]}]},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1placement-identity.json"}]},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["mode","placement_refs"],"additionalProperties":false},{"title":"Product default placements","type":"object","properties":{"mode":{"type":"string","const":"default"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["mode"],"additionalProperties":false}]},"external:core/placement-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/placement-ref.json","title":"Placement Reference","description":"Legacy-compatible product-context reference to a placement. For publisher-catalog placements, publisher_domain plus placement_id resolves the declaration in that publisher's adagents.json. For seller-inline placements, the enclosing seller and product supply scope. When publisher_domain is omitted on legacy inputs, receivers MAY interpret the ID relative to the enclosing single-publisher product. Use placement-identity.json when a self-contained cross-document identity is required.","type":"object","properties":{"publisher_domain":{"type":"string","description":"Domain where the adagents.json declaring a publisher-catalog placement is hosted, or the inventory publisher associated with an inline placement. Omitted only for legacy single-publisher product-context references.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"placement_id":{"type":"string","description":"Placement ID from the publisher's adagents.json placement catalog, or an inline seller-defined placement ID interpreted within the enclosing seller and product context.","x-entity":"placement"}},"required":["placement_id"],"additionalProperties":true},"external:core/placement-identity.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/placement-identity.json","title":"Placement Identity","description":"Self-contained identity for either a publisher-catalog placement or a sales-agent-defined inline placement. The discriminator names which authority owns placement_id.","oneOf":[{"title":"Publisher catalog placement identity","type":"object","properties":{"kind":{"type":"string","const":"publisher_ref"},"publisher_domain":{"type":"string","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","description":"Domain whose adagents.json declares placement_id."},"placement_id":{"type":"string","minLength":1,"x-entity":"placement"}},"required":["kind","publisher_domain","placement_id"],"additionalProperties":false},{"title":"Seller inline placement identity","type":"object","properties":{"kind":{"type":"string","const":"seller_inline"},"seller_agent":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1seller-agent-ref.json","description":"Sales agent that defines and maintains the inline placement namespace."},"placement_id":{"type":"string","minLength":1,"description":"Stable placement ID within the defining sales agent's namespace. The agent MUST NOT reuse it for a different semantic placement.","x-entity":"placement"}},"required":["kind","seller_agent","placement_id"],"additionalProperties":false}]},"external:core/seller-agent-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/seller-agent-ref.json","title":"Seller Agent Reference","description":"Structured reference to a seller agent. The canonical identifier is the agent's URL as declared in the property publisher's adagents.json `authorized_agents[].url`. The optional `id` slot is reserved for a future registry-assigned stable identifier; it is not used today. This shape mirrors `format-id` and `ProviderEntry` — URL-first, with an ID slot for forward compatibility.","x-status":"experimental","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"The seller agent's API endpoint URL as declared in the property publisher's adagents.json `authorized_agents[].url`. MUST use the `https://` scheme. Receivers compare this URL against the `authorized_agents` list using the AdCP URL canonicalization rules — not byte-equality — and reject mismatches with `seller_not_authorized`. See docs/reference/url-canonicalization."},"id":{"type":"string","description":"Reserved for a future registry-assigned stable seller identifier. Not used today — senders MUST NOT populate this field until a registry is defined. When a future release populates both `agent_url` and `id`, `agent_url` remains authoritative and `id` is advisory.","pattern":"^[a-zA-Z0-9_-]+$","minLength":1}},"required":["agent_url"],"additionalProperties":false,"examples":[{"agent_url":"https://agent.acme.example"}]},"external:core/collection-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/collection-selection.json","title":"Collection Selection","description":"Complete purchased collection set within a product. Mode selected names the complete required set (partial selection requires product collection_targeting_allowed: true; exactly restating the full bundle is an inherent match); mode default accepts the product's full bundle. Package readback MUST echo the committed selection here as concrete selectors, materializing any collection_list composition; a purchase made with mode default therefore reads back as mode selected naming the product's complete bundle. Rejection of a schema-valid selector that references an unknown collection_id or publisher_domain uses REFERENCE_NOT_FOUND per the error-code registry (INVALID_REQUEST applies only to schema-invalid shapes such as a selected-mode item omitting collection_ids). Sellers reject unknown, duplicate, or partially applicable selectors rather than silently changing the selection.","type":"object","discriminator":{"propertyName":"mode"},"oneOf":[{"title":"Selected collections","type":"object","properties":{"mode":{"type":"string","const":"selected"},"collections":{"type":"array","description":"Complete required collection set as domain-qualified selectors with explicit collection_ids; the domain-only bulk-grant form is authorization scoping, not selection. publisher_domain may be an external channel owner's domain.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1collection-selector.json"},{"required":["collection_ids"]}]},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["mode","collections"],"additionalProperties":false},{"title":"Product default collections","type":"object","properties":{"mode":{"type":"string","const":"default"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"required":["mode"],"additionalProperties":false}]},"external:core/collection-selector.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/collection-selector.json","title":"Collection Selector","description":"References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json — the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).","type":"object","properties":{"publisher_domain":{"type":"string","description":"Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"collection_ids":{"type":"array","description":"Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.","items":{"type":"string","x-entity":"collection"},"minItems":1}},"required":["publisher_domain"],"additionalProperties":true},"external:enums/device-platform.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/device-platform.json","title":"Device Platform","description":"Operating system platforms for device targeting. Browser values from Sec-CH-UA-Platform standard, extended for CTV.","type":"string","enum":["ios","android","windows","macos","linux","chromeos","tvos","tizen","webos","fire_os","roku_os","unknown"]},"external:enums/device-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/device-type.json","title":"Device Type","description":"Device form factor categories for targeting and reporting. Complements device-platform (operating system) with hardware classification. OpenRTB mapping: 1 (Mobile/Tablet General) → mobile, 2 (PC) → desktop, 4 (Phone) → mobile, 5 (Tablet) → tablet, 6 (Connected Device) → ctv, 7 (Set Top Box) → ctv. DOOH inventory uses dooh.","type":"string","enum":["desktop","mobile","tablet","ctv","dooh","unknown"]},"external:enums/browser-family.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/browser-family.json","title":"Browser Family","description":"Portable browser families for targeting the impression delivery and rendering environment, not a post-click landing-page browser. Values identify browser families, not versions or seller-native browser IDs, and MUST NOT be inferred solely from operating system, device, web/mobile-web inventory, or placement. android_webview means an impression reliably classified as rendering in Android WebView. other means a seller-recognized browser family that is not explicitly enumerated; unknown means the seller cannot classify the browser into a recognized family.","type":"string","enum":["chrome","safari","firefox","edge","opera","samsung_internet","android_webview","other","unknown"]},"external:core/locale-tag.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/locale-tag.json","title":"Language Tag","description":"A well-formed BCP 47 language tag used by AdCP only as language identity. Script and region may refine that identity; other valid BCP 47 subtags remain part of tag matching but do not make this a general locale-settings object. It does not determine currency, time zone, number/date formatting, market, or legal jurisdiction. The AdCP canonical wire profile requires lower-case language and variants, title-case script, and upper-case region (for example `en-US`, `zh-Hant-TW`, or `x-private`). RFC 5646 comparisons are case-insensitive and its case regularization is optional; AdCP intentionally requires this stricter single wire spelling and receivers MUST reject differently cased tags rather than silently normalizing them. The schema pattern enforces the AdCP casing profile and extension structure for commonly used tags; conforming receivers additionally validate the complete RFC 5646 grammar and registry rules. Every new AdCP field carrying BCP 47 language identity or a concrete language range MUST reference this schema instead of declaring independent string constraints.","x-adcp-validation":{"verifier_constraints":{"well_formed":"rfc5646","semantic_scope":"language_identity_only","canonical_wire_profile":"adcp_bcp47_casing","rfc5646_comparison":"case_insensitive","non_profile":"reject"},"spec":"docs/protocol/language-and-localization.mdx#one-language-tag-primitive"},"type":"string","minLength":2,"maxLength":63,"pattern":"^(?:[a-z]{2,8}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?|x(?:-[a-z0-9]{1,8})+)$","examples":["en-US","es-ES","zh-Hant-TW","x-private"]},"external:core/negative-keyword.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/negative-keyword.json","title":"Negative Keyword","description":"An excluded keyword.","type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to exclude"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1match-type.json"}},"required":["keyword","match_type"],"additionalProperties":false},"external:core/targeting-unknown-age-eligibility-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/targeting-unknown-age-eligibility-constraint.json","title":"Targeting Unknown Age Eligibility Constraint","description":"Unknown-age delivery cannot satisfy a minimum-age eligibility policy. When demographic audience targeting and age_restriction are both present, include_unknown must be false.","if":{"required":["demographics","age_restriction"]},"then":{"properties":{"demographics":{"properties":{"age":{"properties":{"include_unknown":{"const":false}}}}}}}},"external:core/targeting-verified-age-basis-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/targeting-verified-age-basis-constraint.json","title":"Targeting Verified Age Basis Constraint","description":"A legal verification requirement always narrows demographic targeting. When the buyer supplies accepted_bases and age_restriction requires verification, verified must be accepted; otherwise the constraints have an empty intersection and the request is invalid.","if":{"properties":{"age_restriction":{"properties":{"verification_required":{"const":true}},"required":["verification_required"]},"demographics":{"properties":{"age":{"required":["accepted_bases"]}},"required":["age"]}},"required":["demographics","age_restriction"]},"then":{"properties":{"demographics":{"properties":{"age":{"properties":{"accepted_bases":{"contains":{"const":"verified"}}}}}}}}},"external:core/media-buy-frequency-cap.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/media-buy-frequency-cap.json","title":"Media Buy Frequency Cap","description":"A MediaBuy-level maximum-impression cap. The counter is shared across participating packages for the declared per unit. Duration windows are rolling elapsed windows; campaign spans the MediaBuy flight. Aggregate suppression is not defined in 3.2 because suppress-only FrequencyCap values do not identify a counter entity.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap.json"},{"required":["max_impressions"],"not":{"anyOf":[{"required":["suppress"]},{"required":["suppress_minutes"]}]}}]},"external:core/targeting-overlay-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/targeting-overlay-requirements.json","title":"Targeting Overlay Requirements","description":"Buyer minimum requirements for targeting dimensions that will be selected on packages later. This request shape deliberately excludes seller limits such as max_values_per_package and max_packages. Matching is capability containment: where a field permits a boolean form, a requirement value of true matches product support true or any valid positive support object, and product support true satisfies every protocol-valid structured requirement except daypart_targets, where true promises inventory_local only. Otherwise, structured product support must contain the structured requirement. For geo_regions and geo_regions_exclude, every requested country must exist; requested all_values requires supported all_values; and requested values must be a subset of supported values unless support declares all_values. For geo_places and geo_places_exclude, every requested system and country key must exist and each requested place-type and system-version array must be a subset of the corresponding product array. Include and exclude fields match independently. Every valid structured requirement or support object represents a positive capability; empty, extension-only, and false-only objects are invalid. Object fields the buyer did not request do not participate. Missing or unknown required fields do not match. Numeric seller limits are disclosed only in Product.overlay_support and never participate in matching. Legacy frequency_cap: true matches only the unchanged broad declaration. frequency_cap_support matches either legacy true or a containing structured declaration; an empty object requests either positive form. A requirement carries at most one of the two.","type":"object","properties":{"geo_countries":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"geo_countries_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"geo_regions":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-region-requirement.json","x-adcp-schema-uri":"/schemas/core/geo-region-requirement.json"}]},"geo_regions_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-region-requirement.json","x-adcp-schema-uri":"/schemas/core/geo-region-requirement.json"}]},"geo_metros":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/metroRequirement"},"geo_metros_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/metroRequirement"},"geo_places":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-requirement.json","x-adcp-schema-uri":"/schemas/core/geo-place-requirement.json"},"geo_places_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-requirement.json","x-adcp-schema-uri":"/schemas/core/geo-place-requirement.json"},"geo_postal_areas":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1positive-postal-area-support.json"}]},"geo_postal_areas_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1positive-postal-area-support.json"}]},"geo_proximity":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","properties":{"radius":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"travel_time":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"geometry":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"transport_modes":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1transport-mode.json"},"minItems":1,"uniqueItems":true}},"anyOf":[{"required":["radius"]},{"required":["travel_time"]},{"required":["geometry"]},{"required":["transport_modes"]}],"additionalProperties":false}]},"daypart_targets":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/daypartRequirement"},"audience_include":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"audience_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"signal_targeting_groups":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"demographics":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","properties":{"age":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"}},"required":["age"],"additionalProperties":false}]},"frequency_cap":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"frequency_cap_support":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap-requirements.json","description":"Minimum structured package-cap support. Matches a broad legacy frequency_cap: true or a containing frequency_cap_support object. Mutually exclusive with a frequency_cap: true requirement, which would exclude every constrained product."},"property_list":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"property_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"collection_list":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"collection_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"placement_selection":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"age_restriction":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"device_platform":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"device_platform_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"device_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"device_type_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"browser":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/browserRequirement"},"browser_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/browserRequirement"},"store_catchments":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"language":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},"keyword_targets":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/keywordRequirement"},"negative_keywords":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/keywordRequirement"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1ext.json"}},"minProperties":1,"not":{"required":["frequency_cap","frequency_cap_support"]},"additionalProperties":false,"$defs":{"required":{"type":"boolean","const":true},"metroRequirement":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","properties":{"systems":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1metro-system.json"},"minItems":1,"uniqueItems":true}},"required":["systems"],"additionalProperties":false}]},"keywordRequirement":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","properties":{"supported_match_types":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1match-type.json"},"minItems":1,"uniqueItems":true}},"required":["supported_match_types"],"additionalProperties":false}]},"browserRequirement":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","description":"Require later package-level selection for the listed canonical browser families. The requirement matches unrestricted true support or structured support containing every requested family.","properties":{"families":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true}},"required":["families"],"additionalProperties":false}]},"daypartRequirement":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1targeting-overlay-requirements.json/$defs/required"},{"type":"object","description":"Require later package-level daypart selection using each listed timezone mode. Structured product support must contain every requested mode. For backward compatibility, daypart_targets support true satisfies inventory_local requirements only and does not satisfy requirements for iana.","properties":{"timezone_modes":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1daypart-timezone-mode.json"},"minItems":1,"uniqueItems":true},"iana_timezones":{"type":"array","description":"Exact concrete IANA timezone identifiers that must remain selectable after discovery. Valid only when timezone_modes includes iana.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1iana-timezone.json"},"minItems":1,"uniqueItems":true}},"required":["timezone_modes"],"allOf":[{"if":{"required":["iana_timezones"]},"then":{"properties":{"timezone_modes":{"contains":{"const":"iana"}}}}}],"additionalProperties":false}]}}},"external:enums/daypart-timezone-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/daypart-timezone-mode.json","title":"Daypart Timezone Mode","description":"Clock modes a product supports for daypart targeting.","type":"string","enum":["inventory_local","iana"],"x-added-in":"3.2.0"},"external:core/geo-region-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-region-requirement.json","title":"Geographic Region Requirement","description":"Buyer minimum requirements for ISO 3166-2 subdivision values that must remain independently selectable later. Country keys prevent a false cross-country capability claim. all_values requires support for every protocol-valid ISO subdivision active in the seller's support snapshot when the declaration is issued; values requests an exact finite candidate set. Exact delivery values known now belong in get_products.targeting_overlay instead.","type":"object","properties":{"countries":{"type":"object","description":"Required ISO subdivision support keyed by ISO 3166-1 alpha-2 country.","propertyNames":{"pattern":"^[A-Z]{2}$"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"all_values":{"type":"boolean","const":true,"description":"Require every protocol-valid ISO 3166-2 subdivision active in the seller's returned support snapshot for this country to remain selectable."}},"required":["all_values"],"additionalProperties":false},{"type":"object","properties":{"values":{"type":"array","description":"Exact finite set of ISO 3166-2 identifiers the buyer may select later.","items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1,"uniqueItems":true}},"required":["values"],"additionalProperties":false}]},"minProperties":1}},"required":["countries"],"additionalProperties":false,"x-adcp-validation":{"verifier_constraints":{"country_prefix_matches_map_key":{"map_field":"countries","values_field":"values"}},"spec":"docs/media-buy/advanced-topics/targeting.mdx#geo_regions"}},"external:core/geo-place-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-place-requirement.json","title":"Geographic Place Requirement","description":"Identifier systems and collision-safe country/type pairs the buyer must be allowed to select later.","type":"object","properties":{"systems":{"type":"object","propertyNames":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-system.json"},"additionalProperties":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-requirement.json/$defs/catalogRequirement"},"minProperties":1}},"required":["systems"],"additionalProperties":false,"$defs":{"catalogRequirement":{"type":"object","description":"Required country/type pairs and optional exact catalog versions for one identifier system. Country keys prevent a false Cartesian product between countries and place types.","properties":{"countries":{"type":"object","propertyNames":{"pattern":"^[A-Z]{2}$"},"additionalProperties":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1geo-place-type.json"},"minItems":1,"uniqueItems":true},"minProperties":1},"system_versions":{"type":"array","description":"Optional exact catalog versions that must remain selectable. Versions are opaque strings, not ordered ranges.","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true}},"required":["countries"],"additionalProperties":false}}},"external:core/positive-postal-area-support.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/positive-postal-area-support.json","title":"Positive Postal Area Support","description":"Non-vacuous postal capability used for hard targeting requirements and product overlay support. At least one native system array or true-valued deprecated alias is required. The general seller-capabilities postal schema remains permissive for backward compatibility, but an empty or false-only map cannot satisfy a hard discovery requirement.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1postal-area-support.json"},{"type":"object","minProperties":1,"properties":{"us_zip":{"const":true},"us_zip_plus_four":{"const":true},"gb_outward":{"const":true},"gb_full":{"const":true},"ca_fsa":{"const":true},"ca_full":{"const":true},"de_plz":{"const":true},"fr_code_postal":{"const":true},"au_postcode":{"const":true},"ch_plz":{"const":true},"at_plz":{"const":true}}}]},"external:core/postal-area-support.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/postal-area-support.json","title":"Postal Area Support","description":"Declares supported postal area systems. Native support is keyed by ISO 3166-1 alpha-2 country with arrays of country-local postal systems. Deprecated country-fused boolean aliases may be included during migration.","type":"object","properties":{"US":{"type":"array","items":{"enum":["zip","zip_plus_four"]},"minItems":1,"uniqueItems":true},"GB":{"type":"array","items":{"enum":["outward","full"]},"minItems":1,"uniqueItems":true},"CA":{"type":"array","items":{"enum":["fsa","full"]},"minItems":1,"uniqueItems":true},"DE":{"type":"array","items":{"const":"plz"},"minItems":1,"uniqueItems":true},"CH":{"type":"array","items":{"const":"plz"},"minItems":1,"uniqueItems":true},"AT":{"type":"array","items":{"const":"plz"},"minItems":1,"uniqueItems":true},"FR":{"type":"array","items":{"const":"code_postal"},"minItems":1,"uniqueItems":true},"AU":{"type":"array","items":{"const":"postcode"},"minItems":1,"uniqueItems":true},"BR":{"type":"array","items":{"const":"cep"},"minItems":1,"uniqueItems":true},"IN":{"type":"array","items":{"const":"pin"},"minItems":1,"uniqueItems":true},"ZA":{"type":"array","items":{"const":"postal_code"},"minItems":1,"uniqueItems":true},"us_zip":{"type":"boolean","deprecated":true},"us_zip_plus_four":{"type":"boolean","deprecated":true},"gb_outward":{"type":"boolean","deprecated":true},"gb_full":{"type":"boolean","deprecated":true},"ca_fsa":{"type":"boolean","deprecated":true},"ca_full":{"type":"boolean","deprecated":true},"de_plz":{"type":"boolean","deprecated":true},"fr_code_postal":{"type":"boolean","deprecated":true},"au_postcode":{"type":"boolean","deprecated":true},"ch_plz":{"type":"boolean","deprecated":true},"at_plz":{"type":"boolean","deprecated":true}},"propertyNames":{"anyOf":[{"pattern":"^[A-Z]{2}$"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1legacy-postal-system.json"}]},"additionalProperties":{"type":"array","items":{"enum":["postal_code","custom"]},"minItems":1,"uniqueItems":true}},"external:core/frequency-cap-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/frequency-cap-requirements.json","title":"Frequency Cap Requirements","description":"Buyer minimums for structured product frequency-cap support. An empty object requests any positive support. Otherwise each array must be a subset of the product's resolved support, where a product field omitted from frequency_cap_support inherits the seller-wide media_buy.frequency_capping declaration (an omitted seller-wide list means every value). Duration units resolve the same way: a requested window or suppression unit matches when the product lists it in window_constraints or suppression_constraints, or, when the product omits that list, when the seller-wide supported_window_units includes it or is omitted. A legacy package declaration of frequency_cap: true satisfies every requirement because its broad meaning is unchanged. Exact count and interval values belong in a concrete cap supplied during discovery.","type":"object","properties":{"mutable_fields":{"type":"array","description":"Require each listed logical field to be mutable after creation. Matches a product whose mutable_fields contains every listed value, or a product that omits mutable_fields, or legacy frequency_cap: true. A product declaring mutable_fields: [] is create-only and never matches a non-empty list.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1frequency-cap-mutable-field.json"},"minItems":1,"uniqueItems":true},"supported_control_modes":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1frequency-cap-control-mode.json"},"minItems":1,"uniqueItems":true},"supported_per_units":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1reach-unit.json"},"minItems":1,"uniqueItems":true},"supported_window_units":{"type":"array","description":"Require each listed unit to be a supported max_impressions.window unit after seller-wide inheritance.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap-duration-unit.json"},"minItems":1,"uniqueItems":true},"supported_suppression_units":{"type":"array","description":"Require each listed unit to be a supported suppress unit after seller-wide inheritance.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap-duration-unit.json"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"external:enums/frequency-cap-mutable-field.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/frequency-cap-mutable-field.json","title":"Frequency Cap Mutable Field","description":"A logical frequency-cap field that a product implementation can change after creation. suppress covers the effective cooldown whether represented by suppress or the deprecated suppress_minutes alias.","type":"string","enum":["max_impressions","per","window","suppress"]},"external:enums/frequency-cap-control-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/frequency-cap-control-mode.json","title":"Frequency Cap Control Mode","description":"A supported package frequency-cap control shape.","type":"string","enum":["max_impressions","suppress","max_impressions_and_suppress"]},"external:core/frequency-cap-duration-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/frequency-cap-duration-unit.json","title":"Frequency Cap Duration Unit","description":"A duration unit supported for a frequency-cap window or suppression period.","type":"string","enum":["seconds","minutes","hours","days","campaign"]},"external:core/media-buy-support-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/media-buy-support-requirements.json","title":"Product Media Buy Support Requirements","description":"Buyer minimums for product participation in shared MediaBuy-level execution. Missing or unknown required capabilities exclude the product.","type":"object","properties":{"frequency_cap":{"type":"boolean","const":true,"description":"Require product participation in one shared MediaBuy frequency-cap counter."},"frequency_cap_constraints":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1media-buy-frequency-cap-requirement.json"}},"minProperties":1,"additionalProperties":false,"dependentRequired":{"frequency_cap_constraints":["frequency_cap"]}},"external:core/media-buy-frequency-cap-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/media-buy-frequency-cap-requirement.json","title":"Media Buy Frequency Cap Requirement","description":"Buyer minimum product-support detail for an aggregate MediaBuy frequency cap. Aggregate support in 3.2 is max-impressions only.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:core~1frequency-cap-requirements.json"},{"type":"object","properties":{"supported_control_modes":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1media-buy-frequency-cap-control-mode.json"},"minItems":1,"uniqueItems":true}},"not":{"required":["supported_suppression_units"]}}]},"external:enums/media-buy-frequency-cap-control-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/media-buy-frequency-cap-control-mode.json","title":"Media Buy Frequency Cap Control Mode","description":"The aggregate MediaBuy frequency-cap control shape supported in 3.2.","type":"string","enum":["max_impressions"]},"external:media-buy/product-fields.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/media-buy/product-fields.json","title":"Product Response Fields","description":"Canonical product fields a buyer requests from list_products. Required product_id and name fields are always returned. list_applications also overrides projection whenever a property or collection list is in the effective targeting because it is the decision receipt for seller-specific list matching. targeting_resolution and expires_at override projection whenever the seller returns modifications, as does collection_targeting_allowed whenever returned overlay_support declares collection_list. Legacy named-format fields remain available only through get_products.","type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["product_id","name","description","publisher_properties","channels","video_placement_types","audio_distribution_types","sponsored_placement_types","social_placement_surfaces","format_options","placements","delivery_type","exclusivity","pricing_options","forecast","reporting_capabilities","measurement_terms","performance_standards","catalog_types","signal_targeting_allowed","signal_targeting_rules","demographic_targeting","overlay_support","collections","collection_targeting_allowed","media_buy_support","audience_evidence","audience_evidence_selections","max_optimization_goals","catalog_match","list_applications","brief_relevance","targeting_resolution","acceptance_policy_profile_ids","identity","execution_requirements","expires_at","allowed_actions"]}},"external:core/push-notification-config.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/push-notification-config.json","title":"Push Notification Config","description":"Webhook configuration for asynchronous task notifications. Uses A2A-compatible PushNotificationConfig structure. By default, webhooks are signed with the AdCP RFC 9421 profile (see docs/building/by-layer/L1/security.mdx#webhook-callbacks) — the seller signs outbound with a key published at the jwks_uri on its own brand.json `agents[]` entry and the buyer verifies against that JWKS, so no shared secret crosses the wire. The optional `authentication` block selects the legacy Bearer or HMAC-SHA256 fallback for compatibility with receivers that have not yet adopted the 9421 profile; this fallback is deprecated and will be removed in AdCP 4.0. Note: the `idempotency_key` that receivers dedup on lives inside the webhook **payload** body (see docs/building/by-layer/L3/webhooks.mdx#reliability and the mcp-webhook-payload schema), not in this configuration object — this schema only describes the receiver-side transport config sent to the seller. This schema is designed for composition via allOf - consuming schemas should define their own additionalProperties constraints.","type":"object","properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint URL for task status notifications. The wire contract is unconstrained beyond `format: \"uri\"` — in particular, publishers SHOULD NOT enforce a destination-port allowlist by default, since buyers legitimately host receivers on non-standard TLS ports (`:9443`, `:4443`, path-routed multi-tenant gateways). The SSRF guard the protocol relies on is the IP-range check + DNS-rebinding-resistant connect pin defined in [Webhook URL validation (SSRF)](/docs/building/by-layer/L1/security#webhook-url-validation-ssrf), not port filtering. Operators who want a hardened destination-port allowlist as defense-in-depth (e.g., locked-down enterprise egress) opt in explicitly — see [Destination port: permissive by default](/docs/building/by-layer/L1/security#destination-port-permissive-by-default)."},"operation_id":{"type":"string","description":"Buyer-supplied correlation identifier for the operation that will produce webhooks against this registration. The seller MUST echo this value verbatim into every webhook payload's `operation_id` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) and [Webhooks — Operation IDs](/docs/building/by-layer/L3/webhooks#operation-ids-and-url-templates)). Buyers SHOULD generate a unique value per task invocation (UUID recommended). This field is the canonical registration channel for `operation_id`; buyers MAY additionally embed routing values in the URL path or query as an aid for their own HTTP server, but the URL is opaque to the seller and the wire-level source of truth is this field. Sellers MUST NOT parse the URL to recover `operation_id`. For 3.x schema compatibility the member remains optional, but a seller MUST reject a task that registers an AdCP webhook without it using `INVALID_REQUEST`; otherwise the required webhook envelope cannot be emitted.","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{1,255}$"},"token":{"type":"string","description":"Optional client-provided token for webhook validation. The seller MUST echo this value verbatim in every webhook payload's `token` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) for the receiver-side validation obligation). Length bounds give receivers a defensive range check on the echoed value; senders SHOULD generate tokens with at least 128 bits of entropy (≥22 base64url characters). This is a complementary authenticity mechanism that can layer on top of the RFC 9421 webhook signature — unlike the `authentication` block below, it is not on the 4.0 removal track. Receivers that registered both a signing key (RFC 9421) and a `token` MUST NOT treat a valid token echo as authorization to skip signature verification; both checks remain independent obligations.","minLength":16,"maxLength":4096},"authentication":{"type":"object","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication configuration (A2A-compatible). Opts the seller into Bearer or HMAC-SHA256 signing instead of the default RFC 9421 webhook profile. Deprecated; removed in AdCP 4.0. **Precedence is a switch, not a fallback:** presence of this block selects the legacy scheme; absence selects 9421. A seller MUST NOT sign the same webhook both ways, and a buyer MUST NOT attempt 'try 9421 first, fall back to HMAC' verification — signature mode is determined solely by whether this block was present at registration time. The seller's baseline 9421 webhook key is published at its brand.json `agents[]` `jwks_uri` using `adcp_use: \"request-signing\"` (deprecated `webhook-signing` keys remain accepted during the compatibility window); it does not override this selector and is only used when `authentication` is omitted. See docs/building/by-layer/L1/security.mdx#webhook-callbacks for the full precedence and downgrade-resistance rules (including the `webhook_mode_mismatch` rejection a buyer MUST apply when a received webhook's signing mode does not match the registered mode).","properties":{"schemes":{"type":"array","description":"Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit `authentication` and use the RFC 9421 webhook profile.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/get-products-request.json#/$defs/external:enums~1auth-scheme.json"},"minItems":1,"maxItems":1},"credentials":{"type":"string","description":"Credentials for the legacy scheme. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.","minLength":32}},"required":["schemes","credentials"],"additionalProperties":false}},"required":["url"]},"external:enums/auth-scheme.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/auth-scheme.json","title":"Authentication Scheme","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication schemes for the webhook auth block. Bearer: token sent in Authorization header. HMAC-SHA256: legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit the authentication block and use the RFC 9421 webhook signing profile (applicable on schemas where authentication is optional). Removed in AdCP 4.0.","type":"string","enum":["Bearer","HMAC-SHA256"]},"external:core/pagination-request.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/pagination-request.json","title":"Pagination Request","description":"Standard cursor-based pagination parameters for list operations","type":"object","properties":{"max_results":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Maximum number of items to return per page"},"cursor":{"type":"string","description":"Opaque cursor from a previous response to fetch the next page"}},"additionalProperties":false},"external:core/context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/context.json","title":"Context Object","description":"Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.","type":"object","additionalProperties":true}},"dependentRequired":{"catalog":["brand"],"if_pricing_version":["if_wholesale_feed_version"]}}