存取層級和許可用途

每個 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 廣告活動的工具時,才會使用這個選項。

變更許可用途

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