Instagram Graph API

instagram_basic

可讀取您具有存取權的 Instagram 帳戶。詳情請參閱 Instagram 新手指南

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

取得 Instagram Business 帳戶的基本元數據。

instagram_manage_comments

可讀取您具有存取權的 Instagram 帳戶。詳情請參閱 Instagram 新手指南

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

閱讀、更新、刪除 Instagram Business 帳戶的回應。

閱讀 Instagram Business 帳戶的媒體物件,例如限時動態。

instagram_manage_insights

可讀取您具有存取權之 Instagram 帳戶的分析報告。詳情請參閱 Instagram 新手指南

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

取得 Instagram Business 帳戶的元數據。

取得 Instagram Business 帳戶的資料分析報告。

取得 Instagram Business 帳戶的限時動態分析報告。

直播視像 API

publish_video

需要應用程式審查

授權應用程式將直播視像發佈到用戶的生活時報。

允許的使用方式

將直播視像串流到用戶的生活時報。

禁止的使用方式

串流播放廣告或任何違反 Facebook 內容政策的內容。

Messenger Platform

pages_messaging(傳送/接收 API)

這可以讓您利用 Facebook 專頁傳送/接收訊息。此權限無法用於傳送推廣或廣告內容。透過此 API 產生之對話只有在用戶表示(透過 Messenger 附加程式或直接傳送訊息給您)他們想收到您的訊息才會展開。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

建立用戶主導的互動體驗

確認預訂、購買及訂單等等

傳送客服訊息

追加銷售或交叉銷售產品或服務

傳送品牌廣告、電子報、公告或垃圾訊息

在沒有得到用戶同意的情況下傳送訊息給他們

pages_messaging_subscriptions

須通過應用程式審查

授權應用程式在初次用戶互動後,隨時透過 Facebook 專頁傳送訊息。您的應用程式只能透過贊助訊息或在用戶互動的 24 小時內,傳送廣告或推廣內容。

允許的使用方式

透過 Messenger 傳送訂閱訊息給用戶。

專頁與企業廣告素材

ads_management

可讓您同時讀取及管理廣告帳戶的廣告;這些帳戶可能是您自有的,也可能是擁有者透過此權限開放您存取的。

根據預設,在開發人員模式下,您的應用程式只能存取應用程式管理員所擁有的廣告帳戶。

使用方式


允許的使用方式

透過程式輔助的方式,建立宣傳活動、管理廣告及擷取數據。

建立可為廣告客戶提供創新解決方案和差異化價值的廣告管理工具。

禁止的使用方式

企業不得嘗試針對 Facebook 刊登引擎的運作方式進行反向工程。

企業不得嘗試複製過多相同的廣告來提高刊登機率。

ads_read

可讓您存取廣告分析報告 API 來提取廣告帳戶的廣告分析報告資料;這些帳戶可能是您自有的,也可能是其他廣告帳戶擁有者透過此權限開放您存取的。

此項權限不允許您更新購買、更新或修改廣告。

使用方式


允許的使用方式

對於您的廣告成效資料,提供 API 存取權,以用於自訂管理中心和資料分析。

禁止的使用方式

企業不得嘗試識別個人並鎖定他們刊登特定廣告。

企業不得在不同企業自有的產品中分享受眾。

企業不得在不同企業自有的產品中分享洞察報告。

business_management

使用企業管理 API 讀取與撰寫

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

管理如廣告帳戶等企業資源。認領廣告帳戶。

執行一般的網頁管理與限定管理。

leads_retrieval

Requires App Review.

Grants your app permission to retrieve all the information captured within a lead.

Allowed Usage

Leads are generally submitted by users in response to specific kinds of CTA (Sign ups, Get Quotes, etc.) shown on the ad. The information within the lead is used to reach out to the users to follow up on those CTA. For example, a dealer reaches out to a potential customer (lead) with quotes for a car.

By advertiser authorized CRM platforms to pull the lead data on behalf of the advertisers. The advertisers then use the lead information to reach out to the user.

Disallowed Usage

Share the lead data with anyone outside of the advertiser who ran the ads for capturing the leads.

