v5.17.0
API Changelog
Ad Groups
GET /ad_accounts/{ad_account_id}/ad_groups
- Added
reporting_eventproperty to conversion tag v3 goal metadata.
POST /ad_accounts/{ad_account_id}/ad_groups
- Added
reporting_eventproperty to conversion tag v3 goal metadata in requests and responses.
PATCH /ad_accounts/{ad_account_id}/ad_groups
- Added
reporting_eventproperty to conversion tag v3 goal metadata in requests and responses.
GET /ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}
- Added
reporting_eventproperty to conversion tag v3 goal metadata.
Ad Previews
POST /ad_accounts/{ad_account_id}/ad_previews
- Added
preferred_media_typeproperty for shopping ad previews. - Added
video_tagproperty for shopping ad previews.
Bid Floor
POST /ad_accounts/{ad_account_id}/bid_floor
- Added
reporting_eventproperty to conversion tag v3 goal metadata in bid floor specs.
Bulk Operations
POST /ad_accounts/{ad_account_id}/bulk/upsert
- Added
reporting_eventproperty to conversion tag v3 goal metadata for both create and update ad group operations.
Promotions
GET /ad_accounts/{ad_account_id}/promotions
⚠️ Added newCUSTOMenum value to promotion types.- Added
custom_textproperty to template values.
POST /ad_accounts/{ad_account_id}/promotions
⚠️ Added newCUSTOMenum value to promotion types for requests and responses.- Added
custom_textproperty to template values.
PATCH /ad_accounts/{ad_account_id}/promotions
⚠️ Added newCUSTOMenum value to promotion types for requests and responses.- Added
custom_textproperty to template values.
GET /ad_accounts/{ad_account_id}/promotions/{promotion_id}
⚠️ Added newCUSTOMenum value to promotion types.- Added
custom_textproperty to template values.
Reports
POST /ad_accounts/{ad_account_id}/reports
⚠️ Updated request body schema structure.
GET /ad_accounts/{ad_account_id}/reports/brand_category_sku
- � New endpoint added.
POST /ad_accounts/{ad_account_id}/reports/brand_category_sku
- � New endpoint added.
Catalogs
POST /catalogs
- Added new
RETAILenum value to catalog types.
POST /catalogs/feeds
⚠️ Madecatalog_idnon-nullable for hotel and creative assets feeds.- Added optional
catalog_idfor retail feeds.
POST /catalogs/items
- Added
promotion_idproperty to retail item attributes.
POST /catalogs/items/batch
- Added optional
catalog_idfor retail batch requests. - Added
promotion_idproperty support across all retail item operations (create, update, upsert).