Permissions Reference for Meta Technologies APIs
權限是一種由應用程式用戶授予的精細圖形 API 授權。應用程式用戶必須先授予應用程式該端點所需的所有權限，您的應用程式才能使用 API 端點存取應用程式用戶的資料。
請只選擇應用程式執行預期功能所需的權限。選擇不必要的權限是應用程式未能通過審查的常見原因。
您也可以使用用戶授予應用程式的任何權限來索取分析報告，運用經彙總的去識別化或匿名資料（前提是這些資料無法再重新識別身分）改善應用程式，並將資料用於行銷或廣告宣傳用途。
程序規定
- Meta 應用程式審查：只要應用程式需存取不是您所擁有或管理的資料，便須送交審查。
- 如果您的應用程式要求取得權限，以使用端點存取應用程式用戶的資料，您可能必須完成資料處理問題。
- 您也可能必須完成年度資料使用情形檢查。
權限索取方式
應用程式用戶登入應用程式後，會收到授予應用程式所需權限的要求。應用程式用戶可以授予或拒絕提供您索取的權限或任何子權限。
如果您的應用程式連續 90 天沒有使用權限（通常是因為用戶沒有活動），應用程式用戶就必須重新授予該權限給應用程式。
移除權限
您可以使用 Meta 應用程式主控板移除應用程式不再使用的權限，或是移除已停用的權限。
A
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 的存取權，以提取業務範圍（您所擁有或獲得業務範圍所有人授予您存取權的業務範圍）的歸因分析報告資料。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
B
C
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 權限可讓應用程式讀取和更新商務帳號訂單。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
| commerce_account_read_orders 權限可讓應用程式讀取商務帳號的訂單。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
| commerce_account_read_reports 權限可讓應用程式讀取財務報告資料，以便為商務帳號製作自訂稅負現金調節和償付報告。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
| commerce_account_read_settings 權限可讓應用程式讀取商務帳號的設定。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
| commerce_manage_accounts 權限允許應用程式建立和管理商務帳號，例如電子商務應用程式。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
E
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
|---|---|---|
| email 權限允許應用程式讀取用戶的主要電子郵件地址。 Allowed Usage
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
F
G
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
|---|---|---|
gaming_user_locale
Dependencies gaming_profile | gaming_user_locale 權限可讓應用程式在用戶於 Facebook 玩遊戲時（例如即時遊戲或雲端遊戲），取得用戶的偏好語言。 The allowed usage for this permission is to display a game interface in the user's preferred language.
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
I
L
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
請參閱「應用程式審查」文件，以取得指引。 |
M
Permission
|
Description and allowed usage
|
What to include in App Review submission
|
|---|---|---|
| The manage_app_solution permission allows an app to get a list of apps that a user can manage, and make API calls on behalf of those apps. 此權限允許的使用方式就是，讓商家建立和管理技術供應商與解決方案合作夥伴之間的合作夥伴解決方案。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
| The manage_fundraisers permission allows an app to create, update, and read a fundraiser and its donations on behalf of a user.
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
marketing_messages_messenger Dependencies
| marketing_messages_messenger 權限可讓應用程式代表使用其授權廣告帳號的應用程式用戶，在 Messenger 上建立、管理和傳送付費行銷訊息，以及檢視這些行銷訊息行銷活動的成效。 此權限的允許使用方式是可讓應用程式用戶（例如商家）在 Messenger 上傳送付費行銷訊息給符合以下描述的對象：已選擇接收由應用程式用戶管理之特定 Facebook 粉絲專頁的公告和促銷訊息。 允許的使用方式
| 使用案例說明 Provide specific examples of why your app requires the
Screencast Requirements
|
P
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.
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
pages_manage_ads Dependencies pages_show_list | pages_manage_ads 權限允許應用程式管理與粉絲專頁相關聯的廣告。 此權限允許的用途是建立和管理粉絲專頁的廣告，或是與粉絲專頁相關聯的商務式訊息介面（例如 Messenger、Instagram Direct 或 WhatsApp）發訊廣告。 允許的使用方式
| 使用案例說明
Screencast Requirements
|
| pages_manage_cta 權限允許應用程式在端點執行「發佈」和「刪除」功能，以便管理 Facebook 粉絲專頁上的行動呼籲按鈕。
| 使用案例說明 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.
| 使用案例說明 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 的對話。 此權限允許的使用方式是建立用戶啟動的互動式體驗、傳送客戶支援訊息，或是確認預約或購物交易和訂單。
| 使用案例說明
Screencast Requirements
|
pages_read_engagement Dependencies pages_show_list | pages_read_engagement 權限允許應用程式讀取粉絲專頁發佈的內容（貼文、相片、影片、活動）、追蹤者的資料（包括姓名和PSID）和大頭貼照，以及關於粉絲專頁的中繼資料和其他洞察報告。 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 權限允許應用程式透過與應用程式連結的粉絲專頁存取用戶的性別。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
| pages_user_locale 權限允許應用程式透過與您應用程式連結的專頁存取用戶的地點。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
| pages_user_timezone 權限授予應用程式權限，可透過與您應用程式連結的粉絲專頁存取用戶的時區。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
| pages_utility_messages 權限允許應用程式存取粉絲專頁的工具訊息範本。 此權限允許的使用方式為管理粉絲專頁的工具訊息範本，以及透過 Messenger 傳送粉絲專頁的工具訊息。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
public_profile Dependencies 無 | public_profile 權限允許應用程式讀取用戶節點中的預設公開個人檔案欄位。此權限會自動授予所有應用程式。 The allowed usage for this permission is to authenticate app users and provide them with a personalized in-app experience.
| 使用案例說明 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.
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
R
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. 允許的使用方式
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
Dependencies pages_read_engagementpages_show_list | read_insights 權限允許應用程式讀取用戶擁有的粉絲專頁、應用程式和網路網域的洞察報告資料。 Allowed Usage
| 使用案例說明
Screencast Requirements
|
T
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 a business app, and make these visible only to the user who created them. 允許的使用方式
| 提供具體範例，說明為什麼您的應用程式需要「threads_basic」權限來存取用戶的 Threads 個人檔案資訊，以及發佈到 Threads 的影音和文字內容。
Screencast Requirements
|
| The threads_business_basic permission allows a business app to fetch the Threads account ID that is associated with an Instagram account within the Business Portfolio through matching username. 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. It is not intended for any other purpose. For example, using threads_business_basic permission in a consumer app is strictly prohibited. 您也可以使用這項權限來要求分析資料，運用經彙總的去識別化或匿名資料（前提是這些資料無法再重新用於識別身分）來改善應用程式，並將資料用於行銷或廣告宣傳用途。 允許的使用方式
| 提供具體範例，說明為什麼您的應用程式需要「threads_business_basic」在 Threads 上建立廣告時擷取「threads_user_id」。
Screencast Requirements
|
Dependencies threads_basic | The threads_content_publish permission allows a business app to create and publish content on behalf of a Threads profile. The allowed usage for this permission is to enable a business app user to create and publish content to their Threads profile. 您也可以使用這項權限來要求分析資料，運用經彙總的去識別化或匿名資料（前提是這些資料無法再重新用於識別身分）來改善應用程式，並將資料用於行銷或廣告宣傳用途。 允許的使用方式
| 提供具體範例，說明為什麼您的應用程式需要「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. 您也可以使用這項權限來要求分析資料，運用經彙總的去識別化或匿名資料（前提是這些資料無法再重新用於識別身分）來改善應用程式，並將資料用於行銷或廣告宣傳用途。 允許的使用方式
| 提供具體範例，說明為什麼您的應用程式需要「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. 您也可以使用這項權限來要求分析資料，運用經彙總的去識別化或匿名資料（前提是這些資料無法再重新用於識別身分）來改善應用程式，並將資料用於行銷或廣告宣傳用途。 允許的使用方式
| 提供具體範例，說明為什麼您的應用程式需要「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. 您也可以使用這項權限來要求分析資料，運用經彙總的去識別化或匿名資料（前提是這些資料無法再重新用於識別身分）來改善應用程式，並將資料用於行銷或廣告宣傳用途。 允許的使用方式
| 提供具體範例，說明為什麼您的應用程式需要「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. 您也可以使用這項權限來要求分析資料，運用經彙總的去識別化或匿名資料（前提是這些資料無法再重新用於識別身分）來改善應用程式，並將資料用於行銷或廣告宣傳用途。 允許的使用方式
| 使用案例說明 Provide specific examples of why your app requires the
Screencast Requirements
|
Dependencies threads_basic | threads_manage_replies 權限允許應用程式代表 Threads 個人檔案建立回覆、隱藏或取消隱藏串文的回覆，以及控制誰可以回覆 Threads 個人檔案中的串文。此權限允許的使用方式在於讓應用程式代表 Threads 個人檔案建立回覆、隱藏或取消隱藏串文的回覆，以及控制誰可以回覆 Threads 個人檔案中的串文。 您也可以使用這項權限來要求分析資料，運用經彙總的去識別化或匿名資料（前提是這些資料無法再重新用於識別身分）來改善應用程式，並將資料用於行銷或廣告宣傳用途。
| 使用案例說明 提供具體範例，說明為什麼您的應用程式需要
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. 允許的使用方式
| 使用案例說明 請提供具體範例，說明為何您的應用程式需要threads_profile_discovery 權限，以便用戶能夠存取公開 Threads 帳號的個人檔案和這些帳號的公開貼文。
Screencast Requirements
|
Dependencies threads_basic | threads_read_replies 權限允許應用程式讀取用戶串文的回覆。此權限允許的使用方式在於取得應用程式用戶擁有之串文的回覆。 您也可以使用這項權限來要求分析資料，運用經彙總的去識別化或匿名資料（前提是這些資料無法再重新用於識別身分）來改善應用程式，並將資料用於行銷或廣告宣傳用途。
| 使用案例說明 提供具體範例，說明為什麼您的應用程式需要
Screencast Requirements
|
threads_share_to_instagram Dependencies None | The threads_share_to_instagram permission allows your app to post your app user's Threads post to their linked Instagram account on behalf of the user. The allowed usage for this permission is to enable a user to post their Threads content to their linked Instagram account, either as a one-time action or automatically for future posts. 允許的使用方式
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
U
U
W
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 以用於廣告目標設定、最佳化和分析報告。
| 使用案例說明 Visit the App Review documentation for guidance.
Screencast Requirements
請參閱「應用程式審查」文件，以取得指引。 |
whatsapp_business_management Dependencies None | whatsapp_business_management 權限允許應用程式讀取及／或管理您所擁有的 WhatsApp 商家資產，或其他商家透過此權限授權您存取的商家資產。這些資產包括 WhatsApp Business 帳號、商家電話號碼、訊息範本、QR 碼和相關訊息，以及 webhook 訂閱。 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 註冊該電話號碼。 此權限的允許用途：建立由顧客或商家發起的傳訊和通話體驗。 允許的使用方式
| 說明應用程式可為已加入平台的商家顧客提供哪些訊息功能，以及他們如何執行這些功能。
Screencast Requirements
展示下列其中一項：
|