public_profile(默认)

允许访问用户公开档案的各版块中所列的信息。默认情况下,用户的公开档案指用户对象中的以下属性:

  • id
  • cover
  • name
  • first_name
  • last_name
  • age_range
  • link
  • gender
  • locale
  • picture
  • timezone
  • updated_time
  • verified

在 Web 环境里,public_profile 隐含在所有请求中,无需专门提出,不过我们建议您最好还是声明一下。在 iOS 和 Android 环境里,您必须在登录流程中手动请求此权限。

genderlocale 仅在以下情况下可访问:

  • 查询的用户是应用用户。
  • 查询的用户正在使用应用,且是应用用户的好友。
  • 查询的用户正在使用应用,虽然他并非应用用户的好友,但应用在调用中包含应用访问口令或者带有 appsecret_proof 参数。

timezoneverified 仅在以下情况下可访问:

  • 查询的用户即提出请求的用户。

审核

您的应用可使用此权限,无需通过 Facebook 审核。

user_friends

允许访问也在使用您的应用的好友清单。这些好友可在用户对象的好友连线找到。

要让某用户显示在另外一名用户的好友列表中,这两名用户都必须同意与您的应用分享他们的好友列表,且未在登录流程中拒绝授予该权限。此外,还必须在登录流程中请求这两名用户授予 user_friends 权限。

审核

您的应用可使用此权限,无需通过 Facebook 审核。

常见用途

使用好友列表在应用中打造社交体验。

email

通过 user 对象的 email 属性提供用户首选电子邮箱信息的访问权限。

不得向用户发送垃圾邮件。对电子邮箱的使用必须遵守 Facebook 政策以及反垃圾邮件法案

注意:即使您请求了 email 权限,也不表示您一定能获得电子邮箱。例如,用户使用手机号而不是电子邮箱注册 Facebook 帐户时,那他的电子邮箱字段可能就是空的。

审核

您的应用可使用此权限,无需通过 Facebook 审核。

扩展的个人主页属性

在登录流程中,这些权限并非“登录”对话框中的可选项。换言之,用户在登录您的应用时无法选择这些权限。如果要将它们设置为可选项,您应该适当构建应用,仅在绝对有必要时才提出权限请求,而不是在初次登录时提出这些请求。

publish_actions

允许代表应用用户发布帖子、开放图谱操作和其他活动。

因为该权限可让您代表用户发布内容,所以请阅读开放平台政策,确保了解如何正确使用该权限。

应用需要请求 publish_actions 权限即可使用动态发布对话框请求对话框“发送”对话框

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

通过应用审核请求此权限时,请确保我们的团队可轻松重现您的说明。

常见用途

让用户在您的应用中通过定制编辑器向 Facebook 显式发布内容。

在用户知情并适当参与控制的情况下,帮助他们以无缝方式发布开放图谱动态。

在用户不知情或不参与控制的情况下自动发布动态。

通过对话框或社交插件发布内容不需要该权限。如果您仅使用分享对话框、动态发布对话框、“消息”对话框等或者社交插件(例如“赞”按钮),那么无需请求审核此权限。

使用并非由用户创建的内容预填帖子的用户消息参数,即使可在分享前编辑或删除该内容。

访问服务或产品,或激励共享给用户、组或事件时间线。

user_about_me

通过 User 对象提供用户个人说明(个人主页的“简介”版块)的访问权限。

该权限并不提供用户公开档案数据的访问权限。 用户的姓名、头像、区域设置、年龄范围和性别默认包含在 public_profile 权限中。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

通过呈现用户 Facebook 个人主页的“简介”信息,完善他们在您的应用中的档案。

用于确定基本的个人主页信息。这些包含在登录应用的所有用户授予的 public_profile 中。

user_actions.books

允许访问任一应用发布的所有常见书籍操作,此处“应用”指用户使用过的应用。这包括用户已阅读想阅读已评分已引用的书籍。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

根据用户已阅读、想阅读、已评分或已引用的书籍为他们打造个性化体验。

根据用户之前读过的书籍推荐书籍。

user_actions.fitness

允许访问任一应用发布的所有常见开放图谱健身操作,此处“应用”指用户使用过的应用。这包括跑步步行骑行运动。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

