每個 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 權杖,將所有有效的 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 廣告活動的工具,才會使用這個值。 |
變更許可用途
如果您先前獲準使用基本存取權或標準存取層級,請填寫應用程式以更新許可用途。如果您要更新許可用途,或是將工具存取權授予用戶端,請填寫應用程式。