存取層級和許可用途

每個 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 聯絡人電子郵件地址為最新資訊。您必須登入管理員帳戶,才能看到 API 中心。您必須提供有效且經常查看的電子郵件地址,才能完成申請程序。請確認您已使用 API 符記,將所有有效的 Google Ads 帳戶連結至管理員帳戶。

標準存取權

標準存取層級允許開發人員權杖每天執行無限次數的作業 (適用於大多數服務)。包括但不限於 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 廣告活動。

如何變更允許用途

如果您的開發人員權杖已獲准使用「基本存取權」或「標準存取權」層級,可以填寫申請表來更新允許的用途。如要更新許可用途或授予客戶工具存取權,請填寫申請表。