8.0 版本

图谱 API

发布日期 2020 年 8 月 4 日 | 停用日期 2022 年 11 月 1 日 | 博文

访问口令

已停用端点

已在 8.0 及更高版本中停用。从 2020 年 11 月 2 日起将在所有版本中停用。

• GET /token_deprecation_check

相册

已恢复端点

适用于所有版本。

• GET /{album-id}/likes

应用配置

应用类型

此更改适用于所有版本。

现在您可以为新创建的应用选择应用类型：业务、游戏或无。这样做可根据所选类型移除不当的权限和功能，简化应用审核界面。此外，业务应用可使用新的授权机制，而不再使用模式，并可使用一项新功能。详情请参阅业务应用更新日志条目。

业务应用

业务应用可使用名为访问权限级别的新授权机制。访问权限级别将取代开发模式和已发布模式提供的相应功能（业务应用已移除这两种模式），让应用审核流程更加简单直观。此外，全新“业务资产用户个人主页访问权限”功能已推出，业务应用可凭借此功能读取用户的一小部分公开字段。下文将详细介绍这些更改。

访问权限级别

适用于所有版本。

访问权限级别是图谱 API 为业务应用推出的一种全新授权机制，可用于授予单个权限和功能。标准访问级别仅支持访问在应用或企业（已认领应用）中拥有身份的用户所拥有的数据。高级访问级别则支持访问任何应用用户所拥有的数据，但需要通过应用审核。系统会自动授予业务应用适用于其应用类型的所有权限和功能的标准访问级别。

移除开发模式和已发布模式

适用于所有版本。

已为业务应用移除开发模式和已发布模式。这些模式已被访问权限级别所取代，后者能提供同样的功能，而且更全面。业务应用的标准访问级别涵盖所有可用权限和功能，因此任何在应用或公司（已认领应用）中拥有身份的用户可随时为应用授予任何可用权限。这样便无需进行应用审核，也不必在开发期间切换模式。

全新“业务资产用户个人主页访问权限”功能

适用于所有版本。

通过全新“业务资产用户个人主页访问权限”功能，如果用户与已认领业务应用的公司所拥有的资产进行了互动，此应用便可读取相关用户的一小部分公开字段。请参阅“业务资产用户个人主页访问权限”参考文档，获取可读取的用户字段清单。

评论

已恢复端点

适用于所有版本。

• GET /{comment-id}/likes

设备

已停用端点

已在 8.0 及更高版本中停用。从 2020 年 11 月 2 日起将在所有版本中停用。

• POST /device/share

小组

已停用端点

已在 8.0 及更高版本中停用。

• GET /{group-id}/posts

已在 8.0 及更高版本中停用。从 2020 年 11 月 2 日起将在所有版本中停用。

• GET /{group-post-id}/likes

Instagram

全新 Instagram oEmbed 端点

适用于所有版本。

全新的 GET /instagram_oembed 端点已推出。此端点可提供与 Instagram 的旧版 oEmbed 端点相同的功能，而旧版 oEmbed 端点将于 2020 年 10 月 24 日停用。这个新端点需要访问口令，因此您需要 Facebook 开发者帐户和已注册的应用才能访问此端点。请参阅 Instagram oEmbed 文档，了解使用说明和其他详细信息。

生活纪事

已停用端点

已在 8.0 及更高版本中停用。

• GET /{life-event-id}
• GET /{life-events-id}/photos

链接

已停用端点

已在 8.0 及更高版本中停用。

• GET /{link-id}/reactions

直播视频

已停用端点

已在 8.0 及更高版本中停用。

• GET /{live-video-id}/likes

使用 GET /{live-video-id}/reactions 端点获取对直播视频的赞数。

save_vod 参数

适用于 8.0 及更高版本。将从 2020 年 11 月 2 日起适用于所有版本。

下列连线的 save_vod 参数已停用：

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

Messenger 开放平台

已停用端点

已在 8.0 及更高版本中停用。

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

应用审核

适用于所有版本。

Messenger 应用审核已从应用面板的产品 > Messenger > 设置移动到应用审核中。如要请求 Messenger 的特定权限 pages_messaging、pages_user_gender、pages_user_locale 和 pages_user_timezone，请前往应用审核 > 权限和功能。详情请参阅 Messenger 应用审核文档。

Messenger 个人主页连线

适用于 8.0 及更高版本。

POST /{page-id}/messenger_profile 的嵌套固定菜单类型已停用。

全新功能：店铺版 Messenger

适用于 8.0 及更高版本。

支持在店铺版 Messenger 上发送和接收商品信息，其中包括可用于在消息中发送商品的商品模板、适用于带有商品模板的消息以及 Facebook 店铺商品详情页面上的消息的 Webhooks，以及适用于带有商品消息的回显 Webhooks。

• GET /{message_id}/access_requests
• POST {page_id}/message
• message_echo Webhooks
• messages Webhooks

原生优惠

已停用端点

已在 8.0 及更高版本中停用。

• GET /{native-offer-id}/nativeofferviews?photos

开放图谱

已停用端点

已在 8.0 及更高版本中停用。将从 2020 年 11 月 2 日起在所有版本中停用。

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

公共主页

已停用端点

已在 8.0 及更高版本中停用。

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

公共主页帖子

已在所有版本中停用。

已停用公共主页帖子评论编号格式{page-id}_{post_id}_{comment-id}，改为使用 {pagepost-id}_{comment-id} 格式。

照片

已停用端点

已在所有版本中停用。

• GET /{photo-id}/sharedposts

地点

已停用端点

已在 8.0 及更高版本中停用。

• GET /{place-information-id}（见更正部分）

帖子

已停用端点

已在 8.0 及更高版本中停用。将从 2020 年 11 月 2 日起在所有版本中停用。

