存取層級和許可用途

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

存取層級

下表列出四種不同的開發人員權杖存取層級。如果您還沒有 Google Ads API 存取權,可以先註冊取得測試帳戶存取層級的開發人員權杖。如要提高存取層級,請在申請時完成一些額外步驟。

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

1「每日」是以過去 24 小時的時間範圍為準,也就是您使用開發人員權杖發出 API 要求的時間。如果應用程式在過去 24 小時內超出存取層級的要求限制,就會收到錯誤訊息。

測試帳戶存取層級

完成 Google Ads API 的初步註冊後,系統會核發開發人員權杖,並將存取層級設為「測試帳戶存取權」。這表示開發人員權杖只能對測試帳戶提出 Google Ads API 要求。

如何申請測試帳戶存取層級

在 Google Ads 網頁介面完成 Google Ads API 註冊,即可自動取得測試帳戶存取權。

Explorer 存取層級

完成 Google Ads API 的初步註冊後,在某些情況下,Google 可能會自動將您的開發人員符記從測試帳戶存取權層級升級至探索者存取權層級。探索者存取權層級允許開發人員符記對測試帳戶和實際執行帳戶提出 Google Ads API 要求。實際執行帳戶是指放送實際 Google 廣告的任何帳戶,測試帳戶則不會放送廣告。

探索者存取層級允許開發人員權杖每天對實際執行帳戶執行最多 2,880 項作業。這足以讓大多數開發人員開始使用 API 並建構基本自動化功能。

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

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

如何申請「探索者」存取層級

在 Google Ads 網頁介面完成 Google Ads API 註冊。在某些情況下,完成註冊後,Google 可能會自動將開發人員權杖升級至探索者存取層級。

基本存取層級

開發人員權杖取得基本存取層級後,即可對測試和正式帳戶發出 Google Ads API 要求。正式帳戶是指放送實際 Google 廣告的帳戶,測試帳戶則不會放送廣告。

基本存取層級的開發人員權杖每天最多可執行 15,000 項作業,對大多數開發人員來說已足夠。

如何申請基本存取層級

如果您擁有「測試帳戶存取權」層級或「探索者存取權」的開發人員權杖,可以按照下列步驟申請「基本存取權」層級:

  1. 在網路瀏覽器中前往 https://ads.google.com/aw/apicenter。如果系統提示,請登入 Google Ads 管理員帳戶。

    存取 API 中心

  2. 確認「存取層級」為「測試帳戶」或「探索者」

  3. 請確認 API 中心的 API 聯絡電子郵件地址為最新資訊。您必須提供有效且定期檢查的電子郵件地址,才能完成申請程序。請確認您已將所有有效的 Google Ads 帳戶連結至具有 API 符記的 Google Ads 管理員帳戶。

  4. 按一下「存取層級」旁的下拉式箭頭,然後點選「申請基本存取權」連結。

完成 Google Cloud 專案的品牌驗證

審查基本存取權申請時,Google Ads API 會使用與開發人員權杖相關聯的 Google Cloud 專案品牌驗證狀態。您可以在 Google Cloud 專案中完成品牌驗證程序,加快基本存取權申請的審查程序。在某些情況下,Google 也可能會要求您在 Google Cloud 專案中完成品牌驗證,才能處理基本存取權申請。詳情請參閱品牌驗證指南

標準存取層級

標準存取層級允許開發人員權杖每天執行無限次數的作業 (適用於大多數服務),包括但不限於 GoogleAdsService SearchSearchStream。如要進一步瞭解標準存取層級的限制和例外狀況,請參閱「API 配額」。

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

如何申請標準存取層級

如果您擁有基本存取層級的開發人員權杖,可以按照下列步驟申請標準存取層級:

  1. 在網路瀏覽器中前往 https://ads.google.com/aw/apicenter。如果系統提示,請登入 Google Ads 管理員帳戶。

    存取 API 中心

  2. 確認「存取層級」為「基本」

  3. 請確認 API 中心的 API 聯絡電子郵件地址為最新資訊。您必須提供有效且定期檢查的電子郵件地址,才能完成申請程序。請確認您已將所有有效的 Google Ads 帳戶連結至具有 API 符記的 Google Ads 管理員帳戶。

  4. 按一下「存取層級」旁的下拉式箭頭,然後按一下「申請標準存取權」連結。

如果外部使用者會使用您的工具,請準備好提供工具的示範登入存取權。請注意,您的工具必須符合最低必要功能

API 配額和系統速率限制

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

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

許可使用

只有具備基本存取權和標準存取權的開發人員權杖,才能享有允許用途。允許用途是根據 Google Ads API 的預期用途分配。這些權限會決定開發人員權杖可用於哪些 API 功能,詳情請參閱下表:

許可使用 說明
廣告製作 / 管理 提供 API 的所有服務存取權,用於建立及管理 Google Ads 廣告活動、廣告群組、廣告和關鍵字。
報表 只能發出 GoogleAdsService.SearchGoogleAdsService.SearchStream 要求,或是唯讀呼叫。這適用於僅使用 API 要求統計資料的開發人員。
研究關鍵字和建議 允許開發人員權杖存取 RecommendationServiceKeywordPlanIdeaServiceKeywordPlanService。 這項資訊只會用於需要建議的工具,協助建立及管理 Google Ads 廣告活動。

如何變更允許用途

如果您的開發人員權杖已獲准使用基本存取層級或標準存取層級,請填寫申請表來更新允許的使用方式。如要更新允許的使用方式或授予客戶工具存取權,請填寫申請表。