Instagram 圖形 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 開放平台

pages_messaging(傳送/接收 API)

這可讓您透過 Facebook 粉絲專頁傳送與接收訊息。此項權限無法用於傳送促銷或廣告內容。只有在用戶透過 Messenger 外掛程式或直接向您發送訊息,表示想要接收來自您傳送的訊息時,才可透過此 API 開始對話。

審查

如果您的應用程式要求此項權限,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

對於用戶擁有的應用程式「Audience Network」洞察報告資料,提供唯讀存取權。

審查

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

常見用途

將 Facebook 的應用程式 Audience Network 洞察報告整合至您自己的分析工具中。

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

提供任何不可見的洞察報告用途。

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 核准後才能使用。

審查

若要要求此項權限,您必須將應用程式送交登入審查

常見用途

存取影片以顯著加強應用程式內體驗(例如編輯、影像拼貼、作品集和投影片應用程式)。

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