图谱 API

Permissions Reference for Meta Technologies APIs

Permissions are a form of granular, user-granted Graph API authorization. Before your app can use an endpoint to access an app user's data, the app user must grant your app all permissions required by that endpoint.

Starting on or after October 27, 2023, if your app requests permission to use an endpoint to access an app user’s data, you may need to complete data handling questions. See this blog post and FAQs for more information.

Beginning September 5, some developers may also be required to answer data handling questions during their annual Data Use Checkup.

You may also use any permission granted to your app to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

Requirements

  • App Review is required for all permissions except for email and public_profile if your app needs access to data that you do not own or manage
  • Business Verification is required for all apps making requests for Advanced Access
  • Only select permissions that your app needs to function as intended. Selecting unneeded permissions is a common reason for rejection during app review

Ways to ask for a permission

When users log onto your app, they receive a request to grant the permissions your app has requested. Users can grant or deny the requested permissions or any subset of them.

If your app does not use a permission for 90 days, usually due to user inactivity, the app user must regrant your app that permission.

Remove a permission

You can use the app dashboard to remove a permission your app no longer uses or to remove a permission that has been deprecated.

A

PermissionDescription

ads_management

ads_management 权限允许您的应用读取和管理两类广告帐户：自己拥有的广告帐户，或其他广告帐户所有者授予了访问权限的广告帐户。
Allowed Usage
  • 以编程方式创建广告、管理广告和拉取指标。
  • 构建多种广告管理工具，为广告主带来创新型解决方案和差异化价值。

ads_read

ads_read 权限允许您的应用访问广告成效分析 API，以拉取两类广告帐户的广告报告信息：您拥有的广告帐户，或其他广告帐户所有者通过此权限授权您应用访问的广告帐户。此权限还允许您的应用访问服务器端 API，以便广告主可以从服务器将网站事件直接发送至 Facebook。
Allowed Usage
  • 允许通过 API 访问广告表现数据，以便在自定义面板和数据分析中使用。
  • 从您的服务器将网站事件直接发送至 Facebook。

attribution_read

attribution_read 权限允许您的应用访问广告归因分析 API，以拉取两类业务线的归因报告数据：自己拥有的业务线，或其他业务线所有者授权您应用访问的业务线。
Allowed Usage
  • 让您的应用可以访问广告归因分析中的广告表现数据，以便在自定义面板和数据分析中使用。

B

PermissionDescription

business_management

business_management 权限允许您的应用使用商务管理平台 API 执行读取和写入操作。
Allowed Usage
  • 管理广告帐户等商务管理平台资产。
  • 认领广告帐户。

C

PermissionDescription

catalog_management

catalog_management 权限允许您的应用创建、读取、更新和删除用户拥有管理员身份的商务管理平台中的商品目录。
Allowed Usage
  • 构建商业解决方案，例如电商平台、旅游平台和动态广告。
  • 构建库存类型管理解决方案，例如商品库存、酒店库存或汽车库存。

commerce_account_manage_orders

commerce_account manage_orders 权限允许您的应用读取和更新电商帐户中的订单。
Allowed Usage
  • 读取和更新电商帐户中的订单。
  • 让技术提供商可代表客户管理订单。
  • 查看 Webhook 通知。

commerce_account_read_orders

commerce_account_read_orders 权限允许您的应用读取电商帐户订单。
Allowed Usage
  • 读取电商帐户中的订单。
  • 将买家的邮箱用于营销目的，但前提必须是买家在结账时选择允许。

commerce_account_read_reports

commerce_account_read_reports 权限允许您的应用读取财务报告数据，为电商帐户生成关税报告、现金收支对账报告和报销报告。
Allowed Usage
  • 读取电商帐户的财务报告数据，生成关税报告、现金收支对账报告和报销报告
  • 技术提供方可代表其客户生成财务报告。

commerce_account_read_settings

commerce_account_read_settings 权限允许您的应用读取电商帐户设置。
Allowed Usage
  • 读取电商帐户的基本信息，比如绑定的渠道、配送选项、物流网点和关联商家等。

