11.0 版本

图谱 API

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

消费者应用

访问级别

适用于所有版本。

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

未来几周，访问权级别也将适用于所有新创建的应用。新创建的应用将获批使用 email 和 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

获赞数

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

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

基于时间的分页

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

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

即时体验

模板

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

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

Messenger 开放平台

消息回传 Webhook

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

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

停用航班信息模板

适用于 v11.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

评论编号

适用于 v11.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 天内成功调用这些端点的应用才能继续访问。

• POST /BUSINESS-ID/client_ad_accounts
• POST /ADACCOUNT-ID/agencies

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

目录 API

停用商品库存字段

适用于 11.0 及以上版本。

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

以下端点将受到影响：

• GET /{product-item-id}
• GET /{catalog-id}/products
• POST /{product-item-id}
• POST /{catalog-id}/items_batch

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

删除非空商品组

适用于 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 访问有关已履行税额的详细信息。

转化提升

指标更改

适用于 v11.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

已重命名以下指标：

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

成效分析 API

停用实体店访问量指标

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

已停用 store_visits_actions 和 cost_per_store_visit_actions 指标。

以下端点将受到影响：

• GET /{adaccount-id}/insights
• GET /{campaign-id}/insights
• GET /{adset-id}/insights
• GET /{ad-id}/insights
• POST /{adaccount-id}/insights
• POST /{campaign-id}/insights
• POST /{adset-id}/insights
• POST /{ad-id}/insights

优惠广告 API

停用优惠广告 API 端点

适用于 v11.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