存取層級和許可用途

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

存取層級

表格中有三個不同的存取層級。如果您還沒有 Google Ads API 存取權，請先註冊以取得測試帳戶存取權。您可以完成其他的應用程式操作說明，提高存取層級。

存取層級	可以存取...	每日作業上限1	套用
測試帳戶存取權	測試帳戶	每天 15,000 次作業	操作說明
基本存取權	測試及實際執行帳戶	每天 15,000 次作業	操作說明
標準存取權	測試及實際執行帳戶	無上限作業 / 每日	操作說明

¹ 「每天」是以 24 小時的滑動期限計算，其中的 API 要求是使用您的開發人員權杖發出。如果應用程式在過去 24 小時內超出您的存取層級要求限制，會收到錯誤訊息。

測試帳戶存取權

完成 Google Ads API 的初始申請程序後，您會收到具有測試帳戶存取層級的開發人員權杖。也就是說，開發人員權杖只能對測試帳戶提出 Google Ads API 請求。

申請測試帳戶存取權

只要在 Google Ads 使用者介面中完成 Google Ads API 申請，系統就會自動為您授予測試帳戶的存取層級。

基本存取權

基本存取權可讓開發人員權杖對測試帳戶和正式版帳戶提出 Google Ads API 請求。「實際執行帳戶」是指放送實際即時 Google 廣告的帳戶 (測試帳戶不會放送廣告)。

基本存取層級可讓開發人員權杖每天執行多達 15,000 次作業。對大多數開發人員來說就夠用了。

申請基本存取權

如果您目前擁有測試帳戶存取層級的開發人員憑證，且想要申請正式版帳戶的存取權限，請填寫基本存取權申請表。請確認您已按照下列幾個簡單步驟操作：

1. 確認您已有開發人員測試帳戶存取層級。
2. 確認 API 中心的 API 聯絡電子郵件為最新狀態。如果沒有有效且定期檢查的開發人員聯絡電子郵件，您 就無法完成申請程序。確認您已使用 API 憑證連結所有有效的 Google Ads 帳戶，並連結至管理員帳戶。

標準存取權

標準存取權可讓開發人員權杖每天針對大部分的服務執行無限次作業。這包括但不限於 GoogleAdsServiceSearch 和 SearchStream。如要進一步瞭解相關限制和例外狀況，請參閱 API 配額頁面。

只有需要無限制 Google Ads API 作業 (通常是大型公司或為許多使用者提供服務的工具) 的開發人員，才能獲得標準存取層級。

申請標準存取權

如果您目前具有基本存取層級，且想申請不受限的 Google Ads API 作業，請填寫標準存取權申請表。

如果您的工具是外部的，請準備好提供工具登入示範。請注意，您的工具必須符合基本基本功能規定。

許可的用途

許可用途僅適用於基本存取權和標準存取權權杖。根據預期用途來分配 Google Ads API 的許可用途。這些權限會決定權杖可使用的 API 功能，如下表所示。

以下為許可用途清單：

允許的用途	說明
廣告製作 / 管理	提供所有 API 服務的存取權，以便建立及管理 Google Ads 廣告活動、廣告群組、廣告和關鍵字。
報表	只能發出 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 要求 (或唯讀呼叫)。這只適用於只透過 API 要求統計資料的開發人員。
研究關鍵字和建議	允許權杖存取 RecommendationService、KeywordPlanIdeaService 和 KeywordPlanService。只有需要提供建議以協助建立及管理 Google Ads 廣告活動的工具才會使用。

變更許可用途

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