存取層級和許可用途

每個 Google Ads API 開發人員權杖都會獲得指派一個「允許使用」存取層級。存取層級會決定您是否能影響實際執行帳戶,以及每天可以執行的作業和要求數量。許可用途會決定開發人員權杖可使用的特定 Google Ads API 功能。

存取層級

表格中會依序列出三種不同的存取層級。如果您沒有 Google Ads API 存取權,請先註冊取得測試帳戶存取權。在應用程式中完成一些額外步驟,即可提高存取層級。

存取層級 可以存取... 每日作業限制1 套用
測試帳戶存取權 測試帳戶 每日 15,000 次作業 操作說明
基本存取權 測試和實際執行帳戶 每日 15,000 次作業 操作說明
標準存取權 測試和實際執行帳戶 每日作業無數量限制 操作說明

1「每天」是以 24 小時的滑動時間範圍來計算,在此期間向您的開發人員權杖提出 API 要求。如果在過去 24 小時內超過您的存取層級要求限制,您的應用程式就會收到錯誤訊息。

測試帳戶存取權

完成 Google Ads API 的初始註冊程序後,您會收到包含測試帳戶存取層級的開發人員權杖。換句話說,開發人員權杖只能對測試帳戶提出 Google Ads API 請求。

申請測試帳戶存取權

在 Google Ads 網頁介面上完成 Google Ads API 註冊,自動取得測試帳戶存取層級。

基本存取權

基本存取權可讓開發人員權杖同時對測試帳戶和實際執行帳戶提出 Google Ads API 請求。實際執行帳戶是指用來放送實際運作中的 Google 廣告的任何帳戶,測試帳戶不會放送廣告。

基本存取層級可讓開發人員權杖每天執行多達 15,000 項作業。這對大多數開發人員來說已足夠。

正在申請基本存取權

如果您目前有測試帳戶存取層級開發人員權杖,並想申請正式版帳戶存取權,請填寫基本存取權申請表。請確認您已完成下列步驟:

  1. 確認您已有測試帳戶存取層級的開發人員權杖。
  2. 確認 API 中心的 API 聯絡電子郵件為最新版本。如果缺少有效的定期檢查電子郵件地址,就無法完成申請程序。請確認您已將所有有效的 Google Ads 帳戶連結至使用 API 權杖的管理員帳戶。

標準存取權

標準存取權可讓開發人員權杖每天無限次執行大多數服務的作業。包括但不限於 GoogleAdsService SearchSearchStream。如要進一步瞭解標準存取權的限制和例外狀況,請參閱 API 配額說明。

只有需要不限次數執行 Google Ads API 作業的開發人員 (例如服務規模大型公司或可因應大量使用者的工具),才會授予標準存取層級。

無論存取層級為何,所有 API 作業都設有系統頻率限制。如要進一步瞭解如何處理頻率限制錯誤,請參閱「錯誤類型」。

正在申請標準存取權

如果您目前擁有基本存取層級,且想要申請無限制的 Google Ads API 作業,請填寫標準存取權申請表

如果工具屬於外部工具,請準備好提供示範登入存取權的工具。請注意,您的工具必須符合基本必備功能的要求。

許可用途

許可用途僅適用於基本存取權和標準存取權杖。我們是根據 Google Ads API 的預定用途分配允許使用的號碼。這些權限會決定權杖可用的 API 功能,如下表所示:

許可用途 說明
廣告建立 / 管理 提供 API 所有服務的存取權,以便建立及管理 Google Ads 廣告活動、廣告群組、廣告和關鍵字。
報表 請只發出 GoogleAdsService.SearchGoogleAdsService.SearchStream 要求,或是唯讀呼叫。這種做法適用於僅使用 API 要求統計資料的開發人員。
研究關鍵字和建議 允許權杖存取 RecommendationService、KeywordPlanIdeaService 和 KeywordPlanService。但僅有工具需要提供相關建議,才能協助建立和管理 Google Ads 廣告活動。

變更許可用途

如果您已經獲準取得基本存取權或標準存取層級,可以填寫申請更新許可用途表單。如果您要更新許可用途,或是授予用戶端存取工具的權限,請填寫應用程式。