存取層級和許可用途

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

存取層級

下表列出四種不同的開發人員權杖存取層級，如果您尚未取得 Google Ads API 存取權，請先註冊，取得測試帳戶存取層級的開發人員權杖。如要提高存取層級，請在應用程式中完成一些額外步驟。

存取層級 可以存取... 每日操作次數上限1 申請方式 審查通常需要多久時間？
測試帳戶存取層級 測試帳戶 每天 15,000 次作業 操作說明
Explorer 存取層級 測試和正式版帳戶 正式版帳戶：每天 2,880 項作業
測試帳戶：每天 15,000 項作業 		操作說明
基本存取層級 測試和正式版帳戶 測試和正式版帳戶每天 15,000 項作業 操作說明 2 個工作天
標準存取層級 測試和正式版帳戶 測試和正式版帳戶每天可執行的作業次數不限 操作說明 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

如何申請 Explorer 存取層級

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

基本存取層級

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

基本存取層級的開發人員權杖每天最多可執行 15,000 項作業。這已足以滿足大多數開發人員的需求。

如何申請基本存取層級

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

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

    存取 API 中心

  2. 確認您的「存取層級」為「測試帳戶」或「Explorer」。

  3. 確認 API 中心的「API 聯絡人電子郵件」為最新資訊。您必須提供有效且經常查看的電子郵件地址，才能完成申請程序。請確認您已使用 API 符記，將所有有效的 Google Ads 帳戶連結至 Google Ads 管理員帳戶。

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

標準存取層級

在大多數服務中，開發人員權杖的標準存取層級每天可執行無限次數的作業。包括但不限於 GoogleAdsService Search 和 SearchStream。如要進一步瞭解標準存取層級的限制和例外狀況，請參閱「API 配額」。

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

如何申請標準存取層級

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

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

    存取 API 中心

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

  3. 確認 API 中心的「API 聯絡人電子郵件」為最新資訊。您必須提供有效且經常查看的電子郵件地址，才能完成申請程序。請確認您已使用 API 符記，將所有有效的 Google Ads 帳戶連結至 Google Ads 管理員帳戶。

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

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

API 配額和系統速率限制

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

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

許可使用

僅適用於具備基本存取權和標準存取權層級的開發人員權杖。許可用途是根據 Google Ads API 的預期用途分配。這些權限會決定開發人員權杖可用於哪些 API 功能，詳情請參閱下表：

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

如何變更允許用途

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

上一頁
開發人員權杖
下一頁
價目表