commerce_manage_accounts

commerce_manage_accounts 权限允许您的应用创建和管理电商帐户，例如电商应用。
Allowed Usage
  • 将您的应用与电商帐户关联。
  • 技术提供方代表其客户创建电商帐户。
  • 技术提供方在其客户的电商帐户内启用新的销售渠道。

E

PermissionDescription

email

email 权限允许您的应用读取用户的首选邮箱。
Allowed Usage
  • 与用户沟通，邀请他们使用与其 Facebook 个人主页关联的邮箱登录您的应用。

G

PermissionDescription

gaming_user_locale

 当用户在 Facebook 玩游戏（例如，小游戏或云游戏）时，gaming_user_locale 权限允许您的应用读取他们的首选语言。
Allowed Usage
  • 以用户的首选语言展示游戏界面。

groups_access_member_info

Deprecated for v19.0. Will be removed for all version April 22, 2024.


groups_access_member_info 权限允许您的应用读取公开的小组成员信息，例如姓名和编号，但前提是帖子作者向您的应用授予了访问权限。
Allowed Usage
  • 让应用能够获取小组中发布的内容及其用户详细信息。
  • 帮助管理员获取其小组内动态的汇总数据。

I

PermissionDescription

instagram_basic

instagram_basic 权限允许您的应用读取 Instagram 主页的信息和媒体内容。
Allowed Usage
  • 获取 Instagram 业务主页的基本元数据，例如帐号和编号。

instagram_branded_content_ads_brand

instagram_branded_content_ads_brand 权限允许应用在应用用户的 Instagram 帐户被标记为品牌合作伙伴时读取 Instagram 帖子，以及允许应用用户读取、请求和撤销投放合创广告的权限。
Allowed Usage
  • 在帐户被标记为品牌合作伙伴时读取 Instagram 帖子
  • 在不使用现有帖子的情况下管理投放合创广告的权限

instagram_branded_content_brand

 您的应用可通过 instagram_branded_content_brand 权限从特定品牌的获批创作者名单中添加、移除及查看创作者。此权限的允许用途是管理特定品牌 Instagram 创作者的内容设置。 您还可以使用这项权限请求获取成效分析，使用无法识别身份或经过匿名处理的汇总信息（前提是该类数据无法重新识别用户的身份）来改善应用，以及实现营销或广告投放目的。
Allowed Usage
  • 在企业的 Instagram 帐户中管理品牌创作者的内容设置。

instagram_branded_content_creator

instagram_branded_content_creator 权限允许您的应用读取并变更创作者特定内容的速推状态。此权限的允许用途是管理 Instagram 创作者内容设置。 您还可以使用这项权限请求获取成效分析，使用无法识别身份或经过匿名处理的汇总信息（前提是该类数据无法重新识别用户的身份）来改善应用，以及实现营销或广告投放目的。
Allowed Usage
  • 读取和更改 Instagram 创作者的内容设置。

instagram_content_publish

instagram_content_publish 权限允许您的应用代表商家创建照片和视频帖子并进行非付费发布。
Allowed Usage
  • 代表商家管理 Instagram 自然内容创建流程（例如：将照片和视频发布到动态版块）。

instagram_graph_user_media

instagram_graph_user_media 权限允许您的应用读取媒体节点（代表图片、视频或相册）及其连线。
Allowed Usage
  • 利用应用用户的照片制作实体书或电子书，包括导出照片进行打印。
  • 向应用内其他用户展示该用户的照片，例如在社交和交友类应用中。
  • 根据应用用户的现有照片和视频，编辑或制作新的照片或视频，例如在照片或视频编辑应用中。
  • 在电视或数字相框等外部设备中展示应用用户的照片和视频。

instagram_graph_user_profile

instagram_graph_user_profile 权限允许您的应用读取应用用户的主页信息。
Allowed Usage
  • 读取 Instagram 用户主页中的字段信息，例如：用户编号和帐户类型。

instagram_manage_comments

