每個 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 項作業。這對大多數開發人員來說已足夠。
正在申請基本存取權
如果您目前有測試帳戶存取層級開發人員權杖,並想申請正式版帳戶存取權,請填寫基本存取權申請表。請確認您已完成下列步驟:
- 確認您已有測試帳戶存取層級的開發人員權杖。
- 確認 API 中心的 API 聯絡電子郵件為最新版本。如果缺少有效的定期檢查電子郵件地址,就無法完成申請程序。請確認您已將所有有效的 Google Ads 帳戶連結至使用 API 權杖的管理員帳戶。
標準存取權
標準存取權可讓開發人員權杖每天無限次執行大多數服務的作業。包括但不限於 GoogleAdsService
Search
和 SearchStream
。如要進一步瞭解標準存取權的限制和例外狀況,請參閱 API 配額說明。
只有需要不限次數執行 Google Ads API 作業的開發人員 (例如服務規模大型公司或可因應大量使用者的工具),才會授予標準存取層級。
無論存取層級為何,所有 API 作業都設有系統頻率限制。如要進一步瞭解如何處理頻率限制錯誤,請參閱「錯誤類型」。
正在申請標準存取權
如果您目前擁有基本存取層級,且想要申請無限制的 Google Ads API 作業,請填寫標準存取權申請表。
如果工具屬於外部工具,請準備好提供示範登入存取權的工具。請注意,您的工具必須符合基本必備功能的要求。
許可用途
許可用途僅適用於基本存取權和標準存取權杖。我們是根據 Google Ads API 的預定用途分配允許使用的號碼。這些權限會決定權杖可用的 API 功能,如下表所示:
許可用途 | 說明 |
---|---|
廣告建立 / 管理 | 提供 API 所有服務的存取權,以便建立及管理 Google Ads 廣告活動、廣告群組、廣告和關鍵字。 |
報表 | 請只發出 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 要求,或是唯讀呼叫。這種做法適用於僅使用 API 要求統計資料的開發人員。 |
研究關鍵字和建議 | 允許權杖存取 RecommendationService、KeywordPlanIdeaService 和 KeywordPlanService。但僅有工具需要提供相關建議,才能協助建立和管理 Google Ads 廣告活動。 |
變更許可用途
如果您已經獲準取得基本存取權或標準存取層級,可以填寫申請更新許可用途表單。如果您要更新許可用途,或是授予用戶端存取工具的權限,請填寫應用程式。