無論是剛開始、維護應用程式,還是為現有整合新增功能,測試都是成功整合 Google Ads API 的重要步驟。本指南提供一些測試 Google Ads API 整合的最佳做法。
測試帳戶和正式帳戶
測試帳戶可用於開發。您可以使用測試帳戶,驗證應用程式程式碼和設定是否正常運作。
不過,測試帳戶無法測試所有功能。
如果測試帳戶限制導致您無法測試整合中的某些功能,可以改用正式版帳戶進行開發。Google Cloud 專案必須至少具備探索存取層級 (探索、基本或標準),才能呼叫正式環境帳戶。請注意,探索者存取權仍會限制某些服務,包括帳單 (BillingSetupService和AccountBudgetProposalService)、規劃、帳戶建立和使用者邀請 (請參閱探索者功能限制),這些服務需要基本或標準存取權。如果嘗試從存取層級為「測試」的專案呼叫正式版帳戶,自 v25 起會傳回 AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION,在 v24 和更早版本則會傳回 AuthorizationError.ACTION_NOT_PERMITTED。
用於開發的正式版帳戶與測試帳戶有以下差異:
- 放送使用者看得到的廣告
- 必須提供有效網址
- 必須遵守廣告政策
由於正式版帳戶會放送廣告,因此會產生指標,讓您測試成效報表,並解鎖 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 Explorer 中進行測試。