Store additional information of the user outside of what was submitted on the lead form.

manage_pages

讓應用程式能夠擷取用戶所管理專頁和應用程式的專頁存取憑證。

應用程式需要 manage_pagespublish_pages 才能以專頁的身分發佈。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。您可代表列於應用程式管理中心「角色」部分中的用戶授予此項權限,而無須經過 Facebook 審查。

提交審查時,請務必讓我們的團隊能輕鬆重現您的指示。舉例來說,如果您的「專頁管理工具」有自己的驗證系統,請務必提供有效的登入方式(如用戶名稱/密碼),以便審查團隊使用您的工具並測試其功能。

常見用途

發佈內容至應用程式用戶擁有的專頁。發佈還需要 publish_pages 權限。

協助用戶管理已發佈至專頁的帖子、回應和讚好內容。

pages_manage_cta

須通過應用程式審查

允許應用程式對用於管理專頁呼籲字句按鈕的端點執行 POSTDELETE 操作。

允許的使用方式

提供 API 存取權,以管理您所管理專頁上的呼籲字句

pages_manage_instant_articles

讓您的應用程式代替其用戶管理的 Facebook 專頁管理即時文章。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。您可代表列於應用程式管理中心「角色」部分中的用戶授予此項權限,而無須經過 Facebook 審查。

如果要使用 WordPress 專用即時文章附加程式(或類似工具)將網誌帖子以即時文章格式發佈至,只要所代表發佈的用戶列於應用程式管理中心的「角色」部分,您就無須提交審查

提交審查時,請務必讓我們的團隊能輕鬆重現您的指示。舉例來說,如果您的應用程式有自己的驗證系統,請提供有效的登入資料(如用戶名稱/密碼),以便審查團隊使用您的工具並測試其功能。

常見用途

建立並更新您的應用程式用戶所擁有的專頁的即時文章。

pages_show_list

提供存取權,以顯示您所管理的專頁清單。

常見用途

提供對帳戶的 API 存取權,以顯示您所管理的專頁清單。

publish_pages

同時具備 manage_pages 權限時,應用程式能夠以應用程式用戶所管理的任何專頁的身分發佈、回應和讚好。

應用程式需要 manage_pagespublish_pages 才能以專頁的身分發佈。

此項權限無法讓您以個人帳戶身分發佈。

審查

如果您的應用程式要求此項權限,Facebook 必須審查應用程式會如何運用該權限。

透過應用程式審查要求此項權限時,請務必讓我們的團隊能輕鬆重現您的指示。

常見用途

讓用戶從自訂撰寫工具內,從應用程式明確發佈內容至所管理的任何 Facebook 專頁。

順暢代表用戶所管理的專頁讚好和回應。

在用戶不知情或無法控制的情況下,自動發佈動態。

以用戶未曾建立的內容預先填寫帖子的訊息參數,即使用戶能夠在分享前加以編輯或移除內容亦然。

read_audience_network_insights

對於用戶擁有的應用程式「流動廣告聯盟」洞察報告資料,提供唯讀存取權。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

將 Facebook 的應用程式「流動廣告聯盟」洞察報告整合至您自己的分析工具中。

將洞察報告資料轉讓或出售給第三方。

提供任何不明顯的洞察報告用途。

read_insights

對於用戶擁有的專頁、應用程式和網路網域的洞察報告資料,提供唯讀存取權。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

將 Facebook 的應用程式、專頁或網域洞察報告整合至您自己的分析工具中。

將洞察報告資料轉讓或出售給第三方。

提供任何不明顯的洞察報告用途。

read_page_mailboxes

讓您能夠讀取用戶所管理專頁的專頁收件匣。此項權限經常搭配 manage_pages 權限使用。

此項權限並不允許應用程式讀取專頁擁有者的信箱,而僅能讀取專頁信箱。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

讓用戶透過應用程式管理其專頁信箱。

用戶數據

預設欄位

預設欄位是公開個人檔案的一部分元素。這些欄位是 User 物件的下列屬性:

  • id
  • first_name
  • last_name
  • middle_name
  • name
  • name_format
  • picture
  • short_name

