每個 Google Ads API 開發人員權杖都會指派存取層級和「允許使用」權限。存取層級會決定您是否可以影響實際帳戶,以及每天可執行的作業和要求數量。「許可使用」會決定開發人員權杖可使用的特定 Google Ads API 功能。
存取層級
表格中依序列出三個不同的存取層級。如果您還沒有 Google Ads API 存取權,請先註冊,取得測試帳戶存取權。您可以在應用程式中完成一些額外步驟,藉此提高存取層級。
存取層級 | 可以存取... | 每日操作次數上限1 | 套用 |
---|---|---|---|
測試帳戶存取權 | 測試帳戶 | 15,000 次操作 / 天 | 操作說明 |
基本存取權 | 測試帳戶和實際運作帳戶 | 15,000 次操作 / 天 | 操作說明 |
標準存取權 | 測試帳戶和實際運作帳戶 | 無上限的作業 / 天 | 操作說明 |
1「每日」是根據使用開發人員權杖提出 API 要求的 24 小時滑動時間區間計算。如果應用程式在過去 24 小時內超過您存取層級的要求限制,就會收到錯誤。
測試帳戶存取權
完成 Google Ads API 的初始註冊程序後,系統會核發具有測試帳戶存取權層級的開發人員符記。也就是說,開發人員符記只能針對測試帳戶提出 Google Ads API 要求。
申請測試帳戶存取權
在 Google Ads 網頁介面中完成 Google Ads API 註冊程序,即可自動取得測試帳戶存取層級。
基本存取權
基本存取權可讓開發人員符記針對測試帳戶和實際工作環境帳戶提出 Google Ads API 要求。正式帳戶是指放送實際的 Google 廣告帳戶,測試帳戶則不會放送廣告。
基本存取層級可讓開發人員權杖每天執行最多 15,000 項作業。這對大多數開發人員來說已足夠。
申請基本存取權
如果您擁有測試帳戶存取層級的開發人員權杖,且想申請實際執行帳戶存取權,請填寫基本存取權申請表單。請確認您已完成下列步驟:
- 請確認您已擁有具有測試帳戶存取層級的開發人員權杖。
- 請確認 API 中心中的 API 聯絡電子郵件已更新。您必須登入管理員帳戶,才能查看 API 中心。如果您沒有定期查看的有效電子郵件地址,就無法完成申請程序。請確認您已使用 API 權杖將所有有效的 Google Ads 帳戶連結至管理員帳戶。
標準存取權
標準存取權可讓開發人員憑證在一天內執行無限次數的操作,適用於大多數服務。包括但不限於 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 廣告活動。 |
變更允許使用情形
如果您已獲得基本存取層級或標準存取層級核准,可以填寫申請表單更新可接受的使用方式。如要更新允許使用情形或授予客戶存取工具的權限,請填寫申請表。