Facebook 图谱 API v13.0 和市场营销 API v13.0 简介

今天，我们隆重推出 Facebook 图谱 API v13.0 和市场营销 API v13.0。在下文中，我们重点介绍了将对开发者社群中部分人员造成影响的变化。这些变化包括公告、产品更新、之前发布的提醒和大规模停用的通知，这些可能会影响您的应用程序与我们开放平台之间的集成。

如需查看所有变更的完整清单及有关详情，请访问我们的更新日志。

一般公告及更新

开放平台选择更新

未来几周，您需在基本设置页面至少为应用选择一个开放平台并提供相关信息，以确保应用可供审核。此外，您还要确保每个开放平台的相关信息（如网站网址、Apple App Store 编号和 Android 密钥哈希值等）均可访问。如果未满足这些要求，则只有在应用中拥有相应身份的应用用户才能使用应用。

如果应用当前不符合此要求，我们首先会向开发者发送一封警告邮件，并提供一周时间来解决问题，之后再视情况决定是否停用应用。问题一经修复，我们即会恢复权限和功能访问权。

通过成效驱动型广告体验简化广告目标

正如在 2021 年 12 月宣布的那样，我们已重新设计在广告管理工具中创建新广告系列时的目标选择体验。我们将转向基于成效的广告管理工具，广告主可以在该工具中选择其预期的业务成效（如知名度、流量、互动率、潜在客户、应用推广、销量），而后工具界面会引导广告主采用最优广告系列设置/创建路径以取得该成效。2022 年，我们将在广告管理工具中逐步推出这一新体验。

阅读我们的开发者博客，详细了解这会对开发者带来何种影响。建议开发者在 2022 年 4 月底之前执行这些新 API 变更。

市场营销 API：简化定位

2022 年 1 月 19 日，我们作出相关变更，对于在用户看来可能比较敏感的话题，我们移除了与其相关的详细定位选项，以此来精简定位服务。

市场营销 API：类似受众新机会

为帮助广告主发现原先不可用的其他机会，自图谱 API v13.0 起，我们会在广告主利用类似受众，并使用转化量目标优化转化、值或应用事件时，自动将这些受众纳入定位扩展。详情请参阅类似受众定位扩展帮助中心文章。

目录：更新 XML_JUNK_AFTER_DOCUMENT

为了更加清晰透明，自图谱 API v13.0 起，产品动态上传错误代码 XML_JUNK_AFTER_DOCUMENT 已更名为 DATA_OUTSIDE_XML_TAGS。这只是一项名称变更，适用于市场营销 API v13.0 及以上版本。

权限访问更新

自 v13.0 起，对于授予公司资产访问权的权限，只有代表其他公司管理集成的应用才能请求此类权限的高级访问权。只为自己的公司管理集成的应用无需获取这些权限的高级访问权。我们还宣布，线索检索 API 权限的标准访问权现将包括对 Webhooks 和 usergen 响应的访问权。

提醒

WhatsApp Business API：基于对话的定价

正如在 2021 年 6 月宣布的那样，我们将于 2 月 1 日推出基于对话的定价。根据 WhatsApp Business 商业帐号 (WABA) 所在时区，我们将于 2022 年 2 月 1 日 0 时正式转向基于对话的定价。

需要采取的行动：必须为所有 WABA 附加支付方式，才能享有每月超过 1,000 次对话的服务。每月前 1,000 次对话免费，无需附加支付方式也可使用。点击此处详细了解如何附加支付方式。

• 开发者文档：
  • 新增对话 Webhooks，用于实时追踪对话。我们已于 2021 年 10 月 1 日在 v2.37 中发布这些 Webhooks。版本必须为 v2.37（或可用的更高版本）才能使用此功能。
  • 新对话分析已自 2022 年 2 月起推出，可通过 WhatsApp Business 管理 API 使用

Instagram 视频：合并 IGTV 与动态视频

正如在 2021 年 10 月宣布的那样，我们正将 IGTV 和动态视频合并为一种格式：Instagram 视频。在应用内，IGTV 选项卡已被替换为合并后的新“视频”选项卡，所有视频都将显示在此处。也就是说，日后所有长度的视频都不再有标题，而且也不再区分动态视频和 IGTV 视频。

对当前所有 API 版本中的所有 Instagram 视频而言：

• Instagram 媒体 media_product_type 将只返回 FEED（即无法返回 IGTV）
• 将不会返回 Instagram 媒体 video_title
• 将支持 Instagram Webhooks 评论与提及字段

2 年后，我们将停用 Instagram 媒体 video_title；若之后请求该媒体，系统将抛出错误。

开发者政策 5.5

我们已更新开发者政策，力求进一步增强我们为用户、企业和开发者构建安全开放平台的承诺。随着开发者政策 5.5 的发布，我们对累犯行为及可能采取的应对措施提供了一个清晰的立场。累犯是指使用新应用或帐户反复进入我们的开放平台以规避强制措施，试图重复做出违反政策行为的开发者、行为者或企业。

开发者政策 5.5 载明：
“如果您为了规避或试图规避我们的政策执行措施而创建或维护应用，我们可以采取一系列政策执行措施，包括永久移除您的应用和开发者帐户。试图规避的行为可能包括：创建或维护应用，以绕过我们以您违反我们的条款和政策为由对您的其他应用或开发者帐户施加的任何限制或政策执行措施。”

停用及重大变更

API 版本停用信息：

作为 Facebook 图谱 API 和市场营销 API 版本控制计划的一部分，请注意即将停用的相关内容：

图谱 API

• 2022 年 2 月 3 日：图谱 API v5.0 将被停用并从开放平台中移除
• 2022 年 5 月 5 日：图谱 API v6.0 将被停用并从开放平台中移除
• 2022 年 8 月 4 日：图谱 API v7.0 将被停用并从开放平台中移除

为避免您的业务出现中断，我们建议您立即将所有调用迁移到已发布的最新 API 版本中。

市场营销 API

• 市场营销 API v11.0 将于 2022 年 2 月 23 日停用
• 市场营销 API v12.0 将于 2022 年 8 月 9 日停用

为避免您的业务出现中断，我们建议您立即将所有调用迁移到已发布的最新市场营销 API 版本中。（详情请参阅更新日志）

Facebook 开放平台 SDK

• 在 2021 年 1 月 19 日，我们针对 Facebook 开放平台 SDK v8.x 及更低版本推出了为其两年的停用计划。我们将于 2023 年 1 月淘汰这些版本。
• 2021 年 10 月 12 日，我们发布了 Facebook 开放平台 SDK v12.0，以此开始了为期两年的 Facebook 开放平台 SDK v11.0 停用计划。SDK v11.0 将于 2023 年 10 月淘汰。