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 權限允許應用程式在端點執行「發佈」和「刪除」功能，以便管理 Facebook 粉絲專頁上的行動呼籲按鈕。 Allowed Usage
|
| pages_manage_instant_articles 權限允許應用程式代表您應用程式用戶所管理的 Facebook 粉絲專頁管理即時文章。 Allowed Usage
|
| pages_manage_engagement 權限允許應用程式建立、編輯和刪除發佈在粉絲專頁上的留言。 Allowed Usage
|
| pages_manage_metadata 權限允許應用程式訂閱和接收關於粉絲專頁動態的 Webhook，以及更新粉絲專頁的設定。 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
| 權限 | 相依於 | 說明 |
|---|---|---|
|
| 若要讓 |
|
| 若要讓 |
|
| 若要讓 |
|
| 若要讓 |
|
| 若要讓 |
|
| 若要讓 |
|
| 若要讓 |
|
| 若要讓 |
|
| 若要讓 |
|
| 若要讓 |
|
| 若要讓 |