instagram_manage_comments 权限允许您的应用代表与公共主页绑定的 Instagram 帐户创建、删除和隐藏评论。您的应用还能读取和回复照片中标记了或 @ 提及了商家的公开媒体内容和评论。
Allowed Usage
  • Log events on Instagram accounts and send this activity data to Meta for ads targeting, optimization and reporting
  • Provide marketing and advertising analytics insights

instagram_manage_events

 The instagram_manage_events permission allows an app permission to log events (e.g., purchase, add-to-cart, leads) on behalf of Instagram accounts administered by the app’s users. The allowed usage for this permission is to log events on Instagram accounts and send this activity data to Meta for ads targeting, optimization and reporting; and to provide marketing and advertising analytics insights. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).
Allowed Usage
  • 获取 Instagram 业务帐户的元数据。
  • 获取 Instagram 业务帐户的数据成效分析。
  • 获取 Instagram业务帐户的快拍成效分析。

instagram_manage_insights

instagram_manage_insights 权限允许您的应用访问与 Facebook 公共主页绑定的 Instagram 帐户的成效分析。您的应用还可以发现和读取其他业务主页的信息和媒体内容。
Allowed Usage
  • 获取 Instagram 业务帐户的元数据。
  • 获取 Instagram 业务帐户的数据成效分析。
  • 获取 Instagram业务帐户的快拍成效分析。

instagram_manage_messages

instagram_manage_messages 权限允许商家读取和回复 Instagram Direct 消息。
Allowed Usage
  • 想要检索其 Direct 收件箱中的对话和消息的商家。
  • 想要管理与客户间来往消息的商家。
  • 想要使用第三方客户关系管理 (CRM) 工具管理其 Instagram Direct 收件箱的商家。

instagram_shopping_tag_products

instagram_shopping_tag_products 权限允许应用使用商品标记来标记 Instagram 媒体，以及对未通过审核的商品提出申诉。
Allowed Usage
  • 检查用户是否有资格标记商品
  • 获取目录和商品
  • 使用商品标记来标记媒体
  • 管理现有商品标记
  • 对未通过审核的商品提出申诉

L

PermissionDescription

leads_retrieval

leads_retrieval 权限允许您的应用检索和读取线索广告表单（这些表单与使用广告管理工具或市场营销 API 创建的广告相关联）收集的所有信息。
Allowed Usage
  • 联系已填写线索广告表单来请求更多信息的用户。例如，汽车经销商联系回应了其汽车报价广告的潜在客户（线索）。
  • 供广告主授权的 CRM 平台代表广告主拉取潜客线索数据。之后这些广告主可以使用潜客线索信息联系相关用户。

M

PermissionDescription

manage_fundraisers

 The manage_fundraisers permission allows an app to create, update, and read a fundraiser and its donations on behalf of a user.
Allowed Usage
  • 帮助筹款活动发起人扩大其在 Facebook 的覆盖人数。
  • 将筹款活动网站上显示的捐款金额同步到关联的 Facebook 筹款活动。

P

PermissionDescription

pages_events

page_events 权限允许您的应用代表应用用户所管理的 Facebook 公共主页记录事件，并将这些事件发送给 Facebook 用于广告定位、优化和报告目的。
Allowed Usage
  • 代表您的应用用户拥有的公共主页发送商家相关的事件（例如购物、加入购物车、留下线索）。

pages_manage_ads

pages_manage_ads 权限允许您的应用管理与公共主页相关的广告。
Allowed Usage
  • 为公共主页创建广告。
  • 为公共主页管理广告。

pages_manage_cta

pages_manage_cta 权限允许您的应用对用于管理 Facebook 公共主页行动号召按钮的端点执行 POST 和 DELETE 函数。
Allowed Usage
  • 提供 API 访问权限，以便管理您所管理的公共主页上的行动号召按钮。

pages_manage_instant_articles

pages_manage_instant_articles 权限允许您的应用代表应用用户所管理的 Facebook 公共主页管理即阅文。
Allowed Usage
  • 为应用用户拥有的公共主页创建和更新即阅文。

