無論您是剛開始使用、維護應用程式,還是為現有整合服務新增功能,測試都是建構成功 Google Ads API 整合服務的重要步驟。本指南將介紹測試 Google Ads API 整合的最佳做法。
測試帳戶和正式版帳戶
測試帳戶可用於開發作業,您可以使用測試帳戶驗證應用程式程式碼和設定是否正常運作。
不過,並非所有功能都能在測試帳戶中測試。
如果測試帳戶的限制導致您無法測試整合中的某些功能,可以改用正式版帳戶進行開發。您的 Google Cloud 專案必須至少具備探索存取層級 (探索、基本或標準),才能呼叫正式環境帳戶。請注意,探索者存取權仍會限制特定服務,包括帳單 (BillingSetupService 和 AccountBudgetProposalService)、規劃、帳戶建立和使用者邀請 (請參閱「探索者功能限制」),這些服務需要基本或標準存取權。從具有「測試」存取層級的專案呼叫正式版帳戶時,系統會傳回 AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION (自 v25 起),或 AuthorizationError.ACTION_NOT_PERMITTED (在 v24 和更早版本中)。
開發用的正式版帳戶與測試帳戶的差異如下:
- 放送使用者可觀看的廣告
- 必須提供有效網址
- 必須遵守廣告政策
由於正式版帳戶會放送廣告,因此會產生指標,方便您測試成效報表,並解鎖 Google Ads API 的所有其他功能。不過,用於開發時必須格外謹慎。建議採取下列措施:
- 請只將存取權授予開發用途所需的使用者。
- 設定固定的低每日帳戶預算。
- 只有在無法使用測試帳戶時,才可使用正式版帳戶進行開發。
因此,如要完整測試整合,您可能需要測試憑證和正式環境憑證。
測試憑證
為盡量降低在嘗試修改開發帳戶時,不慎修改正式環境帳戶的風險,建議您維護一組與正式環境應用程式憑證不同的測試憑證。
如要建立一組測試憑證,請按照下列步驟操作:
- 建立電子郵件帳戶 (例如
api.test@example.com) 或服務帳戶,僅供測試用途。 - 在您用來執行測試的 Google Ads 帳戶中,將這個使用者或服務帳戶新增為有效使用者。請務必為這個使用者或服務帳戶授予適當的存取層級。請勿授予這個使用者或服務帳戶任何正式版帳戶的存取權。
- 如果您使用 OAuth 2.0 使用者驗證流程,而非服務帳戶流程,請為測試使用者帳戶產生更新權杖。
- 測試應用程式時,請使用這些新憑證。由於用戶端 ID 和用戶端密鑰不會影響可存取的 Google Ads 帳戶,因此可重複用於測試。請妥善儲存所有憑證和更新權杖,且絕不要將這些項目提交至來源控管。
提出驗證要求
如果您只是想測試要求是否有效 (例如驗證要求結構是否正確,以及是否違反政策),可以使用 validate_only 欄位,這個欄位適用於 GoogleAdsService.Search 要求 (請注意,GoogleAdsService.SearchStream 不支援 validate_only) 和大多數變更要求。請參閱參考說明文件,確認特定方法是否提供這個欄位。
REST API
舉例來說,如要進行臨時測試,驗證要求是否產生預期輸出內容,使用 REST API 通常是最簡單的方法。請參閱 REST 範例,瞭解如何使用 curl 向 REST API 發出要求。此外,請嘗試在 REST 探索工具中進行測試。