11.0 版本

图谱 API

发布日期 2021 年 6 月 8 日 | 停用日期 2021 年 9 月 14 日 | 博文

消费者应用

访问级别

适用于所有版本。

未来几周，访问级别将适用于所有现有的消费者应用。对于这些应用，已通过应用审核流程获得批准的权限和功能将自动获准高级访问权限。所有其他权限和功能则自动获准标准访问权限。

未来几周，访问级别也将适用于所有新创建的应用。新创建应用的邮件和 public_profile 权限将自动获准高级访问权限。然而，这两种权限在默认情况下都设置为标准访问权限，必须手动设置为高级访问权限，才能向在应用中无角色的用户请求这些权限。

开发者支持

我们已发布 Facebook for Business 状态工具，该工具可用于监控开放平台和企业产品（如广告管理工具、WhatsApp Business 和 Facebook 开发者开放平台）的运行状况。

Facebook 分析

停用

适用于所有版本。

Facebook 分析在 2021 年 6 月 30 日之后将不再可用。此外，我们计划停用市场营销 API 应用面板插件。如需了解详情，请访问 Business 帮助中心。

以下应用程序节点字段不再可用：

analytics_config
analytics_platform_metrics_config
permissible_ad_accounts

以下端点不再可用：

GET Application/analytics_cohort_query
GET Application/analytics_entity_user_config
GET Application/analytics_event_types
GET Application/analytics_funnel_query
GET Application/analytics_query
GET Application/analytics_segments

Instagram Basic Display API

访问口令调试程序

适用于所有版本。

访问口令调试程序工具现在仅在调试口令时返回应用范围编号。

API 版本控制

适用于所有版本。

API 现在支持有版本号的调用。要查询指定 API 版本，请在查询路径中基本网址后添加版本号。例如：

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

系统会将无版本号的请求（缺少版本号）解析为调用应用的应用面板 > 设置 > 高级 > 升级 API 版本设置中指定的版本。

应用范围用户编号

适用于 11.0 及以上版本。

新版本中已引入应用范围用户编号 (ASID)。大约两年后，10.0 版本将停用，ASID 将取代原始用户编号，因此我们建议您开始将应用用户的原始编号映射到其等效的 ASID。

所有版本都支持基于原始用户编号的查询。
仅 11.0 及以上版本的调用支持基于 ASID 的查询。
11.0 及以上版本的调用将在响应中接收 ASID，即使在查询原始用户编号时也是如此。

基于时间的分页

适用于 v11.0 及以上版本。

已向 GET /{user-id}/media 端点添加 since 和 until 参数，以支持基于时间的分页。

Instagram 图谱 API

获赞数

适用于 11.0 及以上版本。将从 2021 年 9 月 7 日起适用于所有版本。

如果通过另一个端点或字段扩展间接查询 Instagram 媒体，则在媒体所有者已隐藏获赞数的情况下，API 响应将忽略 like_count 字段。若是直接查询 Instagram 媒体（只能由 Instagram 媒体所有者实施），则即使所有者已隐藏获赞数，系统仍会返回实际的获赞数。

基于时间的分页

适用于 v11.0 及以上版本。

已向 GET /{ig-user-id}/media 端点添加 since 和 until 参数，以支持基于时间的分页。

即时体验

模板

适用于 v11.0 及以上版本。

即时体验模板已结束公测，现在可供所有开发者使用。

Messenger 开放平台

消息回传 Webhooks

适用于 v11.0 及以上版本。

mid 字段已添加到 messaging_postbacks Webhooks，以允许应用获取消息编号。

停用航班信息模板

适用于 11.0 及以上版本。将从 2021 年 12 月 6 日起适用于所有版本。

无法调用包含任何航班信息模板（airline_boardingpass、airline_checkin、airline_itinerary、airline_update 类型的 template_type）的 POST /{page-id}/messages。

oEmbed

新版 oEmbed Read 功能

适用于所有版本。

