10.0 版本

图谱 API

发布日期 2021 年 2 月 23 日 | 停用日期 2023 年 6 月 8 日 | 博文

业务应用

访问权限级别

适用于 2021 年 2 月 16 日后创建的所有应用。

系统将自动为 2021 年 2 月 16 日后创建的所有业务类应用授予对 email 和 public_profile 权限的标准访问级别。

适用于 2021 年 2 月 16 日后创建的所有现有应用。

系统将自动为 2021 年 2 月 16 日前创建的所有业务类应用授予对 email 和 public_profile 权限的高级访问级别。如果应用未使用 email 或 public_profile 权限，系统会将该应用对这 2 种权限的访问级别降为标准访问级别。

业务类应用对 email 和 public_profile 权限的访问级别可升级为高级访问级别，而无需完成应用审核。

小组

适用于 v10.0 及以上版本。将从 2021 年 5 月 25 日起适用于所有版本。

• 为了与其他 Facebook 数据保留政策保持一致，小组 API 将仅包含最近 90 天内的查询所创建的数据。访问级别或应用的模式及您在应用中拥有的身份将决定所返回的数据内容。
• 小组 API 现在将改用 2 级 API 访问级别系统（标准级和特权级），而非针对开发模式和已发布模式的访问级别。通过标准级访问权限，您将只能获取在应用中拥有身份的用户的数据；而通过特权级访问权限，您将能获取安装应用的小组中所有用户的数据。

公共主页

已恢复的端点

适用于 v10.0 及以上版本。将从 2021 年 5 月 25 日起适用于所有版本。

8.0 版中停用的 DELETE /{page-id}/tabs 端点现已在 10.0 版中恢复，并将从 2021 年 5 月 25 日起在所有版本中恢复。

ThreatExchange

过期数据的删除

从 2021 年 5 月 25 日起将适用于所有版本。

对于上传到 ThreatExchange 的非零 expire_time 数据，系统将在指定过期时间永久删除。如果您希望删除不再有效的数据，则可将 expired_on 字段设为当前时间，让系统立即删除该数据。

此外，所有非 Facebook ThreatDescriptor 在达到创建者设置的到期日期后都将遭到永久删除。如果您的应用程序目前包含您不想删除的已过期 ThreatDescriptor，您必须推迟过期日期或将其设为“0”，以确保该数据永远不会过期。

网址

适用于 v10.0 及以上版本。将从 2021 年 5 月 25 日起适用于所有版本。

互动量

• 出于隐私考虑，GET /?id={url}/engagement 请求返回的计数可能与原始计数不符。
• 每小时针对同一网址的 GET /?id={url}/engagement 字段发出的请求不得超过 10 个。

市场营销 API

发布日期 2021 年 2 月 23 日 | 停用日期 2021 年 10 月 4 日 | 博文

广告帐户

字段更改

适用于 v10.0 及以上版本。从 2021 年 5 月 25 日起将适用于所有版本。

AdAccount 节点上的 agency_client_declaration 字段现在需要具备管理员特权才能执行所有操作。

广告成效分析 API

更新的 date_preset 参数

适用于 10.0 及更高版本。

• lifetime 参数 (date_preset=lifetime) 已被禁用，并由 date_preset=maximum 所取代，新参数可用于检索最多 37 个月的数据。如果请求包含的日期范围超出了 37 个月的时间范围限制，此 API 将返回错误。
• 对于 9.0 及更低版本，在 2021 年 5 月 25 日之前不会发生任何功能更改。之后，系统将启用 date_preset=maximum，所有 lifetime 调用均将默认使用 maximum，并且仅返回 37 个月的数据。

企业

减少先前的端点访问限制

适用于 10 及更高版本。

在 9.0 版中，对以下端点的访问曾经受到限制。所有应用的访问权限均已恢复，但是应用现在只能将目标指定为已认领该应用的公司（或这些公司的子公司）：

• POST /<APP_SCOPED_SYSTEM_USER_ID>/access_tokens
• POST /{business-id}/business_users
• POST /{business-id}/system_users

定位

关系网络定位

从 2021 年 5 月 24 日起将适用于所有版本。

创建或编辑广告系列时，以下端点将不再接受关系网络定位：

• POST /<ad_account_id>/adsets
• POST /<adset_id>

此更改不会影响任何当前投放中的广告系列。

类似受众

将从类似受众创建中移除 location_spec 和 country 参数。类似受众的地点将由广告系列定位规范中的国家/地区地点来定义。

此类更改不会对现有广告系列产生任何影响。此要求仅会影响新创建的广告系列和经过修改的广告系列。

以下端点和字段将受到影响：

• POST /<ad_account_id>/customaudiences
• POST /<ad_account_id>/adsets
• POST /<ad_account_id>/adaccounts?adaccounts=<SHARED_TO_AD_ACCOUNT_ID>
• GET /<ad_account_id>/reachestimate
• GET /<ad_account_id>/delivery_estimate
• GET /<ad_account_id>?fields=approximate_count
• GET /<ad_account_id>?fields=delivery_status
• GET /<ad_account_id>?fields=operation_status

请参阅类似受众：即将推出的类似受众更改，以详细了解这些更新。