• GET /{post-id}/likes

使用 GET /post/reactions 端点获取对帖子的赞数。

搜索

已停用端点

已在 8.0 及更高版本中停用。从 2020 年 11 月 2 日起将在所有版本中停用。

• GET /search?type=place
• GET /search?type=audience_interest

安全设置

已停用字段

已在 8.0 及更高版本中停用。从 2020 年 11 月起将在所有版本中停用。

• secure_browsing

社交插件

Facebook oEmbed 端点

从 2020 年 10 月 24 日起，此更改将适用于所有版本。

应用可通过 Facebook oEmbed 端点获取公开 Facebook 帖子或视频的嵌入式 HTML，而此端点将从 2020 年 10 月 24 日起停用。我们已推出 3 个新端点用于取代以下现有端点，这些端点可提供与现有端点相同的功能：

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

新端点需要访问口令，并且系统会将针对其发出的请求计入流量限制。请参阅全新 oEmebd 端点文档，了解详细用途和其他信息。

用户

已停用端点

已在 8.0 及更高版本中停用。

• GET /{user-id}/taggable_friends

已停用字段

已在 8.0 及更高版本中停用。从 2020 年 11 月起将在所有版本中停用。

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

已在所有版本中停用。

• can_review_measurement_request
• is_famedeeplinkinguser

重新授权

此更改适用于所有版本。

从 2020 年 10 月 24 日起，以下字段如 90 天无活动，将需要重新获取数据访问权限：

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

用户图片

从 2020 年 10 月 24 日起将适用于所有版本。

从 2020 年 10 月 24 日起，GET /{user-id}/picture 端点 (GET /{user-id}?fields=picture) 的无口令请求将需要使用应用范围用户编号 (ASID)。如果您向用户发出查询时未提供 ASID，则必须在请求中加入应用、客户端或用户访问口令。详情请参阅用户图片参考文档。

视频问题

已停用端点

已在 8.0 及更高版本中停用。

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

已停用端点

已在 8.0 及更高版本中停用。将从 2020 年 11 月 2 日起在所有版本中停用。

• GET /{company-id}/access_requests
• GET /access_requests

市场营销 API

发布日期 2020 年 8 月 4 日 | 停用日期 2021 年 5 月 4 日 | 博文

广告帐户

已停用端点

已在 8.0 及更高版本中停用。

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

权限

适用于 8.0 及更高版本。将从 2020 年 11 月 2 日起适用于所有版本。

应用需要细化权限来访问广告帐户的企业字段。应当为特定企业对象授予权限。

素材定制规则

验证

适用于 8.0 及更高版本。

所有使用 asset_feed_spec 的广告都必须至少包含 2 条定位定制规则。如果您在创意中使用了 asset_feed_spec，但是其中包含的规则数少于两条，那么您将无法创建广告。

此更改会影响版位素材定制、多语广告和受众细分素材定制。

受众细分素材定制

适用于 8.0 及更高版本。将从 2020 年 11 月 2 日起适用于所有版本。

受众细分素材定制用户所有与地理位置无关的用例均已停用。此更改发生后，所有定位规则都必须在其定制规范中包含地理位置信息。但默认规则除外，此类规则无需包含地理位置信息。

竞价

目标费用竞价策略

适用于 8.0 及更高版本

TARGET_COST 竞价策略已停用。如要继续控制成本，推荐您改用费用上限竞价。查看所有可用竞价策略。

商务管理平台

已停用端点

已在 8.0 及更高版本中停用。

• GET{system-user-id}/updated_by

重新推出的分享协议端点

适用于所有版本

重新推出以下端点：

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

在图谱 API 6.0 版推出后，这 2 个端点曾遭到停用。

全屏广告

已停用端点

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

目录 API

权限

适用于 8.0 及更高版本。从 2021 年 1 月 31 日起将适用于所有版本。

今后访问商品目录端点，您不再需要 ads_management 权限。但是如要调用这些端点，则需要 catalog_management 权限。如果开发者在过去 90 天内已通过 ads_management 获得对目录端点的访问权限，系统将在 2020 年 8 月 14 日之前自动为该开发者授予 catalog_management 权限。

即日起至 2021 年 2 月 28 日，使用较早 API 版本的开发者仍能借助 ads_management 权限调用商品目录端点。如果您使用的是 8.0 版，则必须具备 catalog_management 权限。

2 月的截止日期过后，catalog_management 权限将不再与 ads_management 相关联，因此用户将需要为您的应用明确授予 catalog_management 权限。

身份验证

适用于 8.0 及更高版本。将从 2020 年 11 月 2 日起适用于所有版本。

[已更新] 以下目录 API 端点现在需遵守双重验证企业设置。如果拥有目录的公司要求当前应用用户进行双重验证，而该用户尚未这么做，调用此端点的应用将收到错误消息。

如果当前应用用户通过合作伙伴公司访问目录，我们将以该合作伙伴的商务管理平台的身份验证要求为准。系统用户无需进行双重验证。

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

报告

停用

适用于 8.0 及更高版本

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

定位

停用

适用于 8.0 及更高版本

• GET /search?type=adzipcode

更正

• 2020 年 9 月 28 日 — 更新了目录 API 身份验证条目，以明确相关要求。
• 2020 年 10 月 23 日 — 更新了目录 API 条目：

  • 我们推迟了截止日期，对于使用较早 API 版本的开发者，他们仍能借助 ads_management 权限调用商品目录端点。新的截止日期为 2021 年 2 月 28 日。
  • 我们明确了系统用户身份验证的相关要求。
• 2021 年 5 月 17 日 — 我们把停用的端点由 GET /{place-id} 改为了 GET /{place-information-id}。我们不停用 GET /{place-id}。