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

系統會為您的 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「每天」是指您的 Google Cloud 雲端專案提出 API 要求的 24 小時滑動時間範圍。如果應用程式在過去 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 存取層級升級為 Explorer。

基本存取層級

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

基本存取層級允許 Google Cloud 專案每天執行最多 15,000 項作業。對大多數開發人員來說,這已足夠。

申請基本存取層級

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

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

標準存取權層級

標準存取層級允許 Google Cloud 專案每天對所有服務執行無限次作業。個別服務和功能可能仍有其專屬的頻率限制和限制,即使專案具有標準存取層級,這些限制仍會繼續適用。

標準存取層級僅授予需要無限 Google Ads API 作業的開發人員,例如大型公司或服務眾多使用者的工具。

申請標準存取層級

  1. 前往 Google Cloud 專案的 Google Ads API 總覽頁面。
  2. 確認頁面顯示目前的存取層級為「基本」。
  3. 按一下即可展開「升級存取層級」部分。
  4. 確認「下一個存取層級」顯示為「標準」。
  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 專案已獲准使用標準存取層級,可以填寫申請表更新允許用途。如要更新許可用途或授予客戶工具存取權,請填寫申請表。