v5.23.0
API Changelog (5.22.0 → 5.23.0)
Ad Groups
GET /ad_accounts/{ad_account_id}/ad_groups
GET /ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}
PATCH /ad_accounts/{ad_account_id}/ad_groups
POST /ad_accounts/{ad_account_id}/ad_groups
⚠️ Changed targeting_spec/AUDIENCE_EXCLUDE and AUDIENCE_INCLUDE minItems from 100 to 0.
Ads
GET /ad_accounts/{ad_account_id}/ads
GET /ad_accounts/{ad_account_id}/ads/{ad_id}
PATCH /ad_accounts/{ad_account_id}/ads
POST /ad_accounts/{ad_account_id}/ads
- Added optional disclosure_type and disclosure_url properties to requests and responses.
Bulk Operations
POST /ad_accounts/{ad_account_id}/bulk/upsert
⚠️ Changed update/labels/items/status to not nullable.⚠️ Removed 'ACTIVE' and 'undefined' enum values from update/labels/items/status.- Added optional disclosure_type and disclosure_url to create/ads and update/ads.
Reports
POST /ad_accounts/{ad_account_id}/reports
⚠️ Updated request body schema structure (allOf changes).
POST /ad_accounts/{ad_account_id}/templates/{template_id}/reports
⚠️ Added new enum values to report_status: CANCELLED, DOES_NOT_EXIST, EXPIRED, FAILED, FINISHED, IN_PROGRESS.- Removed pattern validation from template_id parameter.
- Added error responses: 401, 403, 404, 429.
- Added 201 success response.
- report_status and template_id now required in 200 response.
Targeting Templates
GET /ad_accounts/{ad_account_id}/targeting_templates
POST /ad_accounts/{ad_account_id}/targeting_templates
⚠️ Changed targeting_attributes/AUDIENCE_EXCLUDE and AUDIENCE_INCLUDE minItems from 100 to 0.
PATCH /ad_accounts/{ad_account_id}/targeting_templates
- Added optional targeting_attributes request property.
- Added 'UPDATE' enum value to operation_type.
Trends
GET /trends/product_categories/details
GET /trends/product_categories/trending
GET /trends/topics/featured
- New endpoints added.