Changes to Update ad groups

Changed in 14 of the 29 revisions of this API.▲16●15○102

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

What changed

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

    added the new required request property items/id

    new-required-request-property

  • ●

    removed AdGroupCommon subschema #2 from the items/ request property allOf list

    request-property-all-of-removed

  • ○

    added the new optional request property items/auto_targeting_enabled

    new-optional-request-property

  • ○

    added the new optional request property items/bid_in_micro_currency

    new-optional-request-property

  • ○

    added the new optional request property items/bid_multiplier

    new-optional-request-property

  • ○

    added the new optional request property items/bid_strategy_type

    new-optional-request-property

  • ○

    added the new optional request property items/billable_event

    new-optional-request-property

  • ○

    added the new optional request property items/budget_in_micro_currency

    new-optional-request-property

  • ○

    added the new optional request property items/budget_type

    new-optional-request-property

  • ○

    added the new optional request property items/campaign_id

    new-optional-request-property

  • ○

    added the new optional request property items/customer_segment_id

    new-optional-request-property

  • ○

    added the new optional request property items/end_time

    new-optional-request-property

  • ○

    added the new optional request property items/ext_features

    new-optional-request-property

  • ○

    added the new optional request property items/feed_profile_id

    new-optional-request-property

  • ○

    added the new optional request property items/is_creative_optimization

    new-optional-request-property

  • ○

    added the new optional request property items/is_local_inventory

    new-optional-request-property

  • ○

    added the new optional request property items/lifetime_frequency_cap

    new-optional-request-property

  • ○

    added the new optional request property items/local_inventory_radius_in_miles

    new-optional-request-property

  • ○

    added the new optional request property items/name

    new-optional-request-property

  • ○

    added the new optional request property items/optimization_goal_metadata

    new-optional-request-property

  • ○

    added the new optional request property items/pacing_delivery_type

    new-optional-request-property

  • ○

    added the new optional request property items/performance_plus_campaign_settings

    new-optional-request-property

  • ○

    added the new optional request property items/placement_group

    new-optional-request-property

  • ○

    added the new optional request property items/placement_traffic_type

    new-optional-request-property

  • ○

    added the new optional request property items/promotion_application_level

    new-optional-request-property

  • ○

    added the new optional request property items/promotion_id

    new-optional-request-property

  • ○

    added the new optional request property items/promotion_ids

    new-optional-request-property

  • ○

    added the new optional request property items/start_time

    new-optional-request-property

  • ○

    added the new optional request property items/status

    new-optional-request-property

  • ○

    added the new optional request property items/targeting_spec

    new-optional-request-property

  • ○

    added the new optional request property items/targeting_spec_operations

    new-optional-request-property

  • ○

    added the new optional request property items/targeting_template_ids

    new-optional-request-property

  • ○

    added the new optional request property items/tracking_urls

    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/auto_targeting_enabled to the response with the 200 status

    response-optional-property-added

  • ○

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

    response-optional-property-added

  • ○

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

    response-optional-property-added

  • ○

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

    response-optional-property-added

  • ○

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

    response-property-all-of-added

  • ○

    removed AdGroupCommon subschema #2 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/items/message became required for the status 200

    response-property-became-required

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

• Dec 11, 2025v5537bde5a50b1▲2See the full diff
  • ▲

    the items/items/data/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_EXCLUDE/items/ response property's minItems was decreased from 100 to 0 for the response status 200

    response-property-min-items-decreased

  • ▲

    the items/items/data/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE/items/ response property's minItems was decreased from 100 to 0 for the response status 200

    response-property-min-items-decreased

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

• Dec 10, 2025v56768e3ca1ffa○4See the full diff
  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/MAXIMUM_AGE

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/MINIMUM_AGE

    new-optional-request-property

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/MAXIMUM_AGE to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/MINIMUM_AGE to the response with the 200 status

    response-optional-property-added

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

