存取層級和允許的使用方式

系統會為您的 Google Cloud 雲端專案指派存取層級和「允許用途」。存取層級會決定您是否可以影響正式環境帳戶，以及每日可執行的作業和要求數量。允許用途：決定專案可使用的特定 Google Ads API 功能。

存取層級

下表列出四種不同的 API 存取層級，如果您尚未取得 Google Ads API 存取權，可以先啟用 API，為 Google Cloud 專案取得測試帳戶存取權。如要提高存取層級，請在應用程式中完成一些額外步驟。

存取層級 可以存取... 每日交易次數上限 1 申請方式 審查通常需要多久時間？
測試帳戶存取層級 測試帳戶 每天 15,000 次作業 申請測試帳戶存取權
Explorer 存取層級 測試和正式版帳戶 正式環境帳戶：每日 2,880 項作業
測試帳戶：每日 15,000 項作業		 申請 Explorer 存取權
基本存取層級 測試和正式版帳戶 測試和正式環境帳戶每天可執行 15,000 項作業 申請基本存取權
標準存取層級 測試和正式版帳戶 測試和正式環境帳戶每天可執行的作業數量不限 申請標準存取權 10 個工作天

1「每日」是以 24 小時的滑動時間範圍為準，在此期間，API 要求是透過您的 Google Cloud 專案提出。如果應用程式在過去 24 小時內超出存取層級的要求限制，就會收到錯誤訊息。

測試帳戶存取層級

啟用 Google Ads API 後，Google Cloud 專案會獲得「測試帳戶存取權」層級。也就是說，專案只能對測試帳戶提出 Google Ads API 要求。

申請測試帳戶存取層級

在 Google Cloud 專案中啟用 Google Ads API，系統就會自動授予專案「測試帳戶存取權」層級的權限。

Explorer 存取層級

完成 Google Ads API 的初步註冊後，Google 可能會允許您申請 Explorer 存取層級。

探索存取層級可讓 Google Cloud 專案對測試帳戶和正式環境帳戶提出 Google Ads API 要求。正式版帳戶是指放送實際 Google 廣告的帳戶，測試帳戶則不會放送廣告。

探索存取層級允許您的 Google Cloud 專案每天對正式環境帳戶執行最多 2,880 項作業。這足以讓大多數開發人員開始使用 API，並建構基本自動化程序。

「探索者」存取層級會限制下列功能的存取權。如要使用這些功能，請申請基本存取層級或標準存取層級。

功能受限 受限制的服務和方法
建立帳戶 CustomerService.CreateCustomerClient
使用者管理 CustomerUserAccessInvitationService
CustomerUserAccessService
規劃 KeywordPlanService
KeywordPlanIdeaService
KeywordPlanCampaignService
KeywordPlanCampaignKeywordService
KeywordPlanAdGroupService
KeywordPlanAdGroupKeywordService
AudienceInsightsService
ReachPlanService
帳戶帳單與付款 PaymentsAccountService
BillingSetupService
AccountBudgetProposalService
InvoiceService

申請探索層級存取權

  1. 在 Google Cloud 專案中，前往 Google Ads API 總覽頁面。
  2. 確認頁面顯示目前的存取層級為「測試」。
  3. 按一下即可展開「升級存取層級」部分。
  4. 確認「下一個存取層級」顯示為「探索者」。
  5. 按一下「申請存取權」按鈕，申請探索者存取層級。

提交申請後，Google 可能會自動將專案的 API 存取層級升級為「探索者存取層級」。

基本存取層級

基本存取層級可讓 Google Cloud 專案對測試帳戶和正式環境帳戶提出 Google Ads API 要求。正式版帳戶是指放送實際 Google 廣告的帳戶，測試帳戶則不會放送廣告。

基本存取層級允許 Google Cloud 專案每天執行最多 15,000 項作業。這已足以滿足大多數開發人員的需求。

申請基本存取層級

  1. 在 Google Cloud 專案中，前往 Google Ads API 總覽頁面。
  2. 確認頁面顯示目前的存取層級為「探索者」。
  3. 按一下即可展開「升級存取層級」部分。
  4. 確認「下一個存取層級」顯示為「基本」。
  5. 確認沒有任何警告指出您尚未完成專案的品牌驗證。如有，請按照操作說明完成品牌驗證，再繼續進行後續步驟。
  6. 按一下「申請存取權」按鈕，申請基本存取層級。

提交申請後，Google 可能會自動將專案的 API 存取層級升級為基本存取層級。

標準存取權層級

標準存取層級允許 Google Cloud 雲端專案每天對所有服務執行無限次數的作業。個別服務和功能可能仍有頻率限制和限制，這些限制適用於這些功能，即使專案的存取層級為「標準」，仍會繼續適用。

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

申請標準存取權

  1. 在 Google Cloud 專案中，前往 Google Ads API 總覽頁面。
  2. 確認頁面顯示的目前存取層級為「基本」。
  3. 按一下即可展開「升級存取層級」部分。
  4. 確認「Next access level」顯示為「Standard」。
  5. 按一下「開始申請」按鈕，開始申請標準存取權層級。

申請標準存取權時，我們需要對您的應用程式進行詳細的人工稽核。請準備好回答有關工具功能和目標對象的問題。如果外部使用者會使用您的工具，請準備好提供工具的示範登入存取權。請注意，工具必須符合基本必備功能。

在審查過程中，Google 法規遵循團隊會透過您的電子郵件地址與您聯絡。請務必盡快回覆法規遵循團隊的查詢，以利標準存取權申請程序順利進行。審查完成後，Google 會寄送電子郵件通知你最終結果。

API 配額和系統速率限制

無論存取層級為何，所有 API 作業都受限於系統速率限制，也就是限制您在一段時間內可執行的作業數量 (每小時的作業數量)。如要進一步瞭解如何處理速率限制錯誤，請參閱錯誤類型。

由於產品設計限制、產品政策限制、API 效能和延遲考量等原因，個別服務可能會強制執行額外限制和配額限制。如要進一步瞭解這些限制，請參閱 API 配額說明文件。

允許的用途

僅適用於具有標準存取層級的 Google Cloud 專案。系統會根據 Google Ads API 的預期用途，分配允許的使用量。這些權限會決定工具可使用的 API 功能，詳情請參閱下表：

許可使用 說明
廣告製作 / 管理 提供 API 的所有服務存取權，用於建立及管理 Google Ads 廣告活動、廣告群組、廣告和關鍵字。
報表 只能發出 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 要求，或進行唯讀呼叫。如果開發人員只使用 API 要求統計資料，就適用這個選項。
研究關鍵字和建議 允許 Google Cloud 專案存取 RecommendationService、KeywordPlanIdeaService 和 KeywordPlanService。這項資訊僅供需要建議的工具使用，協助建立及管理 Google Ads 廣告活動。

變更允許的使用方式

如果您的 Google Cloud 雲端專案已獲准使用標準存取層級，可以填寫申請表更新允許用途。如要更新許可用途或授予客戶工具存取權，請填寫申請表。

上一頁
開發人員權杖
下一頁
品牌驗證