返回开发者新闻

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

2021年6月8日发布者:Kirk Thaker

今天,我们隆重推出 Facebook 图谱 API v11.0 和市场营销 API v11.0。在本版本中,我们将创建博文,以强调会影响部分开发者社群的众多变化。这些变化包括公告、产品更新、之前发布的提醒和大规模停用的通知,这些可能会影响您的应用程序与我们平台之间的集成。

有关所有更改及详情的完整列表,请浏览我们的更新日志

一般公告及更新

将图谱 API 访问级别模型扩展到消费者应用程序

2021 年 5 月 6 日,Facebook 开始将图谱 API v8.0 引入的数据访问级别功能扩展到消费者应用。这次推行将会在六月末或七月初完成。这种模式可令用户更易于测试新权限和新功能,因为在应用中有角色的任何用户都可以授予应用任何未经批准的权限或功能,而不必切换到开发者模式或使用测试应用。

这一功能将在未来几周内针对所有新创建的消费者应用推出。需要注意的是,在新推出的功能中,新的消费者应用必须设置为已发布模式,并将 public_profile 权限设置为高级访问权限,这样那些在应用中没有角色的用户才能使用 Facebook 登录进行身份验证。public_profile 和 email 权限可自动批准为高级访问权限,但默认设置为标准访问权限。

请参考我们的访问级别开发者文档,详细了解访问级别对消费者应用的影响方式。

添加 Instagram ASID 及开放平台版本管理

自 2021 年 6 月 8 日开始Instagram 基本显示 API 现将支持版本管理功能。您现在可以将同样的版本请求协议用作 Facebook 图谱 API,在所有的 graph.instagram.com 端点执行有版本号的调用。

另外,在本版本中,Instagram 推出了应用范围编号 (ASID),这是每个应用和用户对唯一的用户编号。

新版 oEmbed Read 功能及应用审核

自 2021 年 6 月 8 日开始,oEmbed 产品已经被新 oEmbed Read 功能所取代。已经实施 Facebook oEmbedInstagram oEmbed 的开发者必须在 2021 年 9 月 7 日前获得应用审核的批准,然后才能获准使用新 oEmbed Read 功能,否则它们的 oEmbed 集成将被取消。可以在应用创建期间或之后的任何时间将需要访问的新应用提交审核。

删除受众

受众删除 API 的更改

Facebook 一直在努力改善广告主创建并管理其受众自定义受众(客户列表自定义受众除外)、类似受众已保存受众的方式,其中超过两年未在投放中的广告组中得到使用的用户将被自动删除。

对于自定义名单自定义受众来说,Facebook 将继续按照广告主的指示存储和删除这些信息。如果广告主在指定时间内选择不使用标记为“即将到期的受众”的受众,Facebook 会将此视为删除受众的指令。

此外,进一步说明,任何自定义受众(自定义名单自定义受众除外)、类似受众或保存的受众如果超过两年未在投放中的广告组中得到使用,系统会将其自动标记为“即将到期的受众”,并且会在 90 天后被当作即将到期的受众而遭到自动删除。

将推出的改变有:

  • 自 2021 年 6 月 8 日开始,面向可使用市场营销 API 的广告主推出(包括那些同时使用市场营销 API 和 Facebook 用户界面进行广告管理的广告主),并将影响所有现有的 API 版本。受影响的受众将于 2021 年 9 月 6 日自动删除,除非广告主采取行动使用标记受众。
  • 2021 年 5 月 13 日后,面向未使用市场营销 API 进行广告管理的广告主推出。受影响的受众将于 2021 年 6 月 27 日自动删除,除非广告主采取行动使用标记受众。

基于已删除 Facebook 公共主页的用户删除

改善广告主创建和管理其受众的方式是我们长期计划中的一环,我们将会对其做出一些变更,这项变更会影响互动自定义受众、关联类似受众以及从被删除的 Facebook 公共主页创建的已保存受众。我们希望充分减小对大多数广告主的影响。

2021 年 9 月 8 日开始,面向可使用市场营销 API 的广告主推出:互动自定义受众(公共主页、视频、线索表单、活动、即时体验、购物)、相关的类似受众以及保存的受众。通过使用已删除的 Facebook 公共主页创建的保存受众将被标记为“警告状态”,经过 30 天的宽限期,系统会将其自动删除。在此截止日期前,可以继续创建和计划新营销活动。

此外,在 2021 年 9 月 8 日之后,广告主将不能从已删除的 Facebook 公共主页中创建这些互动自定义受众类型或类似受众。

隆重推出 Facebook 开放平台 SDK v11.0