在網絡上,每次出現要求時都會暗示預設欄位,雖然您不需加以宣告,但建議最好還是使用 public_profile 來宣告。 在 iOS 和 Android 上,您必須在登入流程中使用 public_profile 要求這些欄位。

id 欄位是應用程式專屬編號。

審查

應用程式可使用這些欄位而無須經過 Facebook 審查。

email

透過 user 物件的 email 屬性,對於用戶的主要電郵地址,提供存取權。

請勿向用戶傳送垃圾郵件。 電郵的使用必須遵守 Facebook 政策垃圾郵件管制法(CAN-SPAM Act)

請注意:即使要求 email 權限,不保證會取得電郵地址。舉例來說,如果用戶使用電話號碼而非電郵地址來註冊 Facebook,則電郵欄位可能空白。

審查

應用程式可使用此項權限而無須經過 Facebook 審查。

groups_access_member_info

可讓您的應用程式將公開提供的群組成員資訊納入 API 回應中。如有群組成員選擇將個人資訊與群組應用程式分享,則可加入他們的預設 User 欄位。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

透過應用程式審查要求此項權限時,請務必讓我們的團隊能輕鬆重現您的指示。

常見用途

讓應用程式能夠取得群組中發佈且包含用戶詳細資料的內容

協助管理員彙整群組活動的洞察報告

在您多間旗下企業之間分享資料

傳輸或販售透過第三方取得的數據

建立或擴增用戶個人檔案

行為模式再次鎖定

跨群組對應用戶互動

publish_to_groups

可讓應用程式代表已獲授權的用戶在群組中發佈內容。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

透過應用程式審查要求此項權限時,請務必讓我們的團隊能輕鬆重現您的指示。

常見用途

讓用戶從您的應用程式發佈內容至其 Facebook 專頁。

協助用戶管理已發佈到其群組的內容。

在用戶不知情或無法控制的情況下,自動發佈內容。

user_age_range

提供對年齡層的存取權。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

您的應用程式包含依法需達到某個年齡門檻才能瀏覽的內容,例如賭博、遊戲或酒類。

您的應用程式包含不適合一般 Facebook 客群的內容,例如交友、成人或血腥暴力內容。

您的應用程式包含以兒童或青少年為導向的內容。

根據用戶的年齡層,對用戶體驗沒有明顯的影響。

user_birthday

存取用戶出生的日期和月份。視用戶的私隱設定和查詢此欄位所用的存取憑證而定,這不一定包括用戶出生的年份。

請注意,大多數的整合只需要 age_range

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

提交審查時,請清楚說明為何 age_range 無法滿足您的用途。

常見用途

根據用戶的出生日期資訊,向用戶提供年齡相關內容。

提供單靠年齡範圍不足以分析的年齡相關內容。

確定用戶是否 18 歲以下、年滿 18 歲或年滿 21 歲。請改用 age_range

user_events

須通過應用程式審查

提供唯讀權限讓應用程式存取用戶舉辦或回覆參加的活動。此權限僅限特定合作夥伴使用,而且需要經由 Facebook 核准後才能使用。

允許的使用方式

降低顯示行事曆和活動資訊的不便,例如:裝置應用程式、行事曆應用程式、演唱會應用程式等等。

禁止的使用方式

建立活動。

使用您的應用程式來回覆活動。

user_friends

對於也使用應用程式的朋友清單,提供存取權。這些朋友可在 user 物件的 friends 元素關係上找到。此權限僅限特定合作夥伴使用,而且需要經由 Facebook 核准後才能使用。

某用戶若要顯示在另一位用戶的朋友清單中,雙方必須都已經決定與應用程式分享朋友清單,而且未在登入期間停用該權限。 此外,雙方都必須在登入程序期間授予 user_friends 權限。

審查

您必須提交應用程式供登入審查才能要求這些權限。

常見用途

使用朋友清單以在應用程式中打造社交體驗。

user_gender

提供對用戶性別的存取權。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