pages_manage_engagement

pages_manage_engagement 权限允许您的应用创建、编辑和删除发布到公共主页上的评论。
Allowed Usage
  • 对公共主页帖子发布评论。
  • 更新您对公共主页帖子的评论。
  • 删除对公共主页帖子的评论。
  • 为公共主页帖子点赞或取消赞。

pages_manage_metadata

pages_manage_metadata 权限允许您的应用订阅和接收有关公共主页动态的 Webhook，以及更新公共主页的设置信息。
Allowed Usage
  • 订阅并接收公共主页的 Webhook。
  • 更新公共主页的设置信息。

pages_manage_posts

pages_manage_posts 权限允许您的应用创建、编辑和删除您的公共主页帖子。
Allowed Usage
  • 将帖子、照片或视频发布到您的公共主页。
  • 更新您公共主页中的帖子、照片或视频。
  • 删除您公共主页中的帖子、照片或视频。

pages_messaging

pages_messaging 权限允许您的应用管理和访问公共主页的 Messenger 对话。
Allowed Usage
  • 打造由用户开启的互动体验。
  • 确认购买、订单和预约等客户互动。
  • 发送客户支持消息。

pages_read_engagement

pages_read_engagement 权限允许您的应用读取下列内容和数据：公共主页发布的内容（帖子、照片、视频、活动）、粉丝数据（包括粉丝的姓名、公共主页范围编号）和头像，以及有关公共主页的元数据和其他成效分析。
Allowed Usage
  • 获取您的公共主页发布的内容。
  • 获取您的公共主页粉丝的姓名、公共主页范围编号和头像。
  • 获取您公共主页的元数据。

pages_read_user_content

pages_read_user_content 权限允许您的应用读取公共主页中的用户生成内容（例如用户或其他公共主页发布的帖子、评论和评分），以及删除公共主页帖子中的用户评论。
Allowed Usage
  • 获取公共主页中的用户生成内容。
  • 获取标记了您的公共主页的帖子。
  • 删除用户在您的公共主页中发布的评论。

pages_show_list

pages_show_list 权限允许您的应用访问用户管理的公共主页列表。
Allowed Usage
  • 向用户展示他们所管理的公共主页列表。
  • 验证用户是否在管理某个公共主页。

pages_user_gender

pages_user_gender 权限允许您的应用通过与之关联的公共主页访问用户的性别信息。
Allowed Usage
  • 根据性别提供个性化体验或建议。
  • 准确使用性别相关的用语，如代词和称谓等。

pages_user_locale

pages_user_locale 权限允许您的应用通过与之关联的公共主页访问用户的语言/区域设置。
Allowed Usage
  • 根据用户的语言/区域设置向其展示相关的内容，为其打造个性化体验。
  • 以用户的首选语言进行回复。
  • 根据用户的语言/区域设置展示正确的数字、时间和日期。

pages_user_timezone

pages_user_timezone 权限允许您的应用通过与之关联的公共主页访问用户的时区信息。
Allowed Usage
  • 避免在用户不方便的时间发送消息。
  • 在特定的时间发送具有时效性的内容或定期新闻资讯。
  • 根据时间提供量身定制的内容。
  • 在适当的时间发送问候。

private_computation_access

 The private_computation_access permission allows an app to access the Meta Private Computation products.
Allowed Usage
  • Monitor private attribution datasets for a business.
  • Monitor instances for private attribution datasets for a business.
  • Create and manage instances for private attribution datasets for a business.

public_profile

public_profile（公开资料）权限允许应用读取 User（用户）节点的 Default Public Profile Fields（默认的公开资料字段）。系统将自动授予所有应用此权限。
Allowed Usage
  • 验证应用用户以及为用户提供个性化的应用内体验。

publish_to_groups

Deprecated for v19.0. Will be removed for all version April 22, 2024.


publish_to_groups 权限允许您的应用代表用户在小组内发布内容，前提是该用户已向您的应用授予了访问权限。
Allowed Usage
  • 允许用户从您应用将内容发布到他们所在的 Facebook 小组。
  • 帮助用户管理发布到其所在小组的内容。

publish_video

publish_video 权限允许您的应用将直播视频发布到应用用户的时间线、小组、活动或公共主页。
Allowed Usage
  • 向应用授予以下权限：将直播视频发布到应用用户的时间线、小组、活动或公共主页。

R

PermissionDescription

read_insights

read_insights 权限允许您的应用读取用户拥有的公共主页、应用和网域的成效分析数据。
Allowed Usage
  • 将 Facebook 的应用、公共主页或网域分析报告集成到您自有的分析工具中。

U

PermissionDescription

user_age_range

user_age_range 权限允许您的应用访问用户 Facebook 个人主页中所列的年龄范围信息。
Allowed Usage
  • 法律要求您的应用限制年龄。
  • 您的应用包含不适合 Facebook 一般用户群的内容，例如交友、暴力或成人内容。

user_birthday

user_birthday 权限允许您的应用读取用户 Facebook 个人主页中显示的生日。
Allowed Usage
  • 针对用户年龄不足的情况，为他们提供与年龄相关的内容。

user_friends

user_friends 权限允许您的应用获取应用用户的好友名单。
Allowed Usage
  • 提供与 Facebook 相关的内容，为用户打造个性化体验。

user_gender

user_gender权限允许您的应用读取用户 Facebook 个人主页中显示的性别信息。
Allowed Usage
  • 用于确定正确的代词。
  • 根据性别为用户打造个性化体验，例如在交友、购物和时尚应用中。

user_hometown

user_hometown 权限允许您的应用读取用户 Facebook 个人主页中显示的家乡信息。
Allowed Usage
  • 根据用户的曾住地和家乡，为他们打造个性化体验。

user_likes

user_likes 权限允许您的应用读取用户赞过的所有 Facebook 公共主页的列表。
Allowed Usage
  • 通过关联和呈现与用户点赞相关的内容，为他们打造个性化体验。以交友和音乐应用为例，这包括大规模收集内容，从而使用大量内容来定制应用，以及允许用户与他人分享自己点赞的兴趣爱好。
  • 允许家长版访问控制选项和监控应用，从而分析 18 岁以下用户的赞，以探寻潜在安全和健康问题，如应用的用户界面所示，此功能仅供 18 岁以下未成年人的家长和监护人使用，且具体用途仅限于青少年社交媒体分析。

user_link

user_link权限允许您的应用访问应用用户的 Facebook 个人主页网址信息。
Allowed Usage
  • 为您的应用用户提供访问其他用户 Facebook 个人主页的方式。

user_location

user_location 权限允许您的应用读取用户 Facebook 个人主页中“所在地”一栏显示的城市名称。
Allowed Usage
  • 根据用户 Facebook 个人主页中“所在地”一栏显示的城市名称提供个性化体验。

user_messenger_contact

 The user_messenger_contact permission allows a business to contact a person via Messenger upon their approval or initiation of a chat thread with the business's Page.
Allowed Usage
  • For a Page to send a person an initial message, post-purchase updates and account updates.

user_photos

user_photos 权限允许您的应用读取用户上传到 Facebook 的照片。
Allowed Usage
  • 使用用户的照片制作实体书或电子书，包括导出照片进行打印。
  • 为用户提供向其他应用用户展示自己照片的功能，例如在交友或社交应用中。
  • 为用户提供根据现有照片编辑或制作新照片内容的功能。

user_posts

user_posts 权限允许您的应用访问用户在其时间线上发布的帖子。
Allowed Usage
  • 允许用户按照自己的时间线创建实体或数字书籍或相册，并在 Facebook 或其他社交应用上分享时间线中的回忆。
  • 允许家长版访问控制选项和监控应用，从而分析 18 岁以下用户的帖子内容，以检测安全和健康方面的潜在风险，如应用的用户界面所示，此功能仅供 18 岁以下未成年人的家长和监护人使用，且具体用途仅限于青少年社交媒体分析。

user_videos

user_videos 权限允许您的应用读取用户上传的视频列表。
Allowed Usage
  • 通过机顶盒在电视上显示用户的视频，或者通过数码相框显示。
  • 为用户提供根据现有视频剪辑或制作新视频内容的功能。
  • 为用户提供在其应用内向所有者展示自己视频的功能，例如在交友或社交应用中。

W

PermissionDescription

whatsapp_business_management

whatsapp_business_management 权限允许您的应用读取和/或管理您拥有的 WhatsApp 业务资产，或由其他企业通过此权限授予您应用相应访问权限的 WhatsApp 业务资产。这些业务资产包括：WhatsApp Business 商业帐号、公司电话号码、消息模板、二维码及其关联消息，以及 Webhooks 订阅。
Allowed Usage
  • 管理 WhatsApp 业务资产。
  • 在您的客户门户网站中展示 WhatsApp 商业帐号分析数据。

whatsapp_business_messaging

whatsapp_business_messaging 权限允许应用向特定电话号码发送 WhatsApp 消息、上传和检索消息中的媒体、管理和获取 WhatsApp 商业简介信息以及使用 Meta 注册这些电话号码。
Allowed Usage
  • 向特定电话号码发送 WhatsApp 消息
  • 上传和检索消息中的媒体
  • 管理和获取 WhatsApp 商业简介信息
  • 使用 Meta 注册电话号码
权限依赖项描述

ads_management

pages_read_engagementpages_show_list

如要获准使用 ads_management，您的提交内容必须包含 pages_read_engagement 和 pages_show_list，或者您的应用必须已在上一次提交中获准使用 pages_read_engagement 和 pages_show_list。

instagram_basic

pages_read_engagementpages_show_list

如要获准使用 instagram_basic，您的提交内容必须包含 pages_read_engagement 和 pages_show_list，或者您的应用必须已在上一次提交中获准使用 pages_read_engagement 和 pages_show_list。

leads_retrieval

pages_manage_adspages_read_engagementpages_show_list

如要获准使用 leads_retrieval，您的提交内容必须包含 pages_manage_ads、pages_read_engagement 和 pages_show_list，或者您的应用必须已在上一次提交中获准使用 pages_manage_ads、pages_read_engagement 和 pages_show_list。

manage_pages（已停用）

pages_show_list

如要获准使用 manage_pages，您的提交内容必须包含 pages_show_list 或者您的应用必须已在上一次提交中获准使用 pages_show_list。

pages_manage_ads

pages_show_list

如要获准使用 pages_manage_ads，您的提交内容必须包含 pages_show_list 或者您的应用必须已在上一次提交中获准使用 pages_show_list

pages_manage_engagement

pages_read_user_contentpages_show_list

如要获准使用 pages_manage_engagement，您的提交内容必须包含 pages_read_user_content 和 pages_show_list，或者您的应用必须已在上一次提交中获准使用 pages_read_user_content 和 pages_show_list。

pages_manage_metadata

pages_show_list

如要获准使用 pages_manage_metadata，您的提交内容必须包含 pages_show_list 或者您的应用必须已在上一次提交中获准使用 pages_show_list

pages_manage_posts

pages_read_engagementpages_show_list

如要获准使用 pages_manage_posts，您的提交内容必须包含 pages_read_engagement 和 pages_show_list，或者您的应用必须已在上一次提交中获准使用 pages_read_engagement 和 pages_show_list。

pages_messaging

pages_manage_metadatapages_show_list

如要获准使用 pages_messaging，您的提交内容必须包含 pages_manage_metadata 或者您的应用必须已在上一次提交中获准使用 pages_manage_metadata。

pages_read_engagement

pages_show_list

如要获准使用 pages_read_engagement，您的提交内容必须包含 pages_show_list 或者您的应用必须已在上一次提交中获准使用 pages_show_list

pages_read_user_content

pages_show_list

如要获准使用 pages_read_user_content，您的提交内容必须包含 pages_show_list 或者您的应用必须已在上一次提交中获准使用 pages_show_list

Learn More