v5.22.0
API Changelog (5.21.0 → 5.22.0)
Ad Accounts
POST /ad_accounts/{ad_account_id}/ad_groups/audience_sizing
⚠️ Request body is now required.
GET /ad_accounts/{ad_account_id}/advertiser_defined_events
⚠️ Added mapped_conversion_type enum values: APP_OPEN, CONTACT, CUSTOMIZE_PRODUCT, FIND_LOCATION, SCHEDULE, START_TRIAL, SUBMIT_APPLICATION.
GET /ad_accounts/{ad_account_id}/audiences
⚠️ Restructured event_data: currency and line_items now use schema references (Currency, LineItem).⚠️ Removed inline currency enum values and line_items properties (product_brand, product_category, product_id, product_name, product_price, product_quantity, product_variant, product_variant_id).
Catalogs
POST /catalogs/items/batch
⚠️ Added multiple new optional attributes for retail items: ad_video_0/1/2_link, ad_video_0/1/2_tag, android_deep_link, ios_deep_link.⚠️ Hotel item guest_ratings properties (max_score, number_of_reviewers, rating_system, score) are now nullable.- Response property created_time is now required.
GET /catalogs/items/batch/{batch_id}
⚠️ Response property created_time is now nullable and required.
Integrations
POST /integrations/commerce
PATCH /integrations/commerce/{external_business_id}
⚠️ Request body is now required for both endpoints.
OAuth
POST /oauth/conversion_token
- New endpoint added.
Note: Many detailed schema changes were made to audience event_data structures and catalog item attributes. See full API documentation for complete property listings.