每個 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 聯絡人電子郵件地址為最新資訊。您必須登入管理員帳戶,才能看到 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 廣告活動。 |
如何變更允許用途
如果您的開發人員權杖已獲准使用「基本存取權」或「標準存取權」層級,可以填寫申請表來更新允許的用途。如要更新許可用途或授予客戶工具存取權,請填寫申請表。