图谱 API

版本 2.10

图谱 API | 市场营销 API

更新日志条目分类如下：

  • 新功能 — 新推出的产品或服务，包括新的节点、连线和字段。
  • 变更 — 对现有产品或服务的更改（不包括停用内容）。
  • 停用内容 — 将被移除的现有产品或服务。
  • 90 天重大变更 — 将在版本发布日期后 90 天内生效的变更和停用内容。

新功能、变更和停用内容只会影响本版本。90 天重大变更则会影响所有版本。

这里并不包含重大变更，因为重大变更不限于特定版本。

图谱 API

发布日期 2017 年 7 月 18 日 | 停用日期 2019 年 11 月 7 日

新功能

Webhooks

  • 主页活动 Webhooks — 以下操作现在将为主页 feed 字段订阅触发更新：

    • 自动发布排期的活动
    • 评论活动动态
    • 创建和发布活动
    • 发布草稿活动

更改

花费额度委托

  • GET /{extended-credit-id} — 以下字段已重命名：

    • 将 invoice_email 改为 extended_credit_emails
    • 将 invoice_group 改为 extended_credit_invoice_groups
    • 将 sequential_liability_amount 改为 allocated_amount

  • GET /{extended-credit-id} — 以下字段已添加：

    • liable_biz_name fields
    • owner_business field，包含子字段 id 和 name
    • owning_credit_allocation_configs
    • send_bill_to_biz_name

  • GET /{extended-credit-id} — 以下字段已删除：

    • business_id field

  • extended_credit_invoice_groups — 以下子字段已添加：

    • ad_accounts，包含子字段 account_id 和 name
    • email
    • id
    • name

  • CurrencyAmount — 以下字段现在将返回一个 CurrencyAmount 对象，而不是仅仅返回金额：

    • allocated_amount
    • balance
    • max_balance
    • online_max_balance

主页

用户

Webhooks

  • 执行应用限制 — 为不符合应用限制条件（如国家/地区或年龄）的用户指定访问口令会导致出错，除非在请求中指定 appsecret_proof。

停用内容

事件

  • GET /{event-id}/videos — 此连线已删除。

90 天重大变更

评论

  • POST 和 DELETE /{comment-id} — 此节点现在要求有效的主页访问口令。

  • POST and DELETE /{object-id}/comments — 此节点现在要求有效的主页访问口令。

  • GET /{object-id}/comments — 此连线现在要求有效的访问口令。

网址

  • POST /{url} — 此节点现在要求有效的访问口令。

  • GET /{url} — og_object 现在不会默认返回，但必须包含在字段参数中。

  • /{url} 抓取 — GET 请求不再抓取网址。现在必须使用 POST /{url} 抓取网址。

帖子

  • /{post-id} — 此节点现在要求有效的访问口令。

视频

  • /{video-id} — 此节点现在要求有效的主页访问口令。

Marketing API

Released July 18, 2017 | Available until May 8, 2018

New Features

  • No new features.

Changes

  • No changes.

Deprecations

  • No deprecations.

90-Day Breaking Changes

  • No 90-day breaking changes.

Breaking Changes in Marketing API v2.10

Ads Management

  • Holdout fields - The following fields have been deprecated from POST /{ad_account_id}/ads and GET /{ad_id}:

    • holdout_end
    • holdout_hash
    • holdout_start
    • no_show_offset
    • no_show_percentage
    • show_end
    • show_start

  • POST /{ad_account_id}/adcreatives - The following parameter is now deprecated:

    • follow_redirect

  • creative_rotation_parameter and creative_rotation type from GET ADSET_ID and POST AD_ACCOUNT_ID/adsets are deprecated.

  • Real-time bidding partner GET endpoints are deprecated. This includes GET /RTB_PARTNER_ID and GET /RTB_PARTNER_ID/stats endpoints. We also removed the field rtb_flag from POST /ADSET_ID and POST /ADGROUP_ID.

Signals and Targeting

  • Reach and Frequency Predictions - As of 2.10 we now provide target_spec as a JSON object; you no longer have to parse the response into JSON.

Insights

  • Breakdowns - The following types have been deprecated for the action_link_click_destination breakdown. See Insights, Breakdowns.

    • app_store_clicks
    • deeplink_clicks
    • website_clicks

Replaced by:

  • click_to_app_store
  • click_to_app_deeplink
  • click_to_website