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 emailandpublic_profileif 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
| Permission | Description |
|---|---|
| ads_management 權限可讓您的應用程式同時讀取並管理廣告帳戶；這個帳戶可能是該應用程式自有的，也可能是廣告帳戶擁有者開放存取的。 Allowed Usage
|
| ads_read 權限可讓您的應用程式存取廣告分析報告 API 來提取廣告帳戶的廣告分析報告資料；這些帳戶可能是您自有的，也可能是其他廣告帳戶擁有者透過此權限開放您存取的。此權限也可讓您的應用程式存取伺服器端 API，以便廣告客戶將網絡事件從伺服器直接傳送到 Facebook。 Allowed Usage
|
| attribution_read 權限可讓您的應用程式存取歸因 API，以便提取您的業務歸因報告資料，或是得到其他業務擁有者授權存取的歸因報告資料。 Allowed Usage
|
C
G
I
| Permission | Description |
|---|---|
| instagram_basic 權限可讓您的應用程式讀取 Instagram 帳戶個人檔案的資訊和媒體。 Allowed Usage
|
| instagram_branded_content_ads_brand 權限可讓應用程式讀取應用程式用戶的 Instagram 帳戶標註為付費合作夥伴的 Instagram 帖子，並可讓應用程式用戶讀取、要求及撤銷刊登合作廣告的權限。 Allowed Usage
|
| 有了 instagram_branded_content_brand 權限，您的應用程式就可加入或移除特定品牌的已審查建立者名單中的建立者，以及檢視這些建立者。此權限允許的使用方式為管理特定品牌的 Instagram 建立者內容設定。 您也可以使用此權限來要求分析洞察報告，以改善應用程式，並用於營銷或廣告目的，方法是透過使用經過彙整並去除身分識別資訊或匿名處理的資訊（前提是此等資料不得重新加入身分識別資訊）。 Allowed Usage
|
| instagram_branded_content_creator 權限允許您的應用程式閱讀並變更創作者特定內容的加強推廣動態。此權限允許的使用方式為：管理 Instagram 創作者內容設定。 您也可以使用此權限來要求分析洞察報告，以改善應用程式，並用於營銷或廣告目的，方法是透過使用經過彙整並去除身分識別資訊或匿名處理的資訊（前提是此等資料不得重新加入身分識別資訊）。 Allowed Usage
|
| instagram_content_publish 權限可讓您的應用程式代商業用戶建立自然散佈動態相片和影片帖子。 Allowed Usage
|
| instagram_graph_user_media 權限可讓您的應用程式讀取媒體節點，這個節點代表圖片、影片或相簿以及節點的邊緣。 Allowed Usage
|
| instagram_graph_user_profile 權限可讓您的應用程式讀取其用戶的個人檔案。 Allowed Usage
|
| instagram_manage_comments 權限可讓您的應用程式代專頁所連結的 Instagram 帳戶建立、刪除及隱藏回應。您的應用程式亦可讀取並回覆商家被標註在內或 @提及的公開媒體和回應。 Allowed Usage
|
| 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_manage_insights 權限可讓您的應用程式存取 Facebook 專頁所連結 Instagram 帳戶的洞察報告。您的應用程式亦可探索並讀取其他商業檔案的個人檔案資訊和媒體。 Allowed Usage
|
| instagram_manage_messages 權限可讓商業用戶讀取並回覆 Instagram Direct 訊息。 Allowed Usage
|
| instagram_shopping_tag_products 權限允許應用程式使用商品標籤來標註 Instagram 媒體，以及對未通過批准的商品提出申訴。 Allowed Usage
|
P
| Permission | Description |
|---|---|
| page_events 權限可讓您的應用程式代其用戶管理 Facebook 專頁記錄事件，並將這些事件傳送到 Facebook 用於廣告目標設定、優化及分析報告。 Allowed Usage
|
| pages_manage_ads 權限可讓您的應用程式管理專頁所連結的廣告。 Allowed Usage
|
| pages_manage_cta 權限可讓您的應用程式對端點執行 POST 和 DELETE 功能，這些端點用於管理 Facebook 專頁上的呼籲字句按鈕。 Allowed Usage
|
| pages_manage_instant_articles 權限可讓您的應用程式代其用戶管理的 Facebook 專頁管理即時文章。 Allowed Usage
|
| pages_manage_engagement 權限可讓您的應用程式建立、編輯及刪除專頁上發佈的回應。 Allowed Usage
|
| pages_manage_metadata 權限可讓您的應用程式訂閱及接收專頁活動的相關 Webhooks，並在專頁上更新設定。 Allowed Usage
|
| pages_manage_posts 權限可讓您的應用程式建立、編輯及刪除專頁帖子。 Allowed Usage
|
| pages_messaging 權限可讓您的應用程式管理及存取 Messenger 中的專頁對話。 Allowed Usage
|
| pages_read_engagement 權限可讓您的應用程式讀取專頁所發佈的內容（帖子、相片、影片、活動）、讀取粉絲資料（包括姓名、PSID）以及個人資料相片，並讀取該專頁的元數據和其他洞察報告。 Allowed Usage
|
| pages_read_user_content 權限可讓您的應用程式讀取用戶在專頁上產生的內容（例如由用戶或其他專頁發佈的帖子、回應和評分），並刪除用戶對專頁帖子的回應。 Allowed Usage
|
| pages_show_list 權限可讓您的應用程式存取有人管理的專頁清單。 Allowed Usage
|
| pages_user_gender 權限可讓您的應用程式透過其連結的專頁存取用戶的性別。 Allowed Usage
|
| pages_user_locale 權限可讓您的應用程式透過其連結的專頁存取用戶的地區。 Allowed Usage
|
| pages_user_timezone 權限可讓您的應用程式透過其連結的專頁存取用戶的時區。 Allowed Usage
|
| The private_computation_access permission allows an app to access the Meta Private Computation products. Allowed Usage
|
| public_profile 權限可讓應用程式讀取用戶節點上的預設公開個人檔案欄位。此權限會自動授予所有應用程式。 Allowed Usage
|
| Deprecated for v19.0. Will be removed for all version April 22, 2024. publish_to_groups 權限可讓您的應用程式代替用戶將內容發佈到群組，前提是該用戶已為應用程式授予此權限。 Allowed Usage
|
| publish_video 權限可讓您的應用程式將直播視像發佈到應用程式用戶的生活時報、群組、活動或專頁。 Allowed Usage
|
U
W
| 權限 | 依賴項目 | 描述 |
|---|---|---|
|
| 如要獲准使用 |
|
| 如要獲准使用 |
|
| 如要獲准使用 |
|
| 如要獲准使用 |
|
| 如要獲准使用 |
|
| 如要獲准使用 |
|
| 如要獲准使用 |
|
| 如要獲准使用 |
|
| 如要獲准使用 |
|
| 如要獲准使用 |
|
| 如要獲准使用 |