oEmbed 产品已替换为新版 oEmbed Read 功能。如果您在 2021 年 6 月 8 日之前部署 oEmbed 产品，则必须在 2021 年 9 月 7 日之前完成 oEmbed Read 功能的应用审核。如果您在 2021 年 9 月 7 日之前尚未获准使用 oEmbed Read 功能，则将无法加载您的 oEmbed 部署。

公共主页 API

评论编号

适用于 11.0 及以上版本。将从 2021 年 9 月 7 日起适用于所有版本。

对于任何仅使用公共主页公开内容访问功能查询公共主页端点的应用，系统不会返回评论的 id 字段。包括 id 字段 /PAGEPOST-ID/comments 或 /COMMENT-ID/comments。如需获取公共主页帖子评论的评论 id 字段，则应用用户必须能够在查询的公共主页上执行 MODERATE 任务。

新版公共主页体验

未来数月，所有经典公共主页都将迁移至新版公共主页体验。使用 has_transitioned_to_new_page_experience 公共主页字段确认公共主页是否已迁移。所有公共主页完成迁移后，经典公共主页体验将不再可用。

大多数公共主页 API 端点都支持经典公共主页和 NPE 公共主页。支持 NPE 公共主页的端点会在其引用中显示“新版公共主页体验”部分。

以下端点不支持 NPE 公共主页：

/PAGE-ID/likes
/PAGE-ID/global_brand_children
/PAGE-ID/locations
/PAGE-ID/tabs
/PAGE-ID/visitor_posts

NPE 无法使用多个公共主页字段，并且在调用这些字段时将返回 null、不同的数据集或错误。有关这些公共主页字段的清单，请访问我们的新版公共主页体验概览。

权限

user_likes

适用于所有版本。

已更新 user_likes 权限的合理使用方式。自 2021 年 9 月 7 日起，已获准此权限但违反新版使用说明的应用将被撤销批准。

旧版合理使用方式：切实改善用户使用应用时的体验质量（必须向用户清楚说明会如何使用他们的数据来改善体验）。
新版合理使用方式：通过关联或呈现与用户点赞的兴趣爱好相关的内容，为他们打造个性化体验。这包括大规模策划内容，从而使用大量内容来定制应用，以及允许用户与他人分享自己点赞的兴趣爱好，例如在交友和音乐应用中。

user_posts

适用于所有版本。

已更新 user_posts 权限的合理使用方式。自 2021 年 9 月 7 日起，已获准此权限但违反新版使用说明的应用将被撤销批准。

旧版合理使用方式：切实改善用户使用应用时的体验质量（必须向用户清楚说明会如何使用他们的数据来改善体验）。
新版合理使用方式：允许用户按照自己的时间线创建实体或数字书籍或相册，并在 Facebook 或其他社交应用上分享时间线中的回忆。

SDK

请访问 iOS SDK 更新日志、Android SDK 更新日志和 Unity SDK 更新日志，了解即将对这些 SDK 作出的重大更改。

市场营销 API

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

受众

删除自定义受众、类似受众和保存的受众

适用于所有版本。

自 2021 年 6 月 8 日起，两年以上未在任何有效广告组中使用的自定义受众、类似受众或保存的受众均将标记为“即将到期的受众”。系统预计会在这些受众被标记为“即将到期的受众”的 90 天后将其删除。

开发者可使用 operation_status 字段筛选“即将到期的受众”状态，并使用 delete_time 字段查看系统中受众的预计删除时间。开发者可以选择主动删除受众，也可以在有效广告组中使用受众以防止其遭到删除。一旦删除受众，广告主将无法重新激活该受众。

对于自定义受众（客户名单自定义受众除外）、类似受众或保存的受众：

如果广告主希望自 2021 年 9 月 6 日起自动删除标记受众，则无需采取任何行动。但是，如果广告主愿意，他们也可以在自动删除日期之前主动删除受众。
对于广告主希望保留的标记受众，他们应计划在 2021 年 9 月 6 日之前在有效广告组中使用这些受众，以防止其遭到删除。

