授權

如要存取推廣 API 端點,您的應用程式必須清除 Graph API 授權的多個層級。

層級 1:應用程式類型

當您建立 Facebook 應用程式時,系統會詢問您該應用程式的用途。您所作的選擇會決定應用程式的類型:商業遊戲或者。請查看應用程式類型

若要存取推廣 API 端點,您需要建立商業應用程式。請查看商業應用程式可用的產品

註冊應用程式後,您可以為任何擁有開發人員帳戶而會助您開發應用程式的用戶分配角色。

層級 2:存取權限級別、權限和功能

商業應用程式還需受制於另一層 Graph API 授權層級,稱為存取權限級別。在應用程式審查期間,您的應用程式亦必須申請特定的權限和功能。

存取權限級別

存取權限級別說明

標準存取權限

商業應用程式會自動通過標準存取權限的審查,可以使用適用於商業應用程式類型的所有權限和功能。


如果您是新手入門,請使用此選項。您可以在申請完整權限之前先建立端到端工作流程。您可以使用的廣告帳戶不限數量。


由於有些 API 呼叫可能屬於多個帳戶,或者系統無法透過程式輔助的方式識別受影響的帳戶,因此可能無法以標準存取權限執行這些呼叫。

進階存取權限

如需獲批進階存取權限,則必須就各個權限和功能申請分別通過應用程式審查程序以獲批准。


如需申請進階存取權限,請前往您應用程式的管理中心,然後點擊應用程式審查 > 權限和功能


找出您想使用的權限或功能,然後點擊動作下方的申請進階存取權限。您可選擇一項或多項功能。選定選項後,點擊繼續要求,您將前往另一頁面,當中指示您完成整個提交流程。


提交資訊後,Facebook 會回覆批准或拒絕,如果您的應用程式不符合資格獲取標準存取權限,也會提供相關資訊。


如果您獲准使用進階存取權限,則需要完成以下操作以維持您的獲批狀態:

  • 在過去 15 天內成功執行了最少 1500 次推廣 API 呼叫。
  • 在過去 15 天內的推廣 API 呼叫出錯率低於 10%。

每個級別都設有各自的限制,詳情請參閱存取權限級別和功能。此外,所有開發人員亦必須遵守所有 Facebook 平台使用條款開發商政策就任何存取權限級別所執行的呼叫均以正式版數據為依據。

如要查看您目前的存取權限級別,請前往應用程式管理中心 > 應用程式審查 > 權限和功能

權限和功能

視乎您希望存取的 API,您應該要求的權限將有所不同。

如果您的應用程式僅用於管理自己的廣告帳戶,則標準存取權限以及 ads_readads_management 權限已足夠。如果您的應用程式需要管理其他人的廣告帳戶,則需要進階存取權限 ads_read 和/或 ads_management 權限。請查看適用於商業應用程式的所有權限

視乎您的 API 使用方式,您應該要求的功能將有所不同。如果您要管理廣告,您需要要求的其中一項常用功能則會是 Ads Management Standard Access。請查看適用於商業應用程式的所有功能

如要獲得廣告管理一般存取權限的進階存取權限,您的應用程式需要符合以下要求:

  • 在過去 15 天內成功執行了最少 1500 次推廣 API 呼叫。
  • 在過去 15 天內的推廣 API 呼叫出錯率低於 10%。

如果您要管理其他用戶的廣告,請使用 scope 參數來提示用戶提供 ads_managementads_read 權限。當用戶點擊允許後,您的應用程式就會取得存取權限:

https://www.facebook.com/v19.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management
    

輸入 YOUR_URL 欄位時,請在行尾加上 /。範例:http://www.facebook.com/

範例

使用案例要求內容

您想讀取及管理以下廣告帳戶的廣告:歸您所有或已獲廣告帳戶擁有者授予存取權限的廣告帳戶。

  • 權限:ads_management
  • 功能:Ads Management Standard Access

您想讀取以下廣告帳戶的廣告分析報告:歸您所有或已獲廣告帳戶擁有者授予存取權限的廣告帳戶。

  • 權限:ads_read
  • 功能:Ads Management Standard Access

您想提取一組客戶的廣告分析報告,並同時讀取及管理另一組客戶的廣告。

  • 權限:ads_managementads_read
  • 功能:Ads Management Standard Access

存取權限級別和功能

下表顯示了標準和進階存取權限級別對廣告管理標準存取權限功能的影響。

標準存取權限 進階存取權限

帳戶限制

管理無限量廣告帳戶。應用程式管理員或開發人員可代表廣告帳戶管理員或廣告客戶執行 API 呼叫。

假如您從廣告帳戶獲取了 ads_readads_management 權限,便可管理無限量的廣告帳戶。

傳輸限速

每個廣告帳戶設有相當嚴格的傳輸限速門檻。僅限開發目的使用,不適用於為實際廣告客戶運行的已發行應用程式。

每個廣告帳戶僅設有較寬鬆的傳輸限速門檻。

企業管理平台

僅可存取部分企業管理平台商品目錄 API。無法使用企業管理平台來管理廣告帳戶、用戶權限與專頁。

可存取所有企業管理平台商品目錄 API。

系統用戶

可建立 1 個系統用戶與 1 個管理員系統用戶。

可建立 10 個系統用戶與 1 個管理員系統用戶。

建立專頁

無法透過 API 建立專頁。

無法透過 API 建立專頁。

存取權限級別對比廣告管理標準存取權限

應用程式的權限和功能包含兩種不同的存取權限級別:標準存取權限和進階存取權限。請注意,此處的「標準存取權限」與「廣告管理標準存取權限」功能無關。廣告管理一般存取權限要求應用程式通過審查,然後才能獲得功能的進階存取權限。

層級 3:商家驗證

商家驗證是一項讓我們驗證您企業實體身分的程序;如果您的應用程式會存取敏感資料時,我們便會要求您完成此項驗證程序。進一步了解商家驗證程序。