7.0 版本

图谱 API

发布日期 2020 年 5 月 5 日 | 停用日期 2022 年 8 月 4 日 | 博文

Facebook Business 扩展程序 v2

此更改适用于所有版本。

Facebook Business 扩展程序 v2 中新增了两个字段。

  • 广告帐户编号 (ad_account_id) — 代表用户在 FBE 内选择的广告帐户编号。如果您的应用具有 ads_management 权限,您便可使用此广告帐户来管理广告。

  • 目录编号 (catalog_id) — 用户在 FBE 内选择的目录编号。用户可使用此编号管理其商品目录。

Instagram

话题标签搜索

此更改适用于 7.0 及更高版本。

您现在可以请求 GET /{ig-hashtag-id}/top_mediaGET /{ig-hashtag-id}/recent_media 话题标签搜索查询所返回的 Instagram 媒体timestamp 字段。例如:GET /{ig-hashtag-id}/top_media?fields=timestamp

Messenger

客户聊天插件

此更改适用于 7.0 及更高版本,并将从 2020 年 11 月 2 日起适用于所有版本。

通过客户聊天插件开始新对话或继续已有对话时,初始的 messaging_postbacksmessaging_referrals Webhooks 通知将包含用户的匿名 user_ref 编号,而不是公共主页范围编号 (PSID)。用户发送消息后,后续 Webhooks 通知将包含该用户的 PSID。

公共主页 Messenger 个人主页

此更改适用于 7.0 及更高版本。

对于所有操作(GETPOSTDELETE)而言,公共主页 Messenger 个人主页home_url 属性已停用。

开放图谱

停用

此更改适用于 7.0 及更高版本,并将从 2020 年 8 月 3 日起适用于所有版本。

公共主页

应用范围用户编号

这些更改适用于 7.0 及更高版本,并将从 2021 年 5 月 5 日起适用于所有版本。

从 2018 年 5 月 1 日起,公共主页 API 开始为所有新应用返回公共主页范围用户编号 (PSID),而不是应用范围用户编号 (ASID)。除非选择接收 PSID,否则在该日期前创建的应用会继续收到 ASID。现在所有应用都会通过公共主页 API 收到 PSID。

借助公共主页范围编号 API,您可以将 ASID 与对应的 PSID 相匹配。此 API 已在 7.0 及更高版本中停用,但在 2021 年 5 月 5 日之前可与旧版本配合使用。

停用

这些更改适用于 7.0 及更高版本,并且从 2020 年 8 月 3 日起将适用于所有版本。

以下端点已停用:

权限

manage_pages 权限已停用,并被以下 4 项全新权限所替代:

publish_pages 权限已停用,并被以下 2 项全新权限所替代:

如果应用已获得 manage_pagespublish_pages 权限的其中之一(或全部)的授权,我们会在 2020 年 6 月 1 日前将该应用迁移到新权限。

如果应用已请求 manage_pagespublish_pages 权限的其中之一(或全部),但是审核尚未完成,则审核流程将继续正常进行。在应用获得授权后,我们会在 2020 年 6 月 1 日前将其迁移到新权限。

如要在 2020 年 6 月 1 日前申请或重新请求公共主页权限,请选择您在应用面板中看到的权限:manage_pagespublish_pages 的其中之一(或全部)或者新的权限。如有必要,系统会在 2020 年 6 月 1 日前自动将您的应用迁移到新权限。

2020 年 6 月 1 日之后,应用面板的应用审核 > 权限与功能选项中将不再有 manage_pagespublish_pages

manage_pagespublish_pages 权限将于 2022 年 5 月完全停用。如果您要更改代码,请务必在此日期前应用更改。

SDK

请访问 iOS SDK 更新日志Android SDK 更新日志,了解即将对这些 SDK 作出的重大更改。

用户

停用

这些更改适用于 7.0 及更高版本,并且从 2020 年 8 月 3 日起将适用于所有版本。

以下端点已停用:

市场营销 API

发布日期 2020 年 5 月 5 日 | 停用日期 2021 年 3 月 3 日 | 博文

广告系列

广告系列预算优化

此更改适用于 7.0 及更高版本。

您无法再为具体广告系列同时设置 lifetime_budgetspend_cap,而是只可以选择 lifetime_budget

广告系列总预算将分摊到广告系列的全过程中。您在广告系列层级使用 lifetime_budget 时,当中便已包含花费上限信息。因此您无需再添加另一个花费上限。

如果广告系列未使用广告系列预算优化,您仍然可以使用 spend_cap

特殊广告类别

此更改适用于 7.0 及更高版本。

POST /act_<AD_ACCOUNT_ID>/campaigns 端点的 special_ad_category 参数已停用并被替换为全新的 special_ad_categories 参数。

全新的 special_ad_categories 参数是必要项,而且支持使用数组。如果您使用 special_ad_category 参数,端点仍然会返回字符串,但是您应该使用 GET /{campaign-id}?fields=special_ad_categories,以便返回数组。

详情请参阅特殊广告类别

详情请参阅广告帮助中心 > 特殊广告类别

停用

此更改适用于 7.0 及更高版本。

budget_rebalance_flag 参数已停用。推荐您改用广告系列预算优化

Atlas 广告系列

停用

此更改适用于 7.0 及更高版本。

  • GET /{atlas-ad-campaign-id}/cumulative_edited_date

商品目录

停用

此更改适用于 7.0 及更高版本。

第三方应用 POST /PRODUCT_CATALOG_ID 连线上的 cpas_parent_catalog_settings 参数已停用。