存取層級和許可用途

每個 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 權杖,將所有有效的 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 廣告活動的工具,才會使用這個值。

變更許可用途

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