Merchant API 測試帳戶功能提供安全且獨立的空間，讓您在實際環境中部署整合功能前，先進行全面測試。使用沙箱測試帳戶，您可以在開發週期初期試用 API 呼叫、驗證程式碼及找出潛在問題，而不必擔心影響正式環境資料、中斷即時作業，或是不慎違反 Merchant Center 政策。
必要條件
建立及使用測試帳戶前，請先確認您符合下列規定：
- Merchant Center 帳戶：你必須擁有 Merchant Center 帳戶。
- Merchant API 存取權：你必須是 Merchant API 的註冊使用者。
測試帳戶的優點
使用測試帳戶有幾項主要優點：
- 設定簡單：測試帳戶設定程序不複雜，可讓您快速開始測試功能和整合。
- 資料完整性和安全性：生產環境資料仍受到保護，且生產環境帳戶中不會有違規風險。
- 測試效率：您可以測試各種情境和極端情況，不必為了測試而維護平行製作帳戶。
- 立即驗證優惠：測試帳戶可自動免除首頁聲明和驗證程序，因此您可快速測試插入的優惠。測試帳戶的優惠預設為核准狀態。
- 模擬實際情況：這個環境會模擬產品上傳和庫存管理等重要功能的正式版行為，確保測試結果可靠。
- 更順暢的 API 遷移：測試帳戶可讓使用者並行驗證，從 Content API 遷移至 Merchant API，或從一個 API 版本遷移至另一個版本，確保遷移過程順利無虞。
如何建立測試帳戶
測試帳戶是透過 Merchant API 中的特定自訂方法建立。
使用 accounts.createTestAccount 方法：
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
Content-Type: application/json
Authorization: Bearer {ACCESS_TOKEN}"
{
"account_name": "{TEST_ACCOUNT_NAME}",
"time_zone": {
"id": "America/Los_Angeles"
},
"language_code": "en-US"
}
取代下列項目：
ACCOUNT_ID：你的 Merchant Center ID。ACCESS_TOKEN：用於發出 API 呼叫的授權權杖TEST_ACCOUNT_NAME：測試帳戶的名稱。建議使用有意義的名稱，表明這些名稱用於測試。舉例來說，測試帳戶名稱中包含「test」一詞。
建立測試帳戶時，必須填寫下列欄位：
time_zone：帳戶的報表和顯示時區。language_code：帳戶的 BCP-47 語言代碼，例如en-US。
如果呼叫成功，會傳回 Account 資源，其中包含新測試帳戶的專屬 accountId 和資源名稱：
{
"name": "accounts/{TEST_ACCOUNT_ID}",
"accountId": "{TEST_ACCOUNT_ID}",
"accountName": "{TEST_ACCOUNT_NAME}",
"adultContent": false,
"testAccount": true,
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
限制
測試帳戶專為功能驗證而設計，並有特定限制：
- 測試帳戶數量：每個 Google 帳戶最多可建立 5 個測試帳戶。測試帳戶會計入每個 Google 帳戶的 Merchant Center 帳戶預設限制。
- 整合 Merchant API 配額：就 API 配額而言，Merchant API 會將測試帳戶視為正式帳戶。測試帳戶的配額與正式版帳戶相同。無法提高測試帳戶的配額。
- 進階帳戶：您無法建立進階測試帳戶，也無法將進階帳戶轉換為測試帳戶。
- 不會公開放送：提交至測試帳戶的資料絕不會發布至任何 Google 平台，例如 Google 搜尋或購物廣告。
- 受限端點：使用特定功能時，您無法使用測試帳戶，例如：
- 連結限制：測試帳戶無法連結至其他 Google Ads 或 Google 商家檔案帳戶。
- 測試帳戶無法註冊：您無法為測試帳戶註冊。
最佳做法
使用測試帳戶時，建議您遵循下列最佳做法：
- 優先使用沙箱進行開發：請務必先在測試帳戶中驗證新的整合功能，再將其套用至正式環境。
- 自動化整合測試：使用測試帳戶做為穩定環境，執行自動化迴歸測試。
- 測試帳戶命名：使用
account_name提示每個測試帳戶的用途，例如「遷移測試」或「整合測試帳戶」。