Skip to content

v5.18.0

Choose a tag to compare

View all tags
@sbarahonapin sbarahonapin released this 18 Aug 21:17
· 10 commits to main since this release
v5.18.0
eb55b25
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

API Changelog (5.17.0 → 5.18.0)

Bulk Operations

POST /ad_accounts/{ad_account_id}/bulk/download

  • Added 'LABEL' enum value to entity_types.

POST /ad_accounts/{ad_account_id}/bulk/upsert

  • Added optional request properties: create/labels, update/labels.

Catalogs

GET /catalogs/feeds/{feed_id}/processing_results

  • Added optional warnings: AD_VIDEO_LENGTH_TOO_SHORT, VIDEO_DOWNLOAD_VIDEO_TOO_SHORT.

POST /catalogs/items

  • ⚠️ Added new PinMedia* schemas to media response types.
  • Many response fields changed type/format, removed old props, stricter read-only/required status.
  • Added discriminator handling.

POST /catalogs/items/batch

  • Added optional save_pin_disabled to batch properties.

GET /catalogs/processing_results/{processing_result_id}/item_issues

  • ⚠️ Added 'INSTALLMENT_PRICE', 'UNIT_PRICE_BASE_MEASURE', 'UNIT_PRICE_TOTAL_MEASURE' enums to multiple error/warning props.

GET /catalogs/product_groups/{product_group_id}/products
POST /catalogs/products/get_by_product_group_filters

  • ⚠️ Added PinMedia* schemas to product media.
  • Many board_owner, creative_type, media prop changes as above.

Pins

GET /pins

  • ⚠️ Response body now type object, added bookmark & items, error responses 401/403/404/429.

POST /pins

  • ⚠️ Request body no longer nullable.
  • ⚠️ Added PinMedia* to media field.
  • Removed: is_removable, product_tags, media_source.
  • More strict: id/is_standard/pin_metrics, new media_source options/discriminator.
  • Added 200, 401 responses.

DELETE /pins/{pin_id}

  • ⚠️ Added pin_id pattern validation, error responses 400/401/429.

GET/PATCH /pins/{pin_id}, POST /pins/{pin_id}/save

  • ⚠️ Added/changed PinMedia*, updated property types, removed obsolete properties, stricter field requirements/readonly.

Boards

GET /boards/{board_id}/pins
GET /boards/{board_id}/sections/{section_id}/pins

  • ⚠️ Added PinMedia* schemas for media, board_owner and field type changes, discriminator additions. Cleaned/properties.

Trends

GET /trends/keywords/{region}/top/{trend_type}

  • Added optional query: include_demographics, include_prediction.
  • Response includes demographics/has_prediction.

Labels

GET /ad_accounts/{ad_account_id}/labels

  • ⚠️ Changed default for entity_statuses to [ACTIVE]. Added label_types param.

PATCH /ad_accounts/{ad_account_id}/labels

  • ⚠️ Set maxLength=100 for labels/items/value.

POST /ad_accounts/{ad_account_id}/labels

  • ⚠️ Set maxLength=100 for labels/items/value.
  • Added 'CUSTOM' enum value to label_type.

Reports

POST /ad_accounts/{ad_account_id}/reports

  • Added 'LOCAL_ADS_STORE_CODE' enum value.

Search

GET /search/pins
GET /search/partner/pins

  • ⚠️ Added PinMedia* to media property, board_owner & creative_type type changes, removed old/unused fields.

Note:
PinMedia* = PinMediaWithImage, PinMediaWithVideo, PinMediaWithImages, PinMediaWithVideos, PinMediaWithImageAndVideo.
Many fields and error types harmonized for stricter validation and enum consistency.

Assets 2
Loading