Changes to Update ads

Changed in 14 of the 29 revisions of this API.▲11●28○119

1. Jun 4, 2026v5b698c180678a▲1●1○75
2. Dec 11, 2025v5537bde5a50b1○4
3. Oct 16, 2025v514c297539b64●3○3
4. Apr 4, 2025v510f9eba4ad97●11○11
5. Aug 14, 2024v589c27ed39cfd▲1●1○6
6. Apr 23, 2024v5f9321315766f▲1
7. Feb 8, 2024v57529b464d5cb●4○9
8. Aug 17, 2023v50ff12596bafd○2
9. Jul 14, 2023v552586a274771●2○2
10. May 12, 2023v5689b4b267639●1○1
11. Feb 14, 2023v5be19b77aa78a▲5●2○1
12. Nov 14, 2022v5e041d7b0cef0▲1
13. Sep 7, 2022v5bd20b6eb152f▲2●3○4
14. Jul 11, 2022v50d5998752011○1

What changed

• Jun 4, 2026v5b698c180678a▲1●1○75See the full diff
  • ▲

    added the new required request property items/id

    new-required-request-property

  • ●

    removed AdCommon subschema #2: AdUpdateRequest from the items request property allOf list

    request-property-all-of-removed

  • ○

    added the new optional request property items/ad_group_id

    new-optional-request-property

  • ○

    added the new optional request property items/android_deep_link

    new-optional-request-property

  • ○

    added the new optional request property items/carousel_android_deep_links

    new-optional-request-property

  • ○

    added the new optional request property items/carousel_destination_urls

    new-optional-request-property

  • ○

    added the new optional request property items/carousel_ios_deep_links

    new-optional-request-property

  • ○

    added the new optional request property items/click_tracking_url

    new-optional-request-property

  • ○

    added the new optional request property items/collection_items_destination_url_template

    new-optional-request-property

  • ○

    added the new optional request property items/collections_header_type

    new-optional-request-property

  • ○

    added the new optional request property items/creative_type

    new-optional-request-property

  • ○

    added the new optional request property items/customizable_cta_type

    new-optional-request-property

  • ○

    added the new optional request property items/destination_url

    new-optional-request-property

  • ○

    added the new optional request property items/disclosure_type

    new-optional-request-property

  • ○

    added the new optional request property items/disclosure_url

    new-optional-request-property

  • ○

    added the new optional request property items/grid_click_type

    new-optional-request-property

  • ○

    added the new optional request property items/ios_deep_link

    new-optional-request-property

  • ○

    added the new optional request property items/is_carting

    new-optional-request-property

  • ○

    added the new optional request property items/is_collage_accepted_terms

    new-optional-request-property

  • ○

    added the new optional request property items/is_collage_single_destination

    new-optional-request-property

  • ○

    added the new optional request property items/is_pin_deleted

    new-optional-request-property

  • ○

    added the new optional request property items/is_removable

    new-optional-request-property

  • ○

    added the new optional request property items/lead_form_id

    new-optional-request-property

  • ○

    added the new optional request property items/name

    new-optional-request-property

  • ○

    added the new optional request property items/pin_id

    new-optional-request-property

  • ○

    added the new optional request property items/quiz_pin_data

    new-optional-request-property

  • ○

    added the new optional request property items/status

    new-optional-request-property

  • ○

    added the new optional request property items/tracking_urls

    new-optional-request-property

  • ○

    added the new optional request property items/view_tracking_url

    new-optional-request-property

  • ○

    added the non-success response with the status 400

    response-non-success-status-added

  • ○

    added the non-success response with the status 401

    response-non-success-status-added

  • ○

    added the non-success response with the status 403

    response-non-success-status-added

  • ○

    added the non-success response with the status 404

    response-non-success-status-added

  • ○

    added the non-success response with the status 429

    response-non-success-status-added

  • ○

    added the optional property items/items/data/android_deep_link to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/carousel_android_deep_links to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/carousel_destination_urls to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/carousel_ios_deep_links to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/carting_platform_type to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/carting_products to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/click_tracking_url to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/collection_items_destination_url_template to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/collections_header_type to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/created_time to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/customizable_cta_type to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/destination_url to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/disclosure_type to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/disclosure_url to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/grid_click_type to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/ios_deep_link to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/is_carting to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/is_collage_accepted_terms to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/is_collage_single_destination to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/is_pin_deleted to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/is_removable to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/lead_form_id to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/name to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/quiz_pin_data to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/status to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/tracking_urls to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/updated_time to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/view_tracking_url to the response with the 200 status

    response-optional-property-added

  • ○

    removed AdCommon AdPinId subschema #3 from the items/items/data response property allOf list for the response status 200

    response-property-all-of-removed

  • ○

    the response property items became required for the status 200

    response-property-became-required

  • ○

    the response property items/items/exceptions/code became required for the status 200

    response-property-became-required

  • ○

    the response property items/items/exceptions/message became required for the status 200

    response-property-became-required

  • ○

    added the required property items/items/data/ad_account_id to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/ad_group_id to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/campaign_id to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/creative_type to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/id to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/pin_id to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/rejected_reasons to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/rejection_labels to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/review_status to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/summary_status to the response with the 200 status

    response-required-property-added

  • ○

    added the required property items/items/data/type to the response with the 200 status

    response-required-property-added

  This revision also has 182 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Dec 11, 2025v5537bde5a50b1○4See the full diff
  • ○

    added the new optional request property items/allOf[#/components/schemas/AdCommon]/disclosure_type

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[#/components/schemas/AdCommon]/disclosure_url

    new-optional-request-property

  • ○

    added the optional property items/items/data/allOf[#/components/schemas/AdCommon]/disclosure_type to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[#/components/schemas/AdCommon]/disclosure_url to the response with the 200 status

    response-optional-property-added

  This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Oct 16, 2025v514c297539b64●3○3See the full diff
  • ●

    added the new COLLAGE enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/creative_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new MAX_WIDTH_REGULAR_COLLECTION enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/creative_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new MAX_WIDTH_VIDEO_COLLECTION enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/creative_type response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new COLLAGE enum value to the request property items/allOf[#/components/schemas/AdCommon]/creative_type

    request-property-enum-value-added

  • ○

    added the new MAX_WIDTH_REGULAR_COLLECTION enum value to the request property items/allOf[#/components/schemas/AdCommon]/creative_type

    request-property-enum-value-added

  • ○

    added the new MAX_WIDTH_VIDEO_COLLECTION enum value to the request property items/allOf[#/components/schemas/AdCommon]/creative_type

    request-property-enum-value-added

  This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Apr 4, 2025v510f9eba4ad97●11○11See the full diff
  • ●

    added the new BUY_TICKETS enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new DONATE_NOW enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new DOWNLOAD enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new EXPLORE_MORE enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new FIND_A_LOCATION enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new GET_DEAL enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new GET_RECIPE enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new GET_SHOWTIMES enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new ON_SALE enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new PLAY_GAME enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new TRY_IT enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new BUY_TICKETS enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new DONATE_NOW enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new DOWNLOAD enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new EXPLORE_MORE enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new FIND_A_LOCATION enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new GET_DEAL enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new GET_RECIPE enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new GET_SHOWTIMES enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new ON_SALE enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new PLAY_GAME enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the new TRY_IT enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Aug 14, 2024v589c27ed39cfd▲1●1○6See the full diff
  • ▲

    removed the enum value VISIT_WEBSITE of the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-removed

  • ●

    added the new VISIT_SITE enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new optional request property items/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_custom_result

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_type

    new-optional-request-property

  • ○

    added the new VISIT_SITE enum value to the request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    request-property-enum-value-added

  • ○

    added the optional property items/items/data/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_custom_result to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[#/components/schemas/AdCommon]/quiz_pin_data/allOf[#/components/schemas/QuizPinData]/tie_breaker_type to the response with the 200 status

    response-optional-property-added

  • ○

    removed the VISIT_WEBSITE enum value from the items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type response property for the response status 200

    response-property-enum-value-removed

  This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Apr 23, 2024v5f9321315766f▲1See the full diff
  • ▲

    the items request property type changed from no type to object

    request-property-type-changed

  This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Feb 8, 2024v57529b464d5cb●4○9See the full diff
  • ●

    added the new DELETED_DRAFT enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/status response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new DELETED_DRAFT enum value to the items/items/data/allOf[subschema #3]/summary_status/allOf[#/components/schemas/PinPromotionSummaryStatus] response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new DRAFT enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/status response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new DRAFT enum value to the items/items/data/allOf[subschema #3]/summary_status/allOf[#/components/schemas/PinPromotionSummaryStatus] response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new optional request property items/allOf[#/components/schemas/AdCommon]/customizable_cta_type

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[#/components/schemas/AdCommon]/grid_click_type

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[#/components/schemas/AdCommon]/quiz_pin_data

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[subschema #2: AdUpdateRequest]/pin_id

    new-optional-request-property

  • ○

    added the new DELETED_DRAFT enum value to the request property items/allOf[#/components/schemas/AdCommon]/status

    request-property-enum-value-added

  • ○

    added the new DRAFT enum value to the request property items/allOf[#/components/schemas/AdCommon]/status

    request-property-enum-value-added

  • ○

    added the optional property items/items/data/allOf[#/components/schemas/AdCommon]/customizable_cta_type to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[#/components/schemas/AdCommon]/grid_click_type to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[#/components/schemas/AdCommon]/quiz_pin_data to the response with the 200 status

    response-optional-property-added

  This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Aug 17, 2023v50ff12596bafd○2See the full diff
  • ○

    added the new optional request property items/allOf[#/components/schemas/AdCommon]/lead_form_id

    new-optional-request-property

  • ○

    added the optional property items/items/data/allOf[#/components/schemas/AdCommon]/lead_form_id to the response with the 200 status

    response-optional-property-added

• Jul 14, 2023v552586a274771●2○2See the full diff
  • ●

    added the new COLLECTION enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/creative_type response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new SHOWCASE enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/creative_type response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new COLLECTION enum value to the request property items/allOf[#/components/schemas/AdCommon]/creative_type

    request-property-enum-value-added

  • ○

    added the new SHOWCASE enum value to the request property items/allOf[#/components/schemas/AdCommon]/creative_type

    request-property-enum-value-added

  This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• May 12, 2023v5689b4b267639●1○1See the full diff
  • ●

    added the new QUIZ enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/creative_type response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new QUIZ enum value to the request property items/allOf[#/components/schemas/AdCommon]/creative_type

    request-property-enum-value-added

  This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Feb 14, 2023v5be19b77aa78a▲5●2○1See the full diff
  • ▲

    the items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/audience_verification/items response property's maxLength was unset from 2000 for the response status 200

    response-property-max-length-unset

  • ▲

    the items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/buyable_button/items response property's maxLength was unset from 2000 for the response status 200

    response-property-max-length-unset

  • ▲

    the items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/click/items response property's maxLength was unset from 2000 for the response status 200

    response-property-max-length-unset

  • ▲

    the items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/engagement/items response property's maxLength was unset from 2000 for the response status 200

    response-property-max-length-unset

  • ▲

    the items/items/data/allOf[#/components/schemas/AdCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/impression/items response property's maxLength was unset from 2000 for the response status 200

    response-property-max-length-unset

  • ●

    removed the request property items/allOf[#/components/schemas/AdCommon]/pin_id

    request-property-removed

  • ●

    removed the optional property items/items/data/allOf[#/components/schemas/AdCommon]/pin_id from the response with the 200 status

    response-optional-property-removed

  • ○

    added AdPinId to the items/items/data response property allOf list for the response status 200

    response-property-all-of-added

  This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Nov 14, 2022v5e041d7b0cef0▲1See the full diff
  • ▲

    for the path request parameter ad_account_id, the maxLength was decreased from 19 to 18

    request-parameter-max-length-decreased

• Sep 7, 2022v5bd20b6eb152f▲2●3○4See the full diff
  • ▲

    the request's body minItems was increased to 1

    request-body-min-items-increased

  • ▲

    removed the enum value STORY of the request property items/allOf[#/components/schemas/AdCommon]/creative_type

    request-property-enum-value-removed

  • ●

    for the path request parameter ad_account_id, the maxLength was set to 19

    request-parameter-max-length-set

  • ●

    changed the pattern of the request property items/allOf[#/components/schemas/AdCommon]/ad_group_id from ^\d+$ to ^(AG)?\d+$

    request-property-pattern-changed

  • ●

    added the new IDEA enum value to the items/items/data/allOf[#/components/schemas/AdCommon]/creative_type response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new IDEA enum value to the request property items/allOf[#/components/schemas/AdCommon]/creative_type

    request-property-enum-value-added

  • ○

    the items/allOf[subschema #2: AdUpdateRequest] request property's minLength was decreased from 1 to 0

    request-property-min-length-decreased

  • ○

    removed the STORY enum value from the items/items/data/allOf[#/components/schemas/AdCommon]/creative_type response property for the response status 200

    response-property-enum-value-removed

  • ○

    the items/items/data/allOf[#/components/schemas/AdCommon]/ad_group_id response's property pattern was changed from ^\d+$ to ^(AG)?\d+$ for the status 200

    response-property-pattern-changed

  This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Jul 11, 2022v50d5998752011○1See the full diff
  • ○

    endpoint added

    endpoint-added