您的應用程式需要性別以特定語言顯示人稱代名詞,例如在 Bot 傳送訊息給用戶時。

您的應用程式已根據性別個人化,例如購物或時尚。

您希望向他人顯示用戶的性別,例如在交友時。

根據性別,對用戶體驗沒有明顯的影響。

填寫註冊表格或用戶個人檔案,而不根據資訊來強化用戶體驗。

user_hometown

透過 User 物件hometown 欄位,提供對用戶家鄉位置的存取權。此欄位是由用戶在個人檔案中設定。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

根據用戶居住過或成長的地點,個人化用戶體驗。

協助用戶聯繫其他同家鄉的用戶。

user_likes

對於用戶讚好過的所有 Facebook 專頁和「開放式圖表」物件清單,提供存取權。此清單是透過 User 物件likes 元素關係提供。此權限僅限特定合作夥伴使用,而且需要經由 Facebook 核准後才能使用。

審查

您必須提交應用程式供登入審查才能要求這些權限。

如果您的應用程式要求此項權限,Facebook 必須審查應用程式會如何運用該權限。

常見用途

透過顯示與用戶活動相關的內容,打造個人化體驗。

明顯提供機會與其他有共同興趣的用戶建立聯繫。

根據用戶對某專頁讚好與否,限制存取應用程式或應用程式內的某些內容。

提供另一位應用程式用戶 Facebook個人檔案網址的存取權。

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

讓應用程式的某位用戶能瀏覽另一位用戶的 Facebook 個人檔案,例如交友或本地列表。

透過程式輔助的方式決定某人的 Facebook 用戶名稱或標準用戶編號。

user_location

透過 User 物件location 欄位,提供對用戶現居城市的存取權。現居城市是由用戶在個人檔案中設定。

現居城市未必與用戶家鄉相同。

審查

如果應用程式要求此項權限,Facebook 必須審查應用程式如何運用該權限。

常見用途

根據用戶現居城市,個人化用戶體驗。

顯示與用戶現居城市相關的內容。

協助用戶聯繫其他同城市的用戶。

user_photos

對於用戶上載或被標註的相片,提供存取權。此清單是透過 User 物件photos 元素關係提供。此權限僅限特定合作夥伴使用,而且需要經由 Facebook 核准後才能使用。

審查

您必須提交應用程式供登入審查才能要求這些權限。

常見用途

在數碼相框中顯示用戶相片。

協助用戶匯出相片以供列印。 僅為用戶的個人和非商業用途提供此服務。

存取相片以明顯用於加強應用程式內體驗(例如相片編輯、拼貼、投影片和臉孔合成應用程式)。

存取用戶以前的個人資料相片。

代替用戶建立相簿。

user_posts

對於用戶生活時報上的帖子,提供存取權。這包括用戶自己的帖子、被標註在內的帖子,以及其他用戶在生活時報上發佈的帖子。此權限僅限特定合作夥伴使用,而且需要經由 Facebook 核准後才能使用。

審查

您必須提交應用程式供登入審查才能要求這些權限。

常見用途

提供來自生活時報帖子的創意內容。

透過明顯地分析用戶生活時報上的帖子內容,為用戶提供價值。

非明顯運用此項資料,例如觀點分析或防禦垃圾帖子傀儡程式。

user_tagged_places

對於相片、影片、近況和連結中用戶被標註的地點,提供存取權。此權限僅限特定合作夥伴使用,而且需要經由 Facebook 核准後才能使用。

審查

您必須提交應用程式供登入審查才能要求這些權限。

常見用途

根據用戶曾經到過的地點,提供專屬內容。

根據用戶先前被標註的地點,建議到訪地點。

在地圖上顯示用戶的簽到記錄。

user_videos

對於用戶上載或被標註的影片,提供存取權。此權限僅限特定合作夥伴使用,而且需要經由 Facebook 核准後才能使用。

審查

您必須提交應用程式供登入審查才能要求這些權限。

常見用途

存取影片以明顯用於加強應用程式內體驗(例如編輯、拼貼、投影片合成應用程式。)

透過電視盒在電視上或在數碼相框中顯示用戶影片。