自 2021 年 6 月 8 日起,Facebook 将推出开放平台 SDK v11.0。随着本版本的发布,我们会停用 v9.0,并引入几个功能的更新。请访问 iOS SDK 更新日志Android SDK 更新日志 Unity SDK 更新日志,了解这些 SDK 即将发生的重要变化。此外,Facebook 还已发布一个单独的博文,以强调这些更新。

端点指定公告及动态更新

user_likes 和 user_posts 的指定权限使用实例

自 2021 年 6 月 8 日起,为降低我们在开放平台上的风险,我们正在进一步指定 user_likesuser_posts 两者的允许使用实例。如果您的应用目前能访问 user_likes 和/或 user_posts,并且您的用例与更新的允许使用实例不一致,那么直到 2021 年 9 月 6 日,您必须在您的应用做出必要的改变,因为在此之前它不再有资格访问一个或多个权限。从 2021 年 9 月 6 日开始,拥有这些权限但不属于新允许使用实例下的应用将受到政策执行的约束。

如果您不确定您的用例是否与这些更新一致,请在 2021 年 9 月 6 日前主动提交应用审核。用例与更新后的允许使用实例相一致的应用将不会受到此更改的影响。

产品组和目录端点修改

自 2021 年 6 月 8 日开始,对于 API v11.0+,Facebook 正在对您与产品组和目录的互动方式实施一些改变:

  • 默认情况下,删除默认产品小组将不会允许删除非空商品组。可以通过请求删除 deletion_method=delete_items 来删除非空商品组。这会同时删除商品组及其商品。
  • 如果商品目录包含直播产品系列,则默认情况下,对默认目录删除的更改将不再支持删除商品目录。直播商品系列会被分类为正处于活跃使用状态(例如位于广告系列、推广和已发布店铺中)。
  • 新增目录诊断端点,可用于检索给定商品目录的诊断数据。这个端点可以帮助识别一些问题,比如产品没有显示在渠道中,或者显示可以提高产品曝光度的展示机会。

库存字段更改

从 2021 年 6 月 8 日开始,对于 API v11.0 及以上版本,为了消除表面之间的不一致性,消除有关可预约时段库存的困惑,Facebook 将添加 quantity_to_sell_on_facebook 字段作为库存字段的替代。

这个新字段显示的数量不会因为预定的库存而减少,当买家向购物车添加商品时,系统会将其定义为临时预定的库存。我们将在近期内继续支持“inventory”字段。但是,我们建议您使用新的 quantity_to_sell_on_facebook 字段。

无需操作提醒

新版公共主页体验

在 2020 年 10 月 2 日,Facebook 宣布,借助新版公共主页体验,公共人物、商家和其他想要构建受众群并与之交流互动的用户可以在 Facebook 上管理其专业形象。所有经典版公共主页目前正在逐步切换到新的公共主页体验。我们计划在接下来的几个月内完成首次展示,并最终停用经典的公共主页。

请参阅开发者文档以了解如何确定是否已经切换公共主页,并访问问题帮助中心

平台已发布状态功能更新

在 2021 年 6 月 1 日,Facebook 已发布新的平台已发布状态主页以增加信息透明度,并与使用 Facebook 平台产品的外部开发者进行积极沟通。这个新的 Facebook for Business 状态公共主页将被用作单独的位置,用于检查 Facebook 提供的平台和商业产品的服务器运行状况,包括广告、WhatsApp Business API、Facebook 开发者平台等。

停用内容

停用 Facebook 分析

首发于 2021 年 3 月 30 日,Facebook 正在逐渐停用 Facebook 分析 (FBA)。在 2021 年 3 月 30 日之后,Facebook 分析工具将不再可用。此外,我们正在停用用于市场营销 API 的面板插件。

虽然个人 Facebook 分析工具正在逐渐停用,但这些替代方案仍然可用:

  • 事件管理工具
  • 广告管理工具
  • 公共主页成效分析
  • Instagram 成效分析
  • Facebook Business Suite 成效分析

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

2021 年 6 月 8 日开始,图谱 API v11.0 及以上版本将不再支持企业发送航班信息模板。2021 年 12 月 6 日宣布此更改后,之前的图形 API 版本(v10.0 及以下)将在 6 个月内停用。

我们建议企业以图片的形式发送登机牌和登记模板,与企业通常通过其他渠道发送这些通知的方式保持一致。

停用原生优惠端点

从 2021 年 6 月 8 日开始,如果您正在使用优惠广告 API,那么鼓励您改为使用 Facebook 广告,以打造您的促销和折扣信息。在秋季发布图表和市场营销 API v12.0 时,优惠广告 API 端点将被停用。虽然我们没有正式在 v11.0 发布时停用该端点,但我们将开始切换支持,如果您继续使用该端点,可能会导致次级优化体验。