根据用户的健身活动为他们打造个性化体验。

显示用户在一段时间内的健身活动累计情况。

将用户的健身活动情况与使用应用的其他用户进行对比。

帮助用户设置并达成个人健身目标。

user_actions.music

允许访问任一应用发布的所有常见开放图谱音乐操作,此处“应用”指用户使用过的应用。这包括用户已听过的音乐已创建的播放列表

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

根据用户过去听过的音乐向他们推荐音乐。

根据用户听过的音乐向他们推荐演唱会/活动以及其他内容。

帮助用户了解他们最喜欢的歌手和专辑。

user_actions.news

允许访问任一应用发布的所有常见开放图谱新闻操作,此处“应用”指用户使用过的应用。这包括用户已阅读的新闻文章已发布的新闻文章

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

展示相关书籍、文章或活动,从视觉上为用户打造定制式内容体验。

根据用户的新闻活动为他们打造个性化体验。

user_actions.video

允许访问任一应用发布的所有常见开放图谱视频操作,此处“应用”指用户使用过的应用。这包括用户已观看的视频已评分的视频以及想观看的视频

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

展示用户曾参与互动的视频、电影和电视节目,从视觉上为他们打造定制式内容体验。

根据用户已观看的电影、电视节目和视频为他们打造个性化体验。

user_actions:{app_namespace}

允许在指定应用中访问用户的所有自定义开放图谱操作。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

根据另一个应用发布的用户开放图谱操作为他们打造个性化体验。

user_birthday

访问用户的出生月份和日期。这可能包括也可能不包括用户的出生年份,具体取决于他们的隐私设置和用于查询此字段的访问口令。

请注意:大多数集成仅需要 age_range 权限,而此权限属于 public_profile 权限的一部分。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

提交应用供审核时,请清楚说明为什么您的应用还需要请求除 age_range 以外的权限。

常见用途

根据用户的生日信息为他们提供与年龄相关的内容。

针对仅了解用户年龄范围还不够的情况,为他们提供与年龄相关的内容。

确定用户是否表示他们未满 18 岁、已满 18 岁或是已满 21 岁。请使用 public_profile 权限中的 age_range 字段,这一权限无需审核即可使用。

user_education_history

允许通过用户对象education 字段访问用户学历背景信息。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

呈现和校友相关的内容。

帮助用户与有着相同学历背景的其他用户建立联系。

计算不会显示在应用中的分析数据。

user_events

提供用户组织或回复的活动的只读权限。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

增加查看日历和活动信息(例如在设备应用、计划应用、音乐会应用内)的便利性

不允许创建活动。您不可以通过图谱 API 创建活动。

允许用户使用您的应用回复活动。为实现此目的,您可以请求 rsvp_event 权限。

user_games_activity

允许读取用户在玩过的任何游戏中的游戏活动(分数、成就)。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

提供直观的游戏成绩列表,或者游戏 API 的一般访问权限。

计算不会显示在应用中的分析数据。

user_groups


此权限仅适用于使用 v2.3 或更低版本图谱 API 的应用。


让应用能够通过用户对象小组连线读取用户所在的小组

此权限不允许您代表用户创建小组。 您不可以通过图谱 API 创建小组。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

受限使用

在 Facebook 尚未入驻的平台上构建 Facebook 品牌客户端的应用可获得此权限。例如,Android 和 iOS 应用不能获得此权限。此外,Web、桌面、车载和电视应用也不能获得此权限。

user_hometown

允许通过用户对象hometown 字段访问用户家乡位置信息。家乡位置由用户在其个人主页中设置。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

根据用户的曾住地和家乡,为他们打造个性化体验。

帮助用户与家乡的其他用户建立联系。

user_likes

允许访问用户赞过的所有 Facebook 主页和开放图谱对象的列表。该列表可通过用户对象赞连线来获取。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

通过呈现与用户活动相关的内容,为他们打造个性化体验。

以看得见的方式帮助用户与有着共同兴趣爱好的其他用户建立联系。

根据用户是否赞过某主页,限制对应用或应用中某些内容的访问。

user_location

允许通过用户对象location 字段访问用户现居城市信息。现居城市由用户在其个人主页中设置。

