Facebook 图谱 API v16.0 和市场营销 API v16.0 发布
今天，我们隆重推出 Facebook 图谱 API v16.0 和市场营销 API v16.0。作为此次版本发布的一部分，我们在下方重点列出了我们认为对部分开发者社群至关重要的变更。这些变更包括公告、产品更新和停用通知，我们认为这些变更与您的应用程序和我们平台之间的集成息息相关。
如需获取所有更改及详情的完整清单，请访问我们的更新日志。
一般公告及更新
WhatsApp Business 开放平台错误响应
我们一直在努力改善 API 错误响应行为，为此我们进行了以下更改。
- v16.0 及更高版本的错误响应中将不再包含错误子代码，这类错误子代码的使用频率较低，而且我们不应该依赖错误子代码。请改用“code”和“details”。
- 之前，错误代码 100 ("code":100) 有多个不同的名称，用于表明特定错误的性质。现在，所有代码 100 错误都将使用“Invalid Parameter”作为名称。之前用于描述特定代码 100 错误的性质的旧名称现已移至“details”属性中。此变更现在也会反映在描述代码 100 错误响应的 Webhooks 负载中。
- Webhook 错误对象已获得新的消息属性，该属性映射到 API 错误响应负载中的消息属性。
必须完成公司验证，才能获取开发者开放平台上任何 API 的高级访问级别
根据 2023 年 2 月 1 日的公告，Meta 现在要求开发者必须验证他们的公司，才能获得 Meta 开发者开放平台上任何权限的高级访问级别。将公司验证纳入我们的流程，可帮助确认公司或组织的真实性和合法性。
对于 2023 年 2 月 1 日之后创建的应用，当新应用请求获取高级访问级别时，我们将开始逐步扩大验证请求的处理数量。自 2023 年 5 月 1 日起，如果在 2023 年 2 月 1 日之前创建的应用具有高级访问级别，则必须与已认证企业相关联。如需在批准高级访问级别之前要求进行公司验证的权限列表，请访问此页面。
停用及重大变更
停用旅行意向营销方案
我们在 2018 年发布了“旅行意向营销方案”，旅游业广告主可以打开此开关，以便优先针对已经表明旅游意向但尚未决定目的地的用户投放广告。“旅行意向营销方案”搭配现有的定位选项可帮助广告主把握适当的时机，通过 Facebook、Instagram 和 Audience Network 向优质人群投放广告。在过去的 4 年里，经过持续开发机器学习系统和全面测试，现在我们无需借助此开关选项即可帮助旅游业广告主触达有旅游意向的消费者并实现类似的表现目标。
自 2023 年 2 月 2 日起，对于新广告系列，“旅行意向营销方案”选项将从广告管理工具和 API 中移除。我们已确定不再需要此开关，广告主预计在没有此开关的条件下也能获得相同成效。在过渡期间，打开或关闭此开关对广告系列的表现不会有明显的影响。
随着机器学习模型的完善，无需此开关选项也可实现相同的目标和表现，因此我们认为将其移除会提供更简化的体验。
停用潜客开发类航班广告
我们在 2018 年 9 月成功发布了潜客开发类航班广告。2021 年年中，此产品开始遭遇技术挑战，出现了导致广告系列无法有效投放的错误。因此，我们决定主动告知广告主转向其他潜客开发类选项。再营销功能仍然保留，广告主可以继续使用。
如果您或者您的合作伙伴目前正在使用“潜客开发类航班广告”，我们建议在 2023 年 5 月 1 日前关闭所有现有广告系列。
停用即阅文广告版位
自 2023 年 4 月 20 日起，我们将从 Facebook 移除即阅文和即阅文广告版位。我们于 2015 年首次推出“即阅文”功能，发行商可通过该功能创建移动端互动式媒体文章，并通过 Facebook 广告实现变现。然而，对于使用 Facebook 平台的大多数用户而言，新闻发现只是其 Facebook 体验的一小部分，并且用户表示他们希望在自己的动态中减少显示此类内容。因此，我们将调整投入，以更好地迎合用户偏好。
自 2023 年 4 月 20 日起，在广告管理工具和市场营销 API 中新建广告系列的流程中，即阅文广告版位将不再可用。2023 年 4 月 20 日以后，之前的广告组如果仅包含即阅文版位则将暂停，其他所有包含即阅文版位的广告组将自动更新，以排除此版位。
隐藏在用户个人主页中所发布内容的心情、评论和标签
在此版本中，我们将实施变更，会导致会话用户的评论、心情和标签被隐藏。用户个人主页上帖子的“via”和“sharedposts”栏位也将返回空数据集。此变更将只影响发布到用户个人主页的内容。
停止支持 1.2 版本之前的 TLS 版本
为了加强安全性，我们将停止图谱 API 对 TLS 1.2 之前的 TLS 版本的支持。如果使用的 TLS 1.2 通过 RSA 静态密钥（AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA、AES256-SHA、DES-CBC3-SHA）访问，也将停止支持。使用 TLS 旧版本创建的 API 请求将在 90 天后收到错误消息。
2023 年 5 月 1 日以后，我们还将拒绝来自使用 TLS 旧版本（TLS 1.2 之前的版本以及使用 RSA 静态密钥 [AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA、AES256-SHA、DES-CBC3-SHA] 的 TLS1.2）的浏览器访问 developer.facebook.com 的网站流量。
WhatsApp 模板类别
去年，我们在 WhatsApp 管理工具和 API 中更新了模板类别类型，以捕获在 WhatsApp Business 开放平台发送的新用例。2023 年 2 月 2 日，我们将重新命名这些模板类别，以更加精确地反映这些用例：
- 营销模板将继续命名为营销 （无更改）
- 交易类模板将重命名为实用类
- 一次性密码模板将重命名为身份验证
使用图谱 v16 创建或编辑模板的企业必须使用这些更新的模板类别。5 月 1 日，这些变更将应用于所有版本，因此，使用任何版本尝试创建或编辑模板都必须使用这些新类别。为了确保不中断模板创建或编辑流程，在 2023 年 5 月 1 日前，企业和 BSP 应该优先更新其 API 调用以使用新的类别有效值和模板。
一些其他重要日期和注意事项如下所示：
- 模板迁移：4 月 1 日，WhatsApp 会将所有现有模板迁移至新的模板类别。企业可在 WhatsApp 管理工具中查看其模板的新分类，并可在 5 月 15 日前进行复审。如果企业不同意此分类，可在 5 月 15 日前提交申诉。在 4 月 1 日至 5 月 1 日期间，使用图谱 API v15 或此前版本新建或编辑的模板将于 5 月 5 日被迁移。因此，我们建议从 4 月 1 日起开始调用 v16 创建模板。自 5 月 1 日起，WhatsApp 管理工具或图谱 API 任意版本所创建的所有模板都将使用新的模板类别。
- 新模板类别的模板创建流程：自 4 月 1 日起，在图谱 API v16 和 WhatsApp 管理工具中创建的所有模板都将要求进行类别验证以供审批。如果 WhatsApp 检测到选择的类别有误，则可能会拒绝新建或编辑的模板。拒绝原因会说明，根据我们的模板指南，所选类别与模板内容不匹配。然后，企业可以选择修改类别选项并重新提交、编辑模板或针对决定提出申诉。自 5 月 1 日起，包含变量的新建模板将要求提供嵌入式示例。自 6 月 1 日起，我们将根据模板类别的新价目表向企业收费。
Messenger API 平台
从 v16 开始，我们将移除指定消息频率的选项，以简化定期通知功能。详情请参阅 Messenger 更新日志。
API 版本停用信息：
作为 Facebook 图谱 API 和市场营销 API 版本控制计划的一部分，请注意近期的停用信息：
图谱 API
- 2023 年 2 月 23 日：图谱 API v9.0 将停用，并从开放平台移除
- 2023 年 6 月 8 日：图谱 API v10.0 将停用，并从开放平台移除
- 2023 年 9 月 14 日：图谱 API v11.0 将停用，并从开放平台移除
市场营销 API
- 2023 年 4 月 25 日：市场营销 API v14.0 将停用，并从开放平台移除
为避免对您的业务造成干扰，我们建议您将所有调用迁移到今天发布的最新版 API 中。
Facebook 开放平台 SDK
作为我们开放平台 SDK 两年停用计划的一部分，请留意近期的停用和废弃信息：
- 2023 年 6 月：Facebook 开放平台 SDK v9.0 或更低版本将废弃
- 2023 年 10 月：Facebook 开放平台 SDK v11.0 或更低版本将废弃
- 2024 年 2 月：Facebook 开放平台 SDK v12.0 或更低版本将废弃
