Instagram 图谱 API

instagram_basic

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

审核

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

常见用途

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

instagram_manage_comments

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

审核

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

常见用途

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

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

instagram_manage_insights

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

审核

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

常见用途

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

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

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

直播视频 API

publish_video

要求接受应用审核

向应用授予权限,允许将直播视频发布到应用用户的时间线。

允许用法

向用户的时间线流式传输直播视频。

禁止用法

流式传输广告或任何不符合 Facebook 内容政策的内容。

Messenger 平台

pages_messaging(发送/接收 API)

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

审核

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

常见用途

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

确认预订、购买、订单等

发送客户支持消息

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

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

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

pages_messaging_subscriptions

要求接受应用审核

允许应用在用户首次互动后的任何时间,使用 Facebook 主页发送消息。您的应用只能使用两种方式发送广告或宣传内容:通过赞助消息,或在用户互动后 24 小时内。

允许用法

通过 Messenger 向用户发送订阅消息。

主页和商务管理平台资产

ads_management

允许读取和管理两类广告帐户的广告:自己拥有的广告帐户,或广告帐户所有者通过此权限授予访问权限的广告帐户。

默认情况下,您的应用在开发者模式下只能访问应用管理员拥有的广告帐户。

用法


允许用法

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

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

禁止用法

公司不得尝试对 Facebook 投放引擎的工作方式进行反向工程。

公司不得尝试重复投放过多相同的广告来增加广告的投放几率。

ads_read

允许访问广告成效分析 API,拉取两类广告帐户的广告报告信息:自己拥有的广告帐户,或广告帐户所有者通过此权限授予访问权限的其他广告帐户。

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

用法


允许用法

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

禁止用法

商家不得尝试识别个人的身份并向这些个人投放特定的广告。

商家不得跨不同商家拥有的产品共享受众。

商家不得跨不同商家拥有的产品共享成效分析。

business_management

通过商务管理 API 读写信息

审核

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

常见用途

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

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

leads_retrieval

Requires App Review.

Grants your app permission to retrieve all the information captured within a lead.

Allowed Usage

Leads are generally submitted by users in response to specific kinds of CTA (Sign ups, Get Quotes, etc.) shown on the ad. The information within the lead is used to reach out to the users to follow up on those CTA. For example, a dealer reaches out to a potential customer (lead) with quotes for a car.

By advertiser authorized CRM platforms to pull the lead data on behalf of the advertisers. The advertisers then use the lead information to reach out to the user.

Disallowed Usage

Share the lead data with anyone outside of the advertiser who ran the ads for capturing the leads.

Store additional information of the user outside of what was submitted on the lead form.

manage_pages

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

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

审核

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

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

常见用途

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

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

pages_manage_cta

要求接受应用审核

允许应用对用于管理主页行动号召按钮的端点执行 POSTDELETE 操作。

允许用法

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

pages_manage_instant_articles

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

审核

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

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

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

常见用途

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

pages_show_list

提供显示您管理的主页列表的权限。

常见用途

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

publish_pages

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

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

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

审核

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

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

常见用途

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

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

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

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

read_audience_network_insights

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

审核

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

常见用途

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

向第三方传送或出售成效分析数据。

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

read_insights

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

审核

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

常见用途

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

向第三方传送或出售成效分析数据。

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

read_page_mailboxes

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

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

审核

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

常见用途

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

用户数据

默认字段

默认字段是用户公开资料各个部分的子集。这些字段是 User 对象的下列属性:

  • id
  • first_name
  • last_name
  • middle_name
  • name
  • name_format
  • picture
  • short_name

在网页环境中,默认字段隐含在每个请求中,您无需进行声明,但最好使用 public_profile 声明这些字段。 在 iOS 和 Android 环境中,您必须在登录流程中通过 public_profile 手动请求这些字段。

id 字段是应用范围编号。

审核

您的应用可使用这些字段,无需通过 Facebook 审核。

email

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

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

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

审核

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

groups_access_member_info

让应用能够在 API 响应中包括公开可用的小组成员信息。仅可包括选择与小组应用共享其信息的小组成员的默认 User 字段。

审核

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

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

常见用途

让应用能够获取发布到小组中的内容的用户详细信息

帮助管理员获取有关他们小组内发生的活动的汇总数据