公共主页公开内容访问权限 - 评论节点已停用

从 2021 年 6 月 8 日开始,对于图表 API v11.0 及以上版本,在使用公共主页公开内容访问权限功能的请求中返回的所有评论的“id”字段将被删除。注意:这些对象仍然支持嵌套请求。

此更改将于 2021 年 9 月 6 日起适用于所有其他在线 API 版本(v10.0 版本及以下)。

公共主页公开内容访问权限 - 评论节点已停用

从 2021 年 6 月 8 日开始,对以下终端的访问暂时仅限于在过去 30 天内查询过它们的应用:

  • gr:post:Business/client_adaccounts
  • gr:post:AdAccount/agencies
  • gr:post:BusinessRequest

API 版本停用信息:

作为图谱 API市场营销 API 的一部分,请注意即将停用的相关内容:

  • 2021 年 8 月 3 日:图谱 API v3.3 将被停用并从平台中移除
  • 2021 年 8 月 25 日:市场营销 API v9.0 将被停用并从平台中移除
  • 2021 年 10 月 4 日:市场营销 API v10.0 将被停用并从平台中移除
  • 2021 年 11 月 2 日:图谱 API v4.0 将被停用并从平台中移除
  • 2022 年 2 月 3 日:图谱 API v5.0 将被停用并从平台中移除

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

待办事项日历

一般公告及更新

  • 2021 年 5 月 12 日:受众收获用户界面的更改(面向不使用营销 API 的广告主)
  • 推行
    • 将图谱 API 访问级别扩展到消费者应用程序,计划在 6 月底或 7 月初完成
  • 2021 年 6 月 8 日
    • 添加 Instagram ASID 及开放平台版本管理
    • 在应用审核中添加 oEmbed 可审核功能
    • 受众收获 API 的更改
    • 隆重推出 Facebook 开放平台 SDK v11.0
  • 2021 年 11 月 2 日:数据删除请求截止期限

端点指定公告及动态更新

  • 2021 年 6 月 8 日
    • 对 user_likes 和 user_posts 允许使用实例的进一步说明
    • 产品组发布和目录端点修改
      • 默认情况下,默认产品小组删除将不再允许删除非空商品组
      • 如果商品目录包含直播产品系列,则默认情况下,对默认目录删除的更改将不再支持删除商品目录
      • 新增目录诊断端点,可用于检索给定商品目录的诊断数据
    • 对于 API v11.0 及以上版本,将“库存字段”替代为 quantity_to_sell_on_facebook 字段
  • 2022 年 11 月 10 日:数据删除请求截止时间

提醒,无需操作

  • 推行
    • 2020 年 10 月 2 日开始,借助新版公共主页体验,公共人物、商家和其他想要构建受众群并与之交流互动的用户可以在 Facebook 上管理其专业形象。
  • 2021 年 6 月 1 日:发布平台已发布状态功能更新

常规停用信息

  • 2021 年 6 月 8 日
    • Facebook 开放平台 SDK v11.0 将被停用,并将从平台中移除
    • Messenger 开放平台 - 航班信息模板将被停用,并将从 v11.0 及以上版本的平台中移除
    • 公共主页公开内容访问权限 - 评论节点将被停用,并将从 v11.0 及以上版本的平台中移除
    • 临时商家端点限制开始生效
  • 2021 年 6 月 30 日:Facebook 分析将被停用,并将从平台中移除
  • 2021 年 9 月 6 日:公共主页公开内容访问权限 - 评论节点将被停用,并将从 v10.0 及以下版本的平台中移除
  • 2021 年 6 月 8 日:停用原生优惠端点
  • 2021 秋:停用原生优惠端点
  • 2021 年 11 月 6 日:Messenger 开放平台 - 航空信息模板将被停用,并将从 v10.0 及以下版本的平台中移除

市场营销 API 版本停用信息:

在我们的市场营销 API 版本管理时间表中,请注意即将停用的市场营销 API 版本:

  • 2021 年 8 月 25 日:市场营销 API v9.0 将被停用并从平台中移除
  • 2021 年 10 月 4 日:市场营销 API v10.0 将被停用并从平台中移除

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

图谱 API 版本停用信息:

在我们的图谱 API 版本管理时间表中,请注意下面列出的即将停用的 API 版本:

  • 2021 年 8 月 3 日:图谱 API v3.3 将被停用并从平台中移除
  • 2021 年 11 月 2 日:图谱 API v4.0 将被停用并从平台中移除
  • 2022 年 2 月 3 日:图谱 API v5.0 将被停用并从平台中移除