图谱 API

版本 3.1

发布日期 2018 年 7 月 26 日 | 停用日期 2020 年 10 月 27 日 | 博文

一般信息

以下更改适用于 v3.1 及以上版本，且自 2018 年 10 月 24 日起适用于所有版本。

现在，全部图谱 API 端点都会将所有空结构体返回为 {}，并将所有空列表返回为 []。

Live API

以下更改适用于 v3.1 及以上版本，且自 2018 年 10 月 24 日起适用于所有版本。

下列连线的 type 参数已停用，并已替换为新的 source 参数。

  • /event/live_videos
  • /group/live_videos
  • /official_events/live_videos
  • /page/live_videos
  • /user/live_videos

新的 source 参数可接受以下两个可能的值之一：target 和 owner。如果使用 source=target 查询节点的 /live_videos 连线，则系统会返回投射到该节点的直播视频，而使用 source=owner 的查询会返回由该节点投射的直播视频。

事件和小组节点仅支持 target 查询，如果您没有查看目标节点的权限，则某些 target 查询可能会失败。

市场营销 API

发布日期 2018 年 7 月 26 日 | 停用日期 2019 年 5 月 14 日 | 博文

广告管理

  • 基于行为的定位类别：我们已停用 behaviors 中使用的一些基于行为的定位选项。如果尝试使用这些类别之一创建广告，则您将收到错误消息 The category you selected is no longer available. 如要查看可用于定位的有效类别，请使用定位搜索。

  • 已禁用 PAGE_ENGAGEMENT，不再作为optimization_goal - 我们已禁用 PAGE_ENGAGEMENT，其将不再是广告系列的 optimization_goal。自 v3.1 起，您无法再通过将 optimization_goal 设为 PAGE_ENGAGEMENT 来创建、更新或复制广告系列。如果您现在拥有在 v3.1 前创建的广告系列，则您仍然可以使用此设置投放这些广告系列。您仍然可以在现有广告系列中使用 optimization_goal，将 PAGE_ENGAGEMENT 用作数据的成效分析 API 细分数据。

  • 已禁用不含有帖子的单一图像公共主页赞广告 - 自 v3.1 起，您无法再创建不含有主页帖子的单一图像公共主页赞广告。反之，您应该创建含有帖子的公共主页赞广告，请参阅创意、版位和预览、创建公共主页赞广告。

  • 没有通过 Webhooks 进行的开发级别线索广告检索 - 我们会停止通过 Webhooks 将在线索广告表单中收集的数据发送给处于开发模式的应用。我们将于 2019 年 2 月 1 日开始实行这项更改。

    • 如果您订阅 v3.1 的更新，则我们不会发送任何更新，除非您的应用处于生产阶段或已发布模式。

    • 如果您在 v3.1 可用后创建新应用，我们将不会发送任何更新，除非您的应用处于生产阶段或已发布模式。

    • 如果您有现有的应用，则该应用需要在 2019 年 2 月 1 日前处于已发布模式。在此日期之前，您会继续在开发模式下收到更新。

    有关市场营销 API 访问级别和应用模式的更多信息，请参阅全新的市场营销 API 访问权限架构和市场营销 API、访问权限和身份验证。

广告成效分析和成效衡量

  • 我们将成效分析 API 的 cost_per_store_visit 和 store_visits 重命名为 cost_per_store_visit_actions 和 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 和相关文档的访问受到限制。请联系您的 Facebook 代表，获取访问权限。

商务管理平台 API

在 v3.1 中，我们推出基于任务的权限的新概念，以代替基于角色的权限。这会影响通过商务管理平台 API 和主页管理的广告帐户。广告帐户和主页的基于角色的访问权限仍然可用，但将来会停用。这会影响下列角色，并会为广告帐户提供对应任务：

角色 任务 描述

ADMIN

['MANAGE', 'ADVERTISE', 'ANALYZE']

管理广告系列、报告、账单和广告帐户权限的所有方面。

GENERAL_USER

['ADVERTISE', 'ANALYZE']

使用与广告帐户相关联的资金源创建广告。运行报告。

GENERAL_USER

['ANALYZE']

运行报告。

这会在商务管理平台 API 中通过以下任务替换下列角色：

角色 任务

MANAGER

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

CONTENT_CREATOR

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

MODERATOR

['MODERATE', 'ADVERTISE', 'ANALYZE']

ADVERTISER

['ADVERTISE', 'ANALYZE']

INSIGHTS_ANALYST

['ANALYZE']

对于 Facebook 像素的管理，这会影响下列角色，并带来新的任务：

角色 任务

PIXEL_EDITOR

['EDIT', 'ANALYZE']

PIXEL_ANALYST

['ANALYZE']

作为这种更改的一部分，我们会禁用下列商务管理平台 API 字段，并使用以下字段替换：

范围 已停用 新字段

