返回开发者新闻

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

2021年2月23日发布者:Kirk Thaker

今天,我们将发布 Facebook 图谱 API v10.0 和市场营销 API v10.0。

此版本包含很多公告、更新、停用和“取消停用”信息,可能会影响您的应用程序与我们平台的集成方式。本帖子概述了开发者为避免中断而需要执行的更新和必要步骤(如适用)。

有关所有更改的详细信息请见下文。有关技术规范的更多信息,请参阅我们的 v10.0 更新日志

如需详细了解我们的开发者开放平台,请访问开放平台计划中心。

公告和更新

数据使用情况检查认证

为避免丧失 Facebook 开放平台 API 访问权限,请在注册后 60 日内完成数据使用情况检查 (DUC)。前往应用面板的“我的应用”页面,即可完成 DUC。

去年秋天,Facebook 推出了数据使用情况检查 (DUC)。这是针对开发者一年一度的全新要求,旨在保证其 API 访问和数据使用均遵守 Facebook 开放平台条款开放平台政策

在向所有应用逐步推出此要求的过程中,您将通过开发者提醒收到到期日期和更多说明。除此之外,我们还会向已注册联系人的地址发送一封电子邮件,并在应用面板上的“必要操作”列表中显示通知。

有关完成 DUC 的详细说明,您可以参阅我们的开发者文档。您还可以在 DUC 专用的常见问题部分中了解更多信息。

小组 API 90 天数据访问权限和数据限制:

从 2021 年 5 月 24 日起,利用小组 API 时,应用程序的可用数据访问权限时段将限制为 90 天。

我们还将根据消费者应用程序处于开发模式还是已发布模式,面向这些应用程序推出分层小组 API 访问权限。现在,对于企业应用程序而言,小组 API 权限的行为方式与标准和高级访问权限类似。

处于开发模式的应用如今可以访问开发者为管理员的公开小组和非公开小组的所有内容。完成应用审核之后,这些应用可以访问已安装相应应用的小组中的所有内容。

从 2021 年 5 月 24 日起,处于开发模式的应用只能访问开发者为管理员的公开小组和非公开小组中的自有内容。这意味着此类应用将无法访问其他小组用户(在此类应用中没有相关角色)发布的内容,例如帖子和评论。

如需了解详情,请查看 v10.0 更新日志

针对企业应用在访问权限级别中添加 public_profile 和电子邮件权限

在实施保护用户数据安全的持续计划的过程中,我们针对新的和现有的企业类型应用在通过图谱 API v8.0 发布的访问权限级别模型中添加了 public_profile(即默认公开资料字段)和电子邮件权限。

现在,对于新创建的企业类型应用,我们一开始就会授予其对 public_profile 和电子邮件的标准访问权限。如果应用拥有对 public_profile 的标准访问权限,那么只有在该应用中拥有某种角色的用户或已领取该应用的企业才能搜索或登录该应用。如果您需要外部用户登录您的应用,应用管理员可以在应用面板中请求高级访问权限。系统会自动授予这种访问权限。

如需了解详情,请查看 v10.0 更新日志

数据删除请求提醒

正如在 2020 年 11 月 10 日所公布的那样,提交消费者和游戏应用类型进行应用审核,或从开发模式转变为已发布模式时,均需执行数据删除请求回调,或提供具有详细说明的网址,让用户了解如何请求删除其数据。我们计划在 2022 年 11 月 10 日前落实此要求,并会在落实之前 60 天向应用开发者发出提醒。

留存时间缩短项目的图谱 AdsInsight API 更改选项

广告管理工具用户界面将不再支持报告留存时间超过 37 个月的广告成效分析指标数据。当请求包含的日期范围超过 37 个月的留存时间时,该 API 会返回错误。我们将禁用“date_preset = lifetime”,用“date_preset = maximum”取而代之。

图谱 AdsInsight API v10.0 更改(“date_preset = lifetime”除外)将在 90 天之后应用于图谱 API 的其他所有版本。调用的特定字段不需要更改。系统将推出预设功能,所有“Lifetime”调用的默认留存时间上限都将设为 37 个月。

此项更改不会影响与广告创意、分享对象、投放设置或广告对象名称相关的数据,而且现有指标的计算也不会发生任何更改。此项更改将应用到所有广告报告渠道中,包括广告管理工具、广告报告和轻量级广告体验。

  • 发布日期 2021/2/23:
    • 10.0 版本
      • 启用“date_preset = maximum”
      • 禁用“date_preset = lifetime”
      • 当请求包含的确切日期范围超过 37 个月的留存时间时,会返回错误
    • 9.0 版本及更低版本
      • 当前功能没有变化
  • 发布后 90 天 - 2021/05/24:
    • 9.0 版本及更低版本
      • 启用“date_preset = maximum”(与新版本相同)
      • 当请求包含的确切日期范围超过 37 个月的留存时间时,会返回错误(与新版本相同)
      • “date_preset = lifetime”仍可正常使用,但它只能返回 37 个月内的数据,也就是说它的行为方式和 date_preset = maximum 一样

如需了解详情,请查看 v10.0 更新日志