现居城市与用户的家乡不一定相同。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

根据用户的现居城市为他们打造个性化体验。

呈现与用户现居城市相关的内容。

帮助用户与现居城市的其他用户建立联系。

user_managed_groups

让应用能够通过用户对象小组连线,读取相关用户担任管理员的小组中的内容。

此权限不允许您代表用户创建小组。您不可以通过图谱 API 创建小组。如果用户仅为小组的成员,此权限不允许您读取该小组。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

受限使用

提供可帮助用户管理多个小组的接口。

向用户管理的小组发帖(还要求 publish_actions 权限)。

以不可见的方式使用此数据,例如情感分析或拦截垃圾信息。

user_photos

允许访问用户上传的或圈出此用户的照片。可通过用户对象照片连线来获取。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

在数码相框中显示用户的照片。

帮助用户导出照片打印。 此服务仅可供用于用户个人及非商业用途。

访问照片,用于显著改善应用内体验(例如在照片编辑、拼贴、幻灯片以及换脸应用内)。

访问用户之前使用过的头像。

代表用户创建相册(发布照片则需要 publish_actions 权限。)

user_posts

允许访问用户的时间线帖子。包括用户自己发布的帖子、圈出用户的帖子以及其他用户在用户时间线上发布的帖子。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

提供来自时间线帖子的创意内容。

以看得见的方式分析用户时间线上的帖子内容,并将分析结果提供给用户。

以不可见的方式使用此数据,例如情感分析或拦截垃圾信息。

user_relationships

允许访问相关用户对象字段提供的感情状况、爱人以及家庭成员信息。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

呈现关系网络的相关内容。例如,向父亲显示有关如何当一名好爸爸的特定内容。

方便需要关系信息的实用程序使用(例如家谱应用)。

user_relationship_details

允许访问用户对象interested_in 字段提供的交友兴趣信息。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

根据用户“感情性向”字段的详细信息为他们提供定制内容。

user_religion_politics

允许访问用户的宗教和政治立场信息。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

呈现与用户宗教信仰或者政治立场相关的内容。

根据相似的兴趣爱好更好地与其他用户建立联系。

user_status


此权限仅适用于使用 v2.3 或更低版本图谱 API 的应用。

如果要调用端点 /{user-id}/posts/{user-id}/feed,可转而请求 user_posts 权限(仅适用于 v2.3 或更早的版本)。


允许访问用户状态信息。用户状态是指 Facebook 上的帖子,但不包括链接视频照片

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

提供来自状态更新的创意内容。

以看得见的方式分析用户过往发布的状态,并向他们提供相关分析结果。

以不可见的方式使用此数据,例如情感分析或拦截垃圾信息。

user_tagged_places

允许访问照片、视频、状态及链接中圈出用户的地点信息。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

根据用户去过的地点提供定制内容。

根据曾圈出用户的地点向他们推荐值得去的地点。

在地图上向用户显示他们的签到历史。

user_videos

允许访问用户上传的或圈出用户的视频信息。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

访问视频,用于显著改善应用内体验:(例如在编辑、拼贴、组合、幻灯片应用内)

通过机顶盒在电视上显示用户的视频,或者通过数码相框显示他们的视频。

user_website

允许通过User objectwebsite 字段获取用户个人网站网址信息。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

方便需要用户个人网站信息的组合、简历或业务应用。

user_work_history

允许通过User objectwork 字段获取用户的工作背景和雇主列表信息。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

根据行业、职位或类似信息呈现相关内容。

根据相同的工作背景帮助用户与其他用户建立联系。

计算不会显示在应用中的分析数据。


扩展权限

扩展权限可提供更敏感信息的访问权限,并让您的应用有权发布和删除数据。 在登录流程中,所有扩展权限都显示在一个单独的页面内,以便用户决定是否授予这些权限。

read_custom_friendlists

允许访问用户为管理好友而创建的自定义名单的名称。这一权限可在用户通过您的应用向 Facebook 发布动态时帮助呈现分享对象列表。

该权限不允许访问用户的好友列表。 如果要获取用户好友中同样使用您应用的用户信息,则应请求 user_friends 权限。

该权限不能帮您邀请用户好友使用您的应用。 要详细了解如何邀请好友使用应用,请参阅常见问题

该权限也不允许您访问用户好友列表中的用户, 而仅提供名单名称的访问权限。

在 v2.3 之前的版本中,该权限名为 read_friendlists

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

定制一个分享对象列表,以便用户选择哪些人可以看到他们通过您的应用发布的特定动态。

read_insights

提供用户拥有的主页、应用和 Web 域名的成效分析数据的只读访问权限。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

将 Facebook 的应用、主页或域名分析报告集成到您自有的分析工具中。

向第三方传送或转让成效分析数据。

以看不见的方式使用成效分析。

read_audience_network_insights

提供只读访问权限,用于访问用户拥有的应用的 Audience Network 成效分析数据。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

将 Facebook 的应用、Audience Network 成效分析集成到您自有的分析工具中。

向第三方传送或转让成效分析数据。

以看不见的方式使用成效分析。

read_mailbox


此权限仅适用于使用 v2.3 或更低版本图谱 API 的应用。


允许通过收件箱连线聊天节点,读取用户 Facebook 收件箱中的消息。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

受限使用

在 Facebook 尚未入驻的平台上构建 Facebook 品牌客户端的应用可获得此权限。例如,Android 和 iOS 应用不能获得此权限。此外,Web、桌面、车载和电视应用也不能获得此权限。

read_page_mailboxes

提供用户管理的主页的收件箱的读取权限。该权限通常与 manage_pages 权限一同使用。

该权限不允许您的应用读取主页所有者的收件箱, 而仅适用于主页的收件箱。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

方便用户通过您的应用管理他们的主页收件箱。

read_stream


此权限仅适用于使用 v2.3 或更低版本图谱 API 的应用。user_posts 可作为替代方案。


允许读取用户动态消息或个人主页中的帖子。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

受限使用

在 Facebook 尚未入驻的平台上构建 Facebook 品牌客户端的应用可获得此权限。例如,Android 和 iOS 应用不能获得此权限。此外,Web、桌面、车载和电视应用也不能获得此权限。

instagram_basic

可方便您读取您有权访问的 Instagram 帐户。详细信息请参阅 Instagram 入门指南

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

获取 Instagram 业务帐户的基本元数据。

instagram_manage_comments

可方便您读取您有权访问的 Instagram 帐户。详细信息请参阅 Instagram 入门指南

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

读取、更新和删除 Instagram 业务帐户的评论

读取 Instagram 业务帐户的媒体对象(例如动态)

instagram_manage_insights

可方便您读取您有权访问的 Instagram 帐户的成效分析。详细信息请参阅 Instagram 入门指南

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

获取 Instagram 业务帐户的元数据。

获取 Instagram 业务帐户的数据成效分析。

获取 Instagram 业务帐户的动态成效分析。

manage_notifications


此权限仅适用于使用 v2.3 或更低版本图谱 API 的应用。


让您的用户能够读取用户的通知并将其标记为已读。

该权限不允许您向用户发送通知。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

受限使用

在 Facebook 尚未入驻的平台上构建 Facebook 品牌客户端的应用可获得此权限。例如,Android 和 iOS 应用不能获得此权限。此外,Web、桌面、车载和电视应用也不能获得此权限。

manage_pages

让您的应用能够检索用户管理的主页和应用的主页访问口令。

要以主页身份发帖,您的应用需要获得 manage_pagespublish_pages 权限。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。您可以代表应用面板的身份版块中列出的用户授予此权限,而无需通过 Facebook 审核。

提请审核时,请确保我们的团队可轻松重现您的说明。例如,如果您的主页管理工具自带验证系统,请确保提供有效的登录凭据(例如帐号/密码),以便我们的审核团队使用您的工具和进行功能测试。

常见用途

向使用您的应用的用户所拥有的主页发布内容。发布内容还需要 publish_pages 权限。

帮助用户管理发布在他们主页上的帖子、评论和赞。

publish_pages

如果您还拥有 manage_pages 权限,则您的应用将能以用户所管理的任何主页的身份发帖、评论和赞。

要以主页身份发帖,您的应用需要获得 manage_pagespublish_pages 权限。

该权限不允许您的应用以独立个人帐户的身份发布内容。要以个人身份发布内容,请参阅 publish_actions 权限。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

通过应用审核请求此权限时,请确保我们的团队可轻松重现您的说明。

常见用途

让用户在您的应用中通过定制编辑器向他们管理的任何 Facebook 主页显式发布内容。

代表用户管理的主页以无缝方式点赞或发表评论。

在用户不知情或不参与控制的情况下自动发布动态。

使用并非由用户或商家创建的内容预填帖子的消息参数,即使主页管理员可以在分享前编辑或删除该内容。

rsvp_event

允许设置用户的 Facebook 活动参加状态(例如参加可能参加已拒绝)。

该权限不允许您邀请用户参加活动。

该权限不允许您更新活动的详细信息。

该权限不允许您创建活动。 您无法通过 API 创建活动。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

增加用户管理活动和日历信息(例如在设备应用、计划应用、音乐会应用内)的便利性。

pages_show_list

允许显示您管理的主页的列表。

常见用途

向 API 提供帐户访问权限,以便显示您管理的主页列表

pages_manage_cta

提供您所管理主页的行动号召的管理权限。

审核

您的应用可使用此权限,无需通过 Facebook 审核。

常见用途

提供 API 访问权限,以便管理您所管理主页的行动号召

pages_manage_instant_articles

授予应用权限,让其以应用用户所管理的 Facebook 主页的身份管理即阅文。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。您可以代表应用面板的身份版块中列出的用户授予此权限,而无需通过 Facebook 审核。

如果您要使用 WordPress 版即阅文插件(或类似工具)发布即阅文格式的博文,只要您代其发布内容的所有用户均列于应用面板的身份版块,则您无需提请审核。

提请审核时,请确保我们的团队可轻松复制您的说明。例如,如果您的应用自带验证系统,请提供有效的登录信息(例如帐号/密码),以便我们的审核团队能使用您的工具和进行功能测试。

常见用途

为应用用户拥有的主页创建和更新即阅文。

ads_read

提供广告成效分析 API 访问权限,以便拉取您有权访问的广告帐户的广告报告信息。

该权限不允许您更新购买、更新或以其他方式修改广告。

常见用途

向 API 提供广告表现数据的访问权限,以便在自定义面板和数据分析中使用

ads_management

允许读取和管理您有权访问的广告帐户中的广告。详情请查看广告管理

常见用途

以编程方式创建广告系列、管理广告和获取指标

构建广告管理工具,为广告主带来创新型解决方案和差异化的价值

business_management

通过商务管理 API 读写信息

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

管理广告帐户等业务资产。认领广告帐户。

仅执行常规的页面管理操作和事务。

pages_messaging(收发 API)

通过此权限,您可以通过 Facebook 主页收发消息,但只能在用户操作后 24 小时内收发。要在 24 小时之后发消息,请使用下一个权限。只能在用户表示(通过 Messenger 插件或直接向您发送消息)他们愿意接收您的消息后通过此 API 开展对话。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

创建由用户发起的交互式体验

确认预订、购买、订单等

发送客户支持消息

在未获得同意的情况下向用户发送消息

pages_messaging_subscriptions(收发 API)

通过此权限,您可以通过 Facebook 主页在用户操作 24 小时后收发消息。此权限不能用于发送促销或广告内容。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

发送新闻资讯

发送效率类功能更新

发送个人追踪通知

追加销售或交叉销售产品或服务

发送品牌广告、新闻资讯、公告或垃圾信息

pages_messaging_payments(收发 API)

通过此权限,您可以在 Messenger 对话中以主页身份向用户收取费用。仅适用于有形商品,不适用于虚拟商品或订阅服务。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

销售商品

售票

酒店预订和汽车租赁

销售虚拟货币

订阅内容更新

pages_messaging_phone_number(客户匹配)

这让您能够通过 Facebook 主页发送和接收消息。此权限不能用于发送促销或广告内容。只能在用户表示(通过 Messenger 插件或直接向您发送消息)他们愿意接收您的消息后通过此 API 开展对话。

审核

如果您的应用请求此权限,Facebook 必须审核应用将如何使用此权限。

常见用途

以短信形式发送普通内容

在未获得同意的情况下向用户发送消息