存取層級和許可用途

每個 Google Ads API 開發人員權杖都會獲得指派一個「允許使用」存取層級。存取層級會決定您是否能影響實際執行帳戶，以及每天可以執行的作業和要求數量。許可用途會決定開發人員權杖可使用的特定 Google Ads API 功能。

存取層級

表格中會依序列出三種不同的存取層級。如果您沒有 Google Ads API 存取權，請先註冊取得測試帳戶存取權。在應用程式中完成一些額外步驟，即可提高存取層級。

存取層級	可以存取...	每日作業限制¹	套用
測試帳戶存取權	測試帳戶	每日 15,000 次作業	操作說明
基本存取權	測試和實際執行帳戶	每日 15,000 次作業	操作說明
標準存取權	測試和實際執行帳戶	每日作業無數量限制	操作說明

¹「每天」是以 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 廣告活動。

如果您已經獲準取得基本存取權或標準存取層級，可以填寫申請更新許可用途表單。如果您要更新許可用途，或是授予用戶端存取工具的權限，請填寫應用程式。