GET {adaccount-id}/users

permissions、role

tasks

POST {adaccount-id}/users

role、uidRoles、emailRoles

tasks

GET {user-id}/adaccounts

permissions、role

tasks

GET {user-id}/assigned_ad_accounts

role、permitted_role

tasks、permitted_tasks

GET {user-id}/assigned_pages

role、permitted_role

tasks、permitted_tasks

GET {adaccount-id}/assigned_users

role、permitted_role

tasks、permitted_tasks

POST {adaccount-id}/assigned_users

role

tasks

GET {page-id}/assigned_users

role、permitted_role

tasks、permitted_tasks

POST {page-id}/assigned_users

role

tasks

GET {fb-pixel-id}/assigned_users

role、permitted_role

tasks、permitted_tasks

GET {adaccount-id}/userpermissions

role

tasks

POST {adaccount-id}/userpermissions

role

tasks

GET {page-id}/userpermissions

role

tasks

POST {page-id}/userpermissions

role

tasks

GET {business-id}/client_ad_accounts

permitted_role

permitted_tasks

POST {business-id}/client_ad_accounts

permitted_role

permitted_tasks

GET {business-id}/client_pages

permitted_role

permitted_tasks

POST {business-id}/client_pages

permitted_role

permitted_tasks

GET {business-id}/client_pixels

permitted_role

permitted_tasks

GET {adaccount-id}/agencies

permitted_role

permitted_tasks

POST {adaccount-id}/agencies

permitted_role

permitted_tasks

GET {page-id}/agencies

permitted_role

permitted_tasks

POST {page-id}/agencies

permitted_role

permitted_tasks

GET {business-id}/pending_client_pages

permitted_role

permitted_tasks

GET {business-id}/pending_client_ad_accounts

permitted_role

permitted_tasks

这项新设计还会影响主页 API，参见图谱 API 3.1、主页 API、重大变更。对于商务管理平台 API 文档，请参阅：

Messenger 平台

对于在 2018 年 7 月 26 日前创建的应用，这些更改将在 2019 年 1 月 8 日生效。对于在 2018 年 7 月 26 日后创建的应用，这些更改会立即生效。

在默认情况下，用户个人主页 API 现在仅返回 first_name、last_name 和 profile_pic 字段。其他字段现在需要通过应用面板的“Messenger 平台”选项卡进行产品审核。

last_ad_referral 和 is_payment_enabled 字段已停用，并将于 2018 年 10 月 30 日从 API 中移除。

共同好友 API

以下更改适用于 v3.1 及以上版本，且自 2018 年 10 月 24 日起适用于所有版本。

共同好友 API 已于 2018 年 4 月 4 日停用，而且下列端点开始返回空数据集。这些端点现已完全停用，并会返回错误提示。

  • /user-context/all_mutual_friends
  • /user-context/mutual_friends
  • /user-context/three_degree_mutual_friends

主页 API

权限

以下更改适用于 v3.1 及以上版本，且自 2019 年 2 月 1 日起适用于所有版本。

pages_manage_cta 权限现在要求对所有 POST 和 DELETE 请求进行应用审核。在 2018 年 7 月 26 日前创建的应用可以继续使用此权限，但必须于 2019 年 2 月 1 日前提交以供审核，以便继续使用 pages_manage_cta。

主页身份

以下更改适用于 v3.1 及以上版本。

主页身份正处于停用阶段，并将由主页任务替换。您之前需要授予用户公共主页身份，但现在必须在任务中授予用户同等的身份。

身份对应任务

Admin

ADVERTISE、ANALYZE、CREATE_CONTENT、MANAGE、MODERATE

Advertiser

ADVERTISE、ANALYZE

Analyst

ANALYZE

Editor

ADVERTISE、ANALYZE、CREATE_CONTENT、MODERATE

Moderator

ADVERTISE、ANALYZE、MODERATE

在基于任务的权限完全替换基于身份的权限之前，您通过 /page/roles 授予任务时，必须授予角色的全部对应任务，否则 POST 操作将会失败。

为了支持这些更改，我们已停用 perms 和 role 字段，并替换为新的 tasks 字段。这将影响以下连线：

  • /me/accounts
  • /page/roles
  • /user/accounts

请参阅市场营销 API 更新日志，了解这些更改对市场营销 API 和商务管理平台 API 有何影响。

Webhooks

这些更改适用于 v3.1 及以上版本，并将在 2018 年 10 月 24 日适用于所有版本。

以下用户 Webhook 字段已停用：

  • pic_big_with_logo
  • pic_small_with_logo
  • pic_square_with_logo
  • pic_with_logo

以下用户 Webhook 字段现在使用 HTTPS 网址，而不是 HTTP。

  • pic
  • pic_big
  • pic_small
  • pic_square
  • picture

此外，这些字段的网址都会过期，而这会立即影响所有 API 版本。