Permissions are a form of granular, app user-granted Graph API authorization. Before your app can use an API endpoint to access your app user's data, your app user must grant your app all permissions required by that endpoint.
Only select permissions that your app needs to function as intended. Selecting unneeded permissions is a common reason for rejection during app review.
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).
annual Data Use Checkup.
When your app users log onto your app, they receive a request to grant the permissions your app has requested. Your app 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, your app user must regrant your app that permission.
You can use the Meta App Dashboard to remove a permission your app no longer uses or to remove a permission that has been deprecated.
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
---|---|---|
ads_management Dependencies pages_read_engagement pages_show_list | ads_management 权限允许您的应用读取和管理两类广告帐户:自己拥有的广告帐户,或其他广告帐户所有者授予了访问权限的广告帐户。 此权限的合理使用方式是:以编程方式创建广告系列、管理广告或拉取广告指标,为业务发展助力。同时,此权限还可用于构建多种广告管理工具,为广告主带来创新型解决方案和差异化价值。
| 请提供具体示例,说明为什么您的应用需要代表其他企业管理广告。
Screencast Requirements
|
ads_read Dependencies None | ads_read 权限允许您的应用访问广告成效分析 API,以拉取两类广告帐户的广告报告信息:您拥有的广告帐户,或其他广告帐户所有者通过此权限授权您应用访问的广告帐户。此权限还允许您的应用访问服务器端 API,以便广告主可以从服务器将网站事件直接发送至 Facebook。
| 请提供具体示例,说明为什么您的应用需要代表其他企业访问广告及相关统计数据。
Screencast Requirements
|
attribution_read Dependencies None | attribution_read 权限允许您的应用访问广告归因分析 API,以拉取两类业务线的归因报告数据:自己拥有的业务线,或其他业务线所有者授权您应用访问的业务线。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
---|---|---|
catalog_management Dependencies business_management | catalog_management 权限允许您的应用创建、读取、更新和删除用户拥有管理员身份的商务管理平台中的商品目录。 The allowed usage for this permission is to build commerce-related solutions for ecommerce platforms, travel platforms and dynamic ads. It can also be used to build inventory type management solutions like product inventory, hotel inventory or car inventory.
| 请提供具体示例,说明为什么您的应用需要管理授予您访问权限的企业的商品目录。
Screencast Requirements
|
| commerce_account manage_orders 权限允许您的应用读取和更新电商帐户中的订单。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
| commerce_account_read_orders 权限允许您的应用读取电商帐户订单。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
| commerce_account_read_reports 权限允许您的应用读取财务报告数据,为电商帐户生成关税报告、现金收支对账报告和报销报告。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
| commerce_account_read_settings 权限允许您的应用读取电商帐户设置。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
| commerce_manage_accounts 权限允许您的应用创建和管理电商帐户,例如电商应用。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
---|---|---|
| email 权限允许您的应用读取用户的首选邮箱。 Allowed Usage
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
---|---|---|
gaming_user_locale
Dependencies gaming_profile | 当用户在 Facebook 玩游戏(例如,小游戏或云游戏)时,gaming_user_locale 权限允许您的应用读取他们的首选语言。 The allowed usage for this permission is to display a game interface in the user's preferred language.
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
---|---|---|
leads_retrieval
Dependencies
Ads Management Standard Access ads_management ads_read business_management pages_manage_ads pages_read_engagement pages_show_list | leads_retrieval 权限允许您的应用检索和读取线索广告表单(这些表单与使用广告管理工具或市场营销 API 创建的广告相关联)收集的所有信息。 The allowed usage for this permission is to contact people who completed your lead ad form requesting more information. This permission can also be used by advertiser authorized CRM platforms to pull the lead data on behalf of the advertisers.
| 请提供具体示例,说明为什么您的应用需要在授予您访问权限的公共主页上访问潜在客户信息。
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
---|---|---|
pages_events Dependencies pages_show_list | page_events 权限允许您的应用代表应用用户所管理的 Facebook 公共主页记录事件,并将这些事件发送给 Facebook 用于广告定位、优化和报告目的。 The allowed usage for this permission is to send businesses related activities (for example purchase, add-to-cart, lead) on behalf of Pages owned by the people who use your app.
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
pages_manage_ads Dependencies pages_show_list | pages_manage_ads 权限允许您的应用管理与公共主页相关的广告。 这项权限的允许用途是为公共主页创建和管理广告,或创建和管理直达公共主页关联的业务消息界面(例如 Messenger、Instagram Direct 或 WhatsApp)的广告。
Allowed Usage
|
Use Case Description
Screencast Requirements
|
| pages_manage_cta 权限允许您的应用对用于管理 Facebook 公共主页行动号召按钮的端点执行 POST 和 DELETE 函数。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
pages_manage_instant_articles Dependencies pages_show_list | pages_manage_instant_articles 权限允许您的应用代表应用用户所管理的 Facebook 公共主页管理即阅文。 The allowed usage for this permission is to create and update Instant Articles for Pages owned by the people who use your app.
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
pages_manage_engagement Dependencies pages_read_user_content pages_show_list | pages_manage_engagement 权限允许您的应用创建、编辑和删除发布到公共主页上的评论。 The allowed usage for this permission is to help manage and moderate content on the Page.
| 请提供具体示例,说明为什么您的应用需要代表其他用户在这些用户拥有的公共主页上管理评论。
Screencast Requirements
|
pages_manage_metadata Dependencies pages_show_list | pages_manage_metadata 权限允许您的应用订阅和接收有关公共主页动态的 Webhook,以及更新公共主页的设置信息。 The allowed usage for this permission is to help a Page Admin administer and manage a Page.
| 请提供具体示例,说明为什么您的应用需要代表拥有公共主页的其他用户管理相应公共主页的账户、设置或 Webhooks。
Screencast Requirements
|
pages_manage_posts Dependencies pages_read_engagement pages_show_list | pages_manage_posts 权限允许您的应用创建、编辑和删除您的公共主页帖子。 The allowed usage for this permission is to create and delete content on a Page.
| 请提供具体示例,说明为什么您的应用需要代表其他用户在这些用户拥有的公共主页上创建或管理帖子。
Screencast Requirements
|
pages_messaging Dependencies pages_manage_metadata pages_show_list | pages_messaging 权限允许您的应用管理和访问公共主页的 Messenger 对话。 这项权限的合理使用方式是:打造由用户发起的互动体验,发送客户支持消息,或者确认预订或购买和订单。
Allowed Usage
|
Use Case Description
Screencast Requirements
|
pages_read_engagement Dependencies pages_show_list | pages_read_engagement 权限允许您的应用读取下列内容和数据:公共主页发布的内容(帖子、照片、视频、活动)、粉丝数据(包括粉丝的姓名、公共主页范围编号)和头像,以及有关公共主页的元数据和其他成效分析。 The allowed usage for this permission is to help a Page Admin administer and manage a Page.
| 请提供具体示例,说明为什么您的应用需要代表其他用户读取发布到这些用户拥有的公共主页上的内容。
Screencast Requirements
|
pages_read_user_content Dependencies pages_show_list | pages_read_user_content 权限允许您的应用读取公共主页中的用户生成内容(例如用户或其他公共主页发布的帖子、评论和评分),以及删除公共主页帖子中的用户评论。 The allowed usage for this permission is to read user's and other Page’s content posted on the Page if you need it to help manage the Page.
| 请提供具体示例,说明为什么您的应用需要代表其他用户读取这些用户在自己公共主页上生成的内容。
Screencast Requirements
|
pages_show_list Dependencies 无 | pages_show_list 权限允许您的应用访问用户管理的公共主页列表。 The allowed usage for this permission is to show a person the list of Pages they manage and verify that a person manages a Page.
| 请提供具体示例,说明为什么您的应用需要访问某个用户拥有的公共主页列表。如果“pages_show_list 权限”被请求作为另一个主要权限的依赖项,请在用例描述中指明该主要权限。
Screencast Requirements
|
| pages_user_gender 权限允许您的应用通过与之关联的公共主页访问用户的性别信息。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
| pages_user_locale 权限允许您的应用通过与之关联的公共主页访问用户的语言/区域设置。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
| pages_user_timezone 权限允许您的应用通过与之关联的公共主页访问用户的时区信息。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
| pages_utility_messages 权限允许应用访问公共主页的交易相关消息模板。 此权限的合理使用方式是:管理公共主页的交易相关消息模板以及通过 Messenger 发送公共主页的交易相关消息。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
public_profile Dependencies 无 | public_profile(公开资料)权限允许应用读取 User(用户)节点的 Default Public Profile Fields(默认的公开资料字段)。系统将自动授予所有应用此权限。 The allowed usage for this permission is to authenticate app users and provide them with a personalized in-app experience.
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
publish_video Dependencies 无 | publish_video 权限允许您的应用将直播视频发布到应用用户的时间线、小组、活动或公共主页。 The allowed usage for this permission is to live-video stream to an app user's timeline, event or Page.
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
---|---|---|
read_audience_network_insights Dependencies None | The read_audience_network_insights permission allows an app to access the Audience Network insights data and pull performance report information for properties you own. The allowed usage for this permission is to integrate Audience Network properties performance data into app owner’s data analytics and dashboards.
Allowed Usage
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
Dependencies pages_read_engagement pages_show_list | read_insights 权限允许您的应用读取用户拥有的公共主页、应用和网域的成效分析数据。 Allowed Usage
|
Use Case Description
Screencast Requirements
|
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
---|---|---|
| The threads_basic permission allows an app to get a user's Threads profile information and the media and text content that they posted to Threads. The allowed usage for this permission is to display a user’s own Threads posts within an app, and make these visible only to the user who created them.
Allowed Usage
| 请提供具体示例,说明为什么您的应用需要“threads_basic”权限来访问用户的 Threads 主页信息以及发布到 Threads 的媒体和文本内容。
Screencast Requirements
|
| The threads_business_basic permission allows an app to fetch the Threads account ID that is connected to an Instagram account. The allowed usage for this permission is to retrieve a Threads account ID to use as the threads_user_id during the creation of ads on Threads. 您还可以使用这项权限请求获取成效分析,使用无法识别身份或经过匿名处理的汇总信息(前提是该类数据无法重新识别用户的身份)来改善应用,以及实现营销或广告投放目的。
Allowed Usage
| 请提供具体示例,说明在 Threads 上创建广告期间,为什么您的应用需要使用“threads_business_basic”检索“threads_user_id”。
Screencast Requirements
|
Dependencies threads_basic | The threads_content_publish permission allows an app to create and publish content on behalf of a Threads profile. The allowed usage for this permission is to enable an app user to create and publish content to their Threads profile. 您还可以使用这项权限请求获取成效分析,使用无法识别身份或经过匿名处理的汇总信息(前提是该类数据无法重新识别用户的身份)来改善应用,以及实现营销或广告投放目的。
Allowed Usage
| 请提供具体示例,说明为什么您的应用需要“threads_content_publish”权限来支持用户在其 Threads 主页上创建和发布内容。
Screencast Requirements
|
Dependencies threads_basic | The threads_delete permission allows an app to delete an app user's Threads posts. The allowed usage for this permission is to delete an app user's Thread posts. 您还可以使用这项权限请求获取成效分析,使用无法识别身份或经过匿名处理的汇总信息(前提是该类数据无法重新识别用户的身份)来改善应用,以及实现营销或广告投放目的。
Allowed Usage
| 请提供具体示例,说明为什么您的应用需要“threads_delete”权限来删除应用用户的 Threads 帖子。
Screencast Requirements
|
Dependencies threads_basic | The threads_keyword_search permission allows an app to search and fetch content with a specific keyword on behalf of a Threads user. The permission also allows for publishing responses to this fetched content. The allowed usage for this permission is to help the user manage their social media presence. 您还可以使用这项权限请求获取成效分析,使用无法识别身份或经过匿名处理的汇总信息(前提是该类数据无法重新识别用户的身份)来改善应用,以及实现营销或广告投放目的。
Allowed Usage
| 提供具体示例,说明为什么您的应用需要“threads_keyword_search”权限,以便通过在 Threads 上搜索和获取具有特定关键字的内容来管理您的社交媒体形象。
Screencast Requirements
|
Dependencies threads_basic | The threads_location_tagging permission allows an app to search for and fetch public locations using specific queries/keywords or coordinates on behalf of a Threads user and publish media with a location tagged. The allowed usage for this permission is to help users tag public locations to their posts and request locations when media is retrieved. 您还可以使用这项权限请求获取成效分析,使用无法识别身份或经过匿名处理的汇总信息(前提是该类数据无法重新识别用户的身份)来改善应用,以及实现营销或广告投放目的。
Allowed Usage
| 请提供具体示例,说明为什么您的应用需要“threads_location_tagging”权限来支持用户读取位置信息或发布带有位置信息的帖子
Screencast Requirements
|
Dependencies threads_basic | threads_manage_insights 权限允许您的应用访问 Threads 主页的成效分析。此权限的合理使用方式是:允许您的应用访问 Threads 主页的成效分析以及由该主页发布的各个串文的成效分析。 您还可以使用这项权限请求获取成效分析,使用无法识别身份或经过匿名处理的汇总信息(前提是该类数据无法重新识别用户的身份)来改善应用,以及实现营销或广告投放目的。
| 请提供具体示例,说明为什么您的应用需要“threads_manage_insights”权限,以便通过提供对您主页和各个 Threads 指标的深入见解来追踪您在Threads 上的表现。
Screencast Requirements
|
Dependencies threads_basic | The threads_manage_mentions permission allows an app to fetch content where the user is mentioned in on behalf of a Threads user. The allowed usage for this permission is to help the user manage their social media presence, which includes: showing public content and the public content tree that a user is mentioned in, enabling the user to sort user’s own mentioned threads, and enabling the user to publish responses to the public content tree that the user is mentioned in. 您还可以使用这项权限请求获取成效分析,使用无法识别身份或经过匿名处理的汇总信息(前提是该类数据无法重新识别用户的身份)来改善应用,以及实现营销或广告投放目的。
Allowed Usage
|
Use Case Description
Provide specific examples of why your app requires the
Screencast Requirements
|
Dependencies threads_basic | threads_manage_replies 权限允许应用代表 Threads 主页创建回复、隐藏或取消隐藏串文的回复,以及控制谁可以在该 Threads 主页上回复串文。此权限的合理使用方式是:允许应用代表 Threads 主页创建回复、隐藏或取消隐藏串文的回复,以及控制谁可以在该 Threads 主页上回复串文。 您还可以使用这项权限请求获取成效分析,使用无法识别身份或经过匿名处理的汇总信息(前提是该类数据无法重新识别用户的身份)来改善应用,以及实现营销或广告投放目的。
|
Use Case Description
请提供具体示例,说明为什么您的应用需要
Screencast Requirements
|
threads_profile_discovery Dependencies threads_basic | The threads_profile_discovery permission allows an app to access profiles for public Threads accounts and public posts of these accounts. The allowed usage for this permission is to allow the app's users to find profiles of public Threads accounts and public posts of these accounts to conduct competitor analyses.
Allowed Usage
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
Dependencies threads_basic | threads_read_replies 权限允许应用读取用户串文的回复。此权限的合理使用方式是:获取应用用户所拥有的串文的回复。 您还可以使用这项权限请求获取成效分析,使用无法识别身份或经过匿名处理的汇总信息(前提是该类数据无法重新识别用户的身份)来改善应用,以及实现营销或广告投放目的。
|
Use Case Description
请提供具体示例,说明为什么您的应用需要
Screencast Requirements
|
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
---|---|---|
whatsapp_business_manage_events Dependencies whatsapp_business_management | whatsapp_business_manage_events 权限允许应用代表应用用户所管理的 WhatsApp Business 商业账户记录购买、加入购物车、潜在客户等事件。 这项权限的允许用途是:记录 WhatsApp Business 商业账户中发生的事件并将这一动态数据发送给 Meta 用于广告定位、优化和报告。
|
Use Case Description
Visit the App Review documentation for guidance.
Screencast Requirements
请访问“应用审核”文档以获取指导。 |
whatsapp_business_management Dependencies None | whatsapp_business_management 权限允许您的应用读取和/或管理您拥有的 WhatsApp 业务资产,或由其他企业通过此权限授予您应用相应访问权限的 WhatsApp 业务资产。这些业务资产包括:WhatsApp Business 商业帐号、公司电话号码、消息模板、二维码及其关联消息,以及 Webhooks 订阅。 The allowed usage for this permission is to manage WhatsApp business assets and display WhatsApp Business Account analytics in your customer portal.
| 请说明您会如何使用“whatsapp_business_management”权限来访问已加入到此开放平台的业务客户的业务资产。
Screencast Requirements
|
whatsapp_business_messaging Dependencies whatsapp_business_management | whatsapp_business_messaging 权限允许应用向特定电话号码发送 WhatsApp 消息、上传和检索消息中的媒体、管理和获取 WhatsApp 商业简介信息以及使用 Meta 注册这些电话号码。 The allowed usage for this permission is to create messaging experiences initiated by a customer or a business.
| 请说明您的应用向已加入到此开放平台的业务客户提供了什么消息功能以及这些客户如何执行这些功能。
Screencast Requirements
|