ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

ad_groups

Changes to List ad groups

get/ad_accounts/{ad_account_id}/ad_groups

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  for the query request parameter order, default value ASCENDING was added
- breaking
  the response's body type changed from no type to object for status
- info
  removed subschema #2 from the response body allOf list for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
Dec 11, 2025v5537bde5a50b1 Revision changes
- breaking
  the ///////// response property's minItems was decreased from 100 to 0 for the response status
- breaking
  the ///////// response property's minItems was decreased from 100 to 0 for the response status
Dec 10, 2025v56768e3ca1ffa Revision changes
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
Oct 16, 2025v514c297539b64 Revision changes
- info
  for the query request parameter ad_group_ids, the maxItems was increased from 100 to 250
- info
  for the query request parameter campaign_ids, the maxItems was increased from 100 to 250
Aug 12, 2025v58fb7ab040159 Revision changes
- info
  added the optional property ///////////// to the response with the status
Jul 16, 2025v543134ca41f18 Revision changes
- info
  added the optional property /////// to the response with the status
Apr 4, 2025v510f9eba4ad97 Revision changes
- warning
  added the new 19+ enum value to the ///////// response property for the response status
- warning
  added the new 20+ enum value to the ///////// response property for the response status
- info
  the endpoint scheme security client_credentials was added to the API
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //// to the response with the status
Apr 23, 2024v5f9321315766f Revision changes
- breaking
  the response's property type changed from no type to object for status
- warning
  removed the optional property //////// from the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
Feb 8, 2024v57529b464d5cb Revision changes
- warning
  added the new DELETED_DRAFT enum value to the /////////// response property for the response status
- warning
  added the new DELETED_DRAFT enum value to the //////// response property for the response status
- warning
  added the new DRAFT enum value to the /////////// response property for the response status
- warning
  added the new DRAFT enum value to the //////// response property for the response status
- info
  added the enum value DELETED_DRAFT to the property items/ of the query request parameter entity_statuses
- info
  added the enum value DRAFT to the property items/ of the query request parameter entity_statuses
- info
  the response's property default value ALL was added for the status
Aug 17, 2023v50ff12596bafd Revision changes
- warning
  added the new TWENTY_FOUR_HOUR enum value to the ///////////// response property for the response status
May 12, 2023v5689b4b267639 Revision changes
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added to the /////// response property allOf list for the response status
- info
  removed the BILLABLE_ENGAGEMENT enum value from the /////// response property for the response status
- info
  removed the CBO_ADGROUP enum value from the /////// response property for the response status
- info
  removed the DAILY enum value from the /////// response property for the response status
- info
  removed the LIFETIME enum value from the /////// response property for the response status
Feb 14, 2023v5be19b77aa78a Revision changes
- breaking
  for the query request parameter entity_statuses, default value ACTIVE PAUSED was added
- breaking
  the response property /////// became nullable for the status
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- warning
  added the new undefined enum value to the /////// response property for the response status
- info
  added the optional property /////// to the response with the status
Nov 14, 2022v5e041d7b0cef0 Revision changes
- breaking
  for the path request parameter ad_account_id, the maxLength was decreased from 19 to 18
- info
  for the query request parameter page_size, the max was increased from 100.00 to 250.00
Sep 7, 2022v5bd20b6eb152f Revision changes
- warning
  for the path request parameter ad_account_id, the maxLength was set to 19
- info
  the /////// response's property pattern was changed from ^\d+$ to ^[C]?\d+$ for the status
Jul 11, 2022v50d5998752011 Revision changes
- breaking
  the // response's property type changed from no type to object for status
- info
  api tag ad_groups added
- info
  api tag ad_accounts removed
- info
  added subschema #2 to the // response property allOf list for the response status
- info
  removed subschema #1 subschema #2 from the // response property allOf list for the response status
Dec 16, 2021v52a34d1d22a47 Revision changes
- warning
  changed the pattern of the path request parameter ad_account_id from \d+ to ^\d+$
Nov 5, 2021v58583f6373a80 Revision changes
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the //// response's property type changed from no type to object for status
- info
  added the non-success response with the status