对于客户名单自定义受众：

我们会根据广告主的指示，代表他们存储这些受众。如果广告主在 2021 年 9 月 6 日之前未采取任何行动在有效广告组中使用标记受众，我们会将其视为删除标记受众的指示。

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

GET /{custom-audience-id}
GET /act_{ad-account-id}/customaudiences?filtering
GET /act_{ad-account-id}/saved_audiences?filtering
GET /{saved-audience-id}

查看受众概览：自定义受众删除更改，以进一步了解这些更新。

企业 API

适用于所有版本。

我们将暂时限制对以下端点的访问。只有在过去 30 天内成功调用这些端点的应用才能继续访问。

所有其他应用在调用这些端点时都会收到错误消息。

目录 API

停用产品库存字段

适用于 11.0 及以上版本。

inventory 字段将停用，并替换为新的 quantity_to_sell_on_facebook 字段。虽然我们在近期将继续支持 inventory 字段，但我们建议您改用新的 quantity_to_sell_on_facebook 字段。

以下端点受到影响：

查看产品销售数量和支持的字段 - 动态广告和电商，以进一步了解该更新。

删除非空商品组

适用于 11.0 及以上版本。将从 2021 年 9 月 7 日起适用于所有版本。

默认情况下，我们将不再允许删除非空商品组。可以通过在删除请求中应用 deletion_method=delete_items，删除非空商品组。这会同时删除商品组及其商品。

以下端点受到影响：

DELETE /<product_group_id>

删除直播商品系列

适用于 11.0 及以上版本。将从 2021 年 9 月 7 日起适用于所有版本。

默认情况下，我们将不再允许删除包含活跃状态商品系列的目录。如需删除包含活跃状态商品系列的目录，请将目录的 allow_delete_catalog_with_live_product_set 参数设置为 true。

此更改会影响以下端点：

DELETE /<product_catalog_id>

全新诊断端点

适用于 11.0 及以上版本。

我们已添加全新端点 GET /{product_catalog_id}/diagnostics。此端点可用于检索给定目录的诊断数据，例如阻止产品在渠道中显示的问题以及提升产品曝光度的机会。

电商 API

订单总额预估支付明细

适用于 11.0 及以上版本。将从 2021 年 9 月 7 日起适用于所有版本。

我们正在更改调用 {commerce-order-id}/?fields=estimated_payment_details 端点的订单总额中报告预估支付明细的方式。在此之前，如果订单未完成，则使用预估税额，而对于已完成的订单，则使用已完成税额。从 11.0 版本开始，此端点将始终使用预估税额。请注意，可以使用 {commerce-order-id}/items?fields=tax_details 访问有关已完成税额的详细信息。

转化提升

指标更改

适用于 11.0 及以上版本。将从 2021 年 9 月 7 日起适用于所有版本。

已更改从 GET /{objective-id}/?fields=result 字段返回的指标。

已添加以下指标：

conversions_incremental_share
conversions_CPiC
conversions_multicell_confidence
conversions_multicell_rank
sales_incremental_share
sales_multicell_confidence
sales_multicell_rank
buyers_incremental_share
buyers_CPiB
buyers_multicell_confidence
buyers_multicell_rank

已移除以下指标：

advancedBuyers.control
ancedBuyers.informativeMultiCellBayesianConfidence
advancedBuyers.lift
advancedBuyers.test
advancedConversions.control
advancedConversions.informativeMultiCellBayesianConfidence
advancedConversions.lift
advancedConversions.test
advancedSales.control
advancedSales.informativeMultiCellBayesianConfidence
advancedSales.lift
advancedSales.test
buyers.baseline
buyers.bayesianCILower
buyers.bayesianCIUpper
buyers.control
buyers.delta
buyers.incremental
buyers.isStatSig
buyers.lift
buyers.multiCellBayesianConfidence
buyers.reachedPercent
buyers.singleCellBayesianConfidence
conversions.baseline
conversions.bayesianCILower
conversions.bayesianCIUpper
conversions.control
conversions.delta
conversions.incremental
conversions.isStatSig
conversions.lift
conversions.multiCellBayesianConfidence
conversions.reachedPercent
conversions.singleCellBayesianConfidence
frequency
incrementalROAS
sales.baseline
sales.bayesianCILower
sales.bayesianCIUpper
sales.control
sales.delta
sales.incremental
sales.isStatSig
sales.lift
sales.multiCellBayesianConfidence
sales.singleCellBayesianConfidence

