Introducing Facebook Graph API v12.0 and Marketing API v12.0

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

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

一般公告及更新

转化 API：扩展可调用的最低版本

针对利用一键式访问口令创建的应用提供图谱 API 向后兼容性从 v12.0 开始，在事件管理工具的转化 API 设置选项卡中生成的新建访问口令，现在受到所有可用图谱 API 版本的支持（在此处查看支持的版本）。

请注意，使用这些口令向已停用的图谱 API 版本发出的调用将自动解析为最早的可用版本。此行为仅适用于图谱 API 端点。市场营销 API 端点（包括转化 API）不支持自动升级行为，并将抛出异常。

针对 Instagram 收发消息功能的用户个人主页 API：新字段

我们将改进针对 Instagram 收发消息功能的用户个人主页 API。此前，Instagram 用户个人主页 API 支持两种字段：1) 名称和 2) 头像网址。为了允许企业根据公开可用的用户信息更好地定制和优先显示消息，我们更新了 API，将以下信息也包含在内：

1.粉丝数量
2.认证徽章
3.企业关注用户帐户 [是/否]
4.用户帐户关注企业帐户 [是/否]

请参阅开发者文档了解详情。

详细定位新机会

为帮助广告主发现原先不可用的其他机会，我们会在广告主利用详细定位，并使用转化量目标优化转化、值或应用事件时，自动将其纳入定位扩展。如需了解更多信息，请参阅详细定位扩展帮助中心文章。

视频 API：新字段

我们在 [视频] 节点中添加了两个新字段：views 和 post_views。请查看视频 API 开发者文档了解详情。

停用及重大变更

错误透明度

图谱 API 和市场营销 API 默认行为是，当应用在节点上请求可返回一个或多个关联节点的字段或连线，但缺少关联节点所需的相应权限时，便产生错误。但是，当出现调用应用缺少相应权限的情况时，其中一些字段和连线并不遵循此协议，而是直接从 API 响应中省略。

从 v12.0 开始，这些字段和连线将遵循默认行为。从 2021 年 12 月 13 日起，此更改将应用于所有版本。

• 受影响的图谱 API 端点
• 受影响的市场营销 API 端点

系统用户及应用身份

我们将停用为系统用户授予应用身份的功能，除非用户和应用同属于一家公司。为了避免应用和业务的中断，我们建议您将这些系统用户从应用中移除，并改用代客管理 API。此重大变更将于 2021 年 12 月 13 日生效。

排期直播

我们将在 Live API 的排期功能中停用 planned_start_time 参数，此重大变更将于 2021 年 12 月 13 日生效。新参数将于未来公布。

Messenger 开放平台：转化 API

我们将停用转化 API 对话元数据中的 user_id 字段。所有开发者都需要将任意引用迁移至 user_id (IGID)，并完全依赖 (IGSID)，将其作为用户和公司之间对话的主要标识符。

此重大变更将于 2021 年 12 月 13 日在之前的图谱 API 版本上生效。请查看转化 API 开发者文档了解详情。

Messenger 开放平台：Instagram Webhooks

为了更好地支持表情符号心情，我们将针对 IG 心情 Webhooks 更新 Messenger API。当前版本会将表情符号字段以字符串形式返回，而在此次更新后，心情 Webhooks 将返回新的 unicode 格式。请注意，“心情”字段将只支持默认表情符号。而对于其他所有表情符号，“心情”字段则会返回“其他”（与 MSGR 相同）。

从 2021 年 12 月 13 日开始，此重大变更将在之前的图谱 API 版本上生效。为了继续支持表情符号心情，所有开发者都需迁移至新的 unicode（将于 2021 年 12 月 13 日之前返回）。请参阅 Webhooks 开发者文档了解详情。

API 版本停用信息：

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

图谱 API

• 2021 年 11 月 2 日：图谱 API v4.0 将被停用，并将从平台中移除
• 2022 年 2 月 3 日：图谱 API v5.0 将被停用，并将从平台中移除
• 2022 年 5 月 22 日：图谱 API v6.0 将被停用，并将从平台中移除

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

市场营销 API

• 市场营销 API v10.0 将于 2021 年 10 月 4 日停用
• 市场营销 API v11.0 将于 2022 年 2 月 23 日停用

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

Facebook 开放平台 SDK

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

常规停用信息

停用原生优惠端点

在 2021 年 6 月 8 日，我们宣布将停用优惠广告 API。此停用将随图谱 API v12.0 的发布立即生效。

Messenger 开放平台 - 航班信息模板

在 2021 年 6 月 8 日，我们宣布将停用航班信息模板。此停用将于 2021 年 12 月 6 日生效。