• Aug 12, 2025v58fb7ab040159○2See the full diff
  • ○

    added the new optional request property items/allOf[AdGroupCommon]/optimization_goal_metadata/allOf[OptimizationGoalMetadata]/conversion_tag_v3_goal_metadata/reporting_event

    new-optional-request-property

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/optimization_goal_metadata/allOf[OptimizationGoalMetadata]/conversion_tag_v3_goal_metadata/reporting_event 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

• Jul 16, 2025v543134ca41f18○2See the full diff
  • ○

    added the new optional request property items/allOf[AdGroupCommon]/promotion_application_level

    new-optional-request-property

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/promotion_application_level to the response with the 200 status

    response-optional-property-added

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

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

    the items/allOf[AdGroupCommon]/optimization_goal_metadata/allOf[OptimizationGoalMetadata]/frequency_goal_metadata/frequency request property's max was set to 20.00

    request-property-max-set

  • ●

    the items/allOf[AdGroupCommon]/optimization_goal_metadata/allOf[OptimizationGoalMetadata]/frequency_goal_metadata/frequency request property's min was set to 2.00

    request-property-min-set

  • ●

    added the new 19+ enum value to the items/items/data/allOf[AdGroupCommon]/targeting_spec/AGE_BUCKET/items/ response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new 20+ enum value to the items/items/data/allOf[AdGroupCommon]/targeting_spec/AGE_BUCKET/items/ response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/is_creative_optimization

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/promotion_id

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[subschema #2]/bid_multiplier

    new-optional-request-property

  • ○

    added the new 19+ enum value to the request property items/allOf[AdGroupCommon]/targeting_spec/AGE_BUCKET/items/

    request-property-enum-value-added

  • ○

    added the new 20+ enum value to the request property items/allOf[AdGroupCommon]/targeting_spec/AGE_BUCKET/items/

    request-property-enum-value-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/is_creative_optimization to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/promotion_id to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[subschema #2]/bid_multiplier to the response with the 200 status

    response-optional-property-added

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

• Apr 23, 2024v5f9321315766f▲1●2○4See the full diff
  • ▲

    the items/ request property type/format changed from / to object/

    request-property-type-changed

  • ●

    removed the request property items/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE'

    request-property-removed

  • ●

    removed the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE' from the response with the 200 status

    response-optional-property-removed

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_template_ids

    new-optional-request-property

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_template_ids 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

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

    added the new DELETED_DRAFT enum value to the items/items/data/allOf[AdGroupCommon]/status/allOf[EntityStatus]/ 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 #2]/summary_status/allOf[AdGroupSummaryStatus]/ response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new DRAFT enum value to the items/items/data/allOf[AdGroupCommon]/status/allOf[EntityStatus]/ 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 #2]/summary_status/allOf[AdGroupSummaryStatus]/ response property for the response status 200

    response-property-enum-value-added

  • ○

    the request property default value ALL was added

    request-property-default-value-added

  • ○

    added the new DELETED_DRAFT enum value to the request property items/allOf[AdGroupCommon]/status/allOf[EntityStatus]/

    request-property-enum-value-added

  • ○

    added the new DRAFT enum value to the request property items/allOf[AdGroupCommon]/status/allOf[EntityStatus]/

    request-property-enum-value-added

  • ○

    the response's property default value ALL was added for the status 200

    response-property-default-value-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●1○1See the full diff
  • ●

    added the new TWENTY_FOUR_HOUR enum value to the items/items/data/allOf[AdGroupCommon]/optimization_goal_metadata/allOf[OptimizationGoalMetadata]/frequency_goal_metadata/timerange response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new TWENTY_FOUR_HOUR enum value to the request property items/allOf[AdGroupCommon]/optimization_goal_metadata/allOf[OptimizationGoalMetadata]/frequency_goal_metadata/timerange

    request-property-enum-value-added

• May 12, 2023v5689b4b267639▲5○27See the full diff
  • ▲

    added BudgetType to the items/allOf[AdGroupCommon]/budget_type request property allOf list

    request-property-all-of-added

  • ▲

    removed the enum value BILLABLE_ENGAGEMENT of the request property items/allOf[AdGroupCommon]/billable_event

    request-property-enum-value-removed

  • ▲

    removed the enum value CBO_ADGROUP of the request property items/allOf[AdGroupCommon]/budget_type

    request-property-enum-value-removed

  • ▲

    removed the enum value DAILY of the request property items/allOf[AdGroupCommon]/budget_type

    request-property-enum-value-removed

  • ▲

    removed the enum value LIFETIME of the request property items/allOf[AdGroupCommon]/budget_type

    request-property-enum-value-removed

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/AGE_BUCKET

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/APPTYPE

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_EXCLUDE

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE'

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/GENDER

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/GEO

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/INTEREST

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/LOCALE

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/LOCATION

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/SHOPPING_RETARGETING

    new-optional-request-property

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/targeting_spec/TARGETING_STRATEGY

    new-optional-request-property

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/AGE_BUCKET to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/APPTYPE to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_EXCLUDE to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE' to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/GENDER to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/GEO to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/INTEREST to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/LOCALE to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/LOCATION to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/SHOPPING_RETARGETING to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/targeting_spec/TARGETING_STRATEGY to the response with the 200 status

    response-optional-property-added

  • ○

    added BudgetType to the items/items/data/allOf[AdGroupCommon]/budget_type response property allOf list for the response status 200

    response-property-all-of-added

  • ○

    removed the BILLABLE_ENGAGEMENT enum value from the items/items/data/allOf[AdGroupCommon]/billable_event response property for the response status 200

    response-property-enum-value-removed

  • ○

    removed the CBO_ADGROUP enum value from the items/items/data/allOf[AdGroupCommon]/budget_type response property for the response status 200

    response-property-enum-value-removed

  • ○

    removed the DAILY enum value from the items/items/data/allOf[AdGroupCommon]/budget_type response property for the response status 200

    response-property-enum-value-removed

  • ○

    removed the LIFETIME enum value from the items/items/data/allOf[AdGroupCommon]/budget_type response property for the response status 200

    response-property-enum-value-removed

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

• Feb 14, 2023v5be19b77aa78a▲6●1○4See the full diff
  • ▲

    the response property items/items/data/allOf[AdGroupCommon]/bid_strategy_type became nullable for the status 200

    response-property-became-nullable

  • ▲

    the items/items/data/allOf[AdGroupCommon]/tracking_urls/allOf[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[AdGroupCommon]/tracking_urls/allOf[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[AdGroupCommon]/tracking_urls/allOf[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[AdGroupCommon]/tracking_urls/allOf[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[AdGroupCommon]/tracking_urls/allOf[TrackingUrls]/impression/items/ response property's maxLength was unset from 2000 for the response status 200

    response-property-max-length-unset

  • ●

    added the new undefined enum value to the items/items/data/allOf[AdGroupCommon]/bid_strategy_type response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new optional request property items/allOf[AdGroupCommon]/optimization_goal_metadata

    new-optional-request-property

  • ○

    the request property items/allOf[AdGroupCommon]/bid_strategy_type became nullable

    request-property-became-nullable

  • ○

    added the new undefined enum value to the request property items/allOf[AdGroupCommon]/bid_strategy_type

    request-property-enum-value-added

  • ○

    added the optional property items/items/data/allOf[AdGroupCommon]/optimization_goal_metadata to the response with the 200 status

    response-optional-property-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○1See the full diff
  • ●

    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[AdGroupCommon]/campaign_id from ^\d+$ to ^[C]?\d+$

    request-property-pattern-changed

  • ○

    the items/items/data/allOf[AdGroupCommon]/campaign_id response's property pattern was changed from ^\d+$ to ^[C]?\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