已重命名以下指标：

旧名称	新名称
`advancedBuyers.baseline`	`buyers_not_exposed`
`advancedBuyers.bayesianCILower`	`buyers_incremental_lower`
`advancedBuyers.bayesianCIUpper`	`buyers_incremental_upper`
`advancedBuyers.incremental`	`buyers_incremental`
`advancedBuyers.informativeMultiCellPairwiseBayesianConfidence`	`buyers_multicell_confidence`
`advancedBuyers.informativeSingleCellBayesianConfidence`	`buyers_confidence`
`advancedBuyers.scaled`	`buyers_control_scaled`
`advancedConversions.baseline`	`conversions_not_exposed`
`advancedConversions.bayesianCILower`	`conversions_incremental_lower`
`advancedConversions.bayesianCIUpper`	`conversions_incremental_upper`
`advancedConversions.incremental`	`conversions_incremental`
`advancedConversions.informativeMultiCellPairwiseBayesianConfidence`	`conversions_multicell_confidence`
`advancedConversions.informativeSingleCellBayesianConfidence`	`conversions_confidence`
`advancedConversions.scaled`	`conversions_control_scaled`
`advancedSales.baseline`	`sales_not_exposed`
`advancedSales.bayesianCILower`	`sales_incremental_lower`
`advancedSales.bayesianCIUpper`	`sales_incremental_upper`
`advancedSales.incremental`	`sales_incremental`
`advancedSales.informativeMultiCellPairwiseBayesianConfidence`	`sales_multicell_confidence`
`advancedSales.informativeSingleCellBayesianConfidence`	`sales_confidence`
`advancedSales.scaled`	`sales_control_scaled`
`buyers.pValue`	`buyers_raw_pValue`
`buyers.reached`	`buyers_exposed`
`buyers.scaled`	`buyers_control_raw_scaled`
`buyers.test`	`buyers_test`
`conversions.pValue`	`conversions_raw_pValue`
`conversions.reached`	`conversions_exposed`
`conversions.scaled`	`conversions_control_raw_scaled`
`conversions.test`	`conversions_test`
`IncrementalROAS`	`sales_ROAS`
`sales.pValue`	`sales_raw_pValue`
`sales.reached`	`sales_exposed`
`sales.scaled`	`sales_control_raw_scaled`
`sales.test`	`sales_test`

可在 Facebook 提升指标术语表中查看可用指标的完整清单。

成效分析 API

停用店铺访问量指标

适用于 11.0 及以上版本。将从 2021 年 9 月 6 日起适用于所有版本。

已停用 store_visits_actions 和 cost_per_store_visit_actions 指标。

以下端点受到影响：

优惠广告 API

停用优惠广告 API 端点

适用于 11.0 及以上版本。将从 2021 年 9 月 7 日起适用于所有版本。

Facebook 致力于不断提高产品的稳定性，作为其中的一项举措，我们将于 2021 年 6 月 8 日停止对优惠广告产品的支持。我们推荐您改用标准版 Facebook 广告来发布实体店和/或线上折扣。折扣信息、兑换地点、过期日期和促销代码则建议直接放在广告层级的广告创意中。

已停用以下端点：

GET /{page-id}/nativeoffers
POST /[page-id}/nativeoffers
GET /pagename/nativeoffers
GET /{native-offer-id}
GET /{native-offer-id}/views
POST /{native-offer-id}/codes
POST /{native-offer-id}/nativeofferviews
GET /{offer-id}/comments
GET /{offer-id}/sharedposts
GET /{offer-id}/likes