针对 ThreatExchange 上外部拥有的数据的新删除政策

从 2021 年 5 月 24 日起,当合作伙伴设置他们上传到 ThreatExchange 的数据的 expire_time 时,我们会在提及的过期时间“硬删除”数据。如果您希望指明数据不再有效,请设置“expired_on”字段以自动删除该数据。

以前,“软”删除是指我们将过期内容标记为“过期”。我们现在不再支持软删除。当内容过期后,它将被硬删除,并且不再显示在 ThreatExchange 中。

此外,ThreatExchange 中的所有非 Facebook ThreatDescriptor 都将在过期后被硬删除。过期时间将仍由 ThreatDescriptor 的创建者来设置。然后,系统将开始删除并非由 Facebook 创建的所有已过期 ThreatDescriptor。如果您的应用程序当前有已过期的 ThreatDescriptor,而您不想在此政策生效时删除该数据,则您必须推迟过期日期,或者将其设为“0”以确保该数据永不过期。

点击此处详细了解所做的更改

全新 API 中的定位更改

自 2021 年 5 月 24 日起,在所有版本的 API 中创建类似自定义受众时,我们将不再要求提供 location_spec 和国家/地区参数。

创建类似受众时,用户需选择类似受众来源和所需的比例。类似受众的地点将由营销活动定位规范中的国家/地区地点来定义。此类更改不会对现有营销活动产生任何影响,仅会影响新营销活动和修改后的营销活动。

推出新的平台已发布状态页面

新的 Facebook 企业状态页面将提高透明度,增加与使用 Facebook 平台产品的外部开发者的主动沟通。此页面将提供一个集中地点来检查 Facebook 企业产品(广告、WhatsApp Business API、Facebook 开发者开放平台等)的平台状态。目前,您可以使用该页面检查广告管理工具和 Whatsapp Business API 的平台状态,我们将在 2021 年 5 月之前添加更多企业产品。

停用信息

停用“开始直播”对话框

我们将在 2021 年 5 月 24 日停用“开始直播”对话框 (GLD) SDK。我们将在所有版本的 API 中停用旧版直播生产工具。此项更改仅会影响 Facebook 上的直播。我们建议开发者将直播管理工具Live API 用于所有定制直播生产解决方案。

将在 GLD SDK 停用后推出的解决方案:

  • 直接通过 facebook.com/live/producer(或 Facebook 上的其他入口点,例如公共主页或个人主页上的“直播视频”按钮)使用直播管理工具。
  • 将所有自定义解决方案与 Live API 集成

如需了解详情,请查看 v10.0 更新日志

停用关系网络定位

从 2021 年 5 月 24 日起,在创建/修改广告组时,将不再支持关系网络定位。此项要求仅会影响新营销活动和修改后的营销活动,现有营销活动不会受到任何影响。

如需了解详情,请查看 v10.0 更新日志

取消停用

取消停用端点 gr:delete:Page/tabs

当我们推出图谱 API v8.0 后,我们为公共主页选项卡停用了 gr:delete:Page/tabs 端点。随后我们立即决定为图谱 API v10.0 取消停用此端点,并将于 2021 年 5 月 24 日在所有其他图谱版本中恢复对其的访问权限。

如需了解详情,请查看 v10.0 更新日志

取消停用端点 gr:post:Business/business_users、gr:post:Business/system_users 和 gr:post:User/access_tokens

当我们推出图谱 API v9.0 后,我们限制了对三个企业端点的访问权限:

  • gr:post:Business/business_users
  • gr:post:Business/system_users
  • gr:post:User/access_tokens

自图谱 v10.0 发布后,我们将在应用满足以下两个条件中的任意一个时,向 API 调用重新开放这些端点:

  • 目标企业是调用应用的自营企业
  • 目标企业是调用应用的自营企业的子企业(在企业 2 级模型中)

如需了解详情,请查看 v10.0 更新日志

待办事项日历

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

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

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

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

图谱 API 版本停用信息:

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

  • 2021 年 5 月 4 日:图谱 API v3.2 将被停用,并将从平台中移除
  • 2021 年 8 月 3 日:图谱 API v3.3 将被停用,并将从平台中移除

常规停用信息

  • 2021 年 5 月 24 日:
    • “开始直播”对话框将被停用,并将从平台中移除
    • 关系网络定位将被停用,并将从平台中移除

必要的开发者操作

  • 滚动注册:数据使用情况检查认证
    • 必须在注册后的 60 天内完成
    • DUC 专用的常见问题部分。
  • 2021 年 2 月 23 日:仅针对图谱 v10.0 推出图谱 AdsInsight API 更改
  • 2021 年 5 月 24 日:
    • 针对图谱 v9.0 及更低版本推出图谱 AdsInsight API 更改
    • 根据应用审核对访问权限级别做出的更改已生效
      • 小组 API 数据访问权限限制为 90 天
      • 已实现小组 API 分层数据级别
      • 对企业应用的 public_profile 和电子邮件权限做出的更改已生效
    • ThreatExchange 上新增的“硬删除”数据政策已实施
  • 2022 年 11 月 10 日:数据删除请求截止期限