在您管理的多个业务之间共享数据

转让或出售通过第三方获得的数据

建立或完善用户资料

根据用户行为重定位

跨小组映射用户互动操作

publish_to_groups

让应用能够代表授予此权限的用户在小组内发布内容。

审核

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

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

常见用途

让用户从您应用中把内容发布到他们所在的 Facebook 小组。

帮助用户管理发布到其所在小组的内容。

在用户不知情或没有控制权的情况下自动发布内容。

user_age_range

允许访问用户的年龄范围。

审核

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

常见用途

您的应用包含有法定年龄限制的内容,例如有关赌博、游戏或酒类的内容。

您的应用包含不适合一般 Facebook 受众的内容,例如约会、成人、血腥或暴力类型的内容。

您的应用包含面向青少年或儿童的内容。

用户的年龄范围对用户体验并无明显影响。

user_birthday

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

请注意,大多数集成仅需要 age_range 权限。

审核

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

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

常见用途

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

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

确定用户是否表示他们未满 18 岁、已满 18 岁或是已满 21 岁。请改用 age_range

user_events

要求接受应用审核

允许应用以只读方式访问用户组织或者回复过的活动。此权限仅限于某些合作伙伴,且必须事先通过 Facebook 的批准才能使用。

允许用法

方便查看日历和活动信息,例如设备应用、计划应用、音乐会应用等。

禁止用法

创建活动。

使用您的应用回复活动。

user_friends

允许访问也在使用您的应用的好友名单。这些好友可在用户对象的好友连线找到。此权限仅限于某些合作伙伴,且必须事先通过 Facebook 的批准才能使用。

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

审核

请求此权限要求您提交应用进行登录审核

常见用途

使用好友名单在应用中打造社交体验。

user_gender

允许访问用户的性别。

审核

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

常见用途

您的应用需要知道性别才能在一些用语中正确使用代词,例如,当智能助手向用户发送消息时。

您的应用根据性别提供个性化体验,例如购物或时尚类型的体验。

您希望向其他用户显示当前用户的性别,例如为了约会目的。

性别对用户体验并无明显影响。

填写注册表单或用户个人主页,并未使用此信息来增强用户体验。

user_hometown

通过用户对象hometown 字段提供用户家乡位置信息的访问权限。家乡位置由用户在个人主页中设置。

审核

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

常见用途

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

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

user_likes

允许访问用户赞过的所有 Facebook 主页和开放图谱对象的列表。该列表可通过用户对象赞连线来获取。此权限仅限于某些合作伙伴,且必须事先通过 Facebook 的批准才能使用。

审核

请求此权限要求您提交应用进行登录审核

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

常见用途

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

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

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

提供另一应用用户的 Facebook 个人主页网址的访问权限。

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

允许应用用户访问另一应用用户的 Facebook 个人主页,例如出于约会或本地名单目的。

尝试以编程方式确定某人的 Facebook 帐号或权威用户编号。

user_location

通过用户对象location 字段提供用户现居城市信息的访问权限。现居城市由用户在个人主页中设置。

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

审核

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

常见用途

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

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

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

user_photos

允许访问用户上传的或圈出此用户的照片。可通过用户对象照片连线来获取。此权限仅限于某些合作伙伴,且必须事先通过 Facebook 的批准才能使用。

审核

请求此权限要求您提交应用进行登录审核

常见用途

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

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

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

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

代表用户创建相册。

user_posts

允许访问用户的时间线帖子。包括用户自己发布的帖子、圈出用户的帖子以及其他用户在用户时间线上发布的帖子。此权限仅限于某些合作伙伴,且必须事先通过 Facebook 的批准才能使用。

审核

请求此权限要求您提交应用进行登录审核

常见用途

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

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

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

user_tagged_places

允许访问照片、视频、状态及链接中圈出用户的地点信息。此权限仅限于某些合作伙伴,且必须事先通过 Facebook 的批准才能使用。

审核

请求此权限要求您提交应用进行登录审核

常见用途

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

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

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

user_videos

允许访问用户上传的或圈出用户的视频信息。此权限仅限于某些合作伙伴,且必须事先通过 Facebook 的批准才能使用。

审核

请求此权限要求您提交应用进行登录审核

常见用途

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

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