Skip to content

v5.15.0

Choose a tag to compare

@thisjuvy thisjuvy released this 11 Jun 22:27
· 16 commits to main since this release
57cb6b2

What's Changed

Pins

GET /pins

  • Removed media_type from response, added support for video cover frame time and improved video media structure.

POST /pins

  • Removed media_type, added sponsor_id and video cover frame time, improved media schema. Now supports client_credentials.

DELETE /pins/{pin_id}

  • Now supports client_credentials security.

GET /pins/{pin_id}

  • Same as GET /pins: removed media_type, added video frame time, improved media schema.

PATCH /pins/{pin_id}

  • Removed media_type, added video cover frame time. Now supports client_credentials.

POST /pins/{pin_id}/save

  • Same media property changes as POST /pins.

GET /search/partner/pins

  • Removed media_type, improved media structure and added ID property.

Ad Accounts

GET /ad_accounts

  • Now supports client_credentials.

POST /ad_accounts

  • Added optional property: currency.

GET /ad_accounts/{ad_account_id}

  • Now supports client_credentials.

Campaigns

GET /ad_accounts/{ad_account_id}/campaigns

  • Added automated and Performance+ campaign properties.
  • Now supports client_credentials.

PATCH /ad_accounts/{ad_account_id}/campaigns

  • Added automated, Performance+ campaign properties; removed old automated property.

GET /ad_accounts/{ad_account_id}/campaigns/{campaign_id}

  • Added automated and Performance+ campaign properties.
  • Now supports client_credentials.

GET /ad_accounts/{ad_account_id}/campaigns/analytics

  • Analytics: campaign_id now optional, added aggregate reporting support.

Ad Groups

GET /ad_accounts/{ad_account_id}/ad_groups

  • Added creative optimization, promotion ID, bid multiplier; expanded age targeting with 19+ and 20+.
  • Now supports client_credentials.

PATCH /ad_accounts/{ad_account_id}/ad_groups

  • Frequency goal min/max changed (2–20); added creative optimization, promotion ID, bid multiplier, new age buckets.

GET /ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}

  • Same new fields as GET.
  • Now supports client_credentials.

Ads

GET /ad_accounts/{ad_account_id}/ads

  • Added new CTAs (e.g., "BUY_TICKETS", "DONATE_NOW", "DOWNLOAD", "PLAY_GAME", "TRY_IT"). Now supports client_credentials.

PATCH /ad_accounts/{ad_account_id}/ads

  • Same as above for CTAs and property expansions.

POST /ad_accounts/{ad_account_id}/ads

  • Same as above for CTAs and property expansions.

Audiences

GET /ad_accounts/{ad_account_id}/audiences

  • Added created_by_company_name.
  • Now supports client_credentials.

POST /ad_accounts/{ad_account_id}/audiences

  • Added created_by_company_name.

POST /ad_accounts/{ad_account_id}/audiences/custom

  • Added created_by_company_name.

PATCH /ad_accounts/{ad_account_id}/audiences/ad_accounts/shared

  • Added permissions: CATALOGS_VIEWER, FINANCE_EDIT, FINANCE_VIEW.

PATCH /ad_accounts/{ad_account_id}/audiences/businesses/shared

  • Added permissions: CATALOGS_VIEWER, FINANCE_EDIT, FINANCE_VIEW.

GET /ad_accounts/{ad_account_id}/audiences/shared/accounts

  • Now supports client_credentials.

Promotions

POST /ad_accounts/{ad_account_id}/promotions

  • New endpoint for promotion creation.

PATCH /ad_accounts/{ad_account_id}/promotions

  • New endpoint for updating promotions.

DELETE /ad_accounts/{ad_account_id}/promotions/{promotion_id}

  • New endpoint for deleting promotions.

GET /ad_accounts/{ad_account_id}/promotions/{promotion_id}

  • New endpoint for retrieving promotion details.

Conversion Tags

GET /ad_accounts/{ad_account_id}/conversion_tags

  • Added support for external measurement ID.
  • Now supports client_credentials.

POST /ad_accounts/{ad_account_id}/conversion_tags

  • Added support for external measurement ID.

GET /ad_accounts/{ad_account_id}/conversion_tags/{conversion_tag_id}

  • Added support for external measurement ID.
  • Now supports client_credentials.

Catalogs & Product Groups

POST /catalogs/products/get_by_product_group_filters

  • Expanded filtering with new custom label operators/types.
  • Removed media_type from product pin media.

GET /catalogs/feeds

  • Now under catalog_feeds API tag; improved error/warning reporting.

POST /catalogs/feeds

  • Now under catalog_feeds, improved handling of warnings/errors.

PATCH /catalogs/feeds/{feed_id}

  • Now under catalog_feeds tag, expanded warnings.

DELETE /catalogs/feeds/{feed_id}

  • Now under catalog_feeds tag.

POST /catalogs/feeds/{feed_id}/ingest

  • Now under catalog_feeds tag.

GET /catalogs/feeds/{feed_id}

  • Now under catalog_feeds tag.

GET /catalogs/feeds/{feed_id}/processing_results

  • Now under catalog_feeds tag.

Miscellaneous

GET /businesses/{business_id}/members/{member_id}/assets

  • Added CATALOG asset type, added catalog IDs in response.

GET /businesses/{business_id}/partners/{partner_id}/assets

  • Same as above.

PATCH /businesses/{business_id}/partners/assets

  • Permissions: added CATALOGS_VIEWER, FINANCE_EDIT, FINANCE_VIEW.

POST /businesses/{business_id}/requests/assets/access

  • Permissions: added CATALOGS_VIEWER, FINANCE_EDIT, FINANCE_VIEW.

Full Changelog: v5.14.0...v5.15.0