Merchant API のテスト アカウント

Merchant API テスト アカウント機能を使用すると、本番環境にデプロイする前に、統合を徹底的にテストできる安全で隔離されたスペースが提供されます。サンドボックス テスト アカウントを使用すると、本番環境データに影響を与えたり、リアルタイム オペレーションを中断したり、Merchant Center のポリシーに誤って違反したりすることなく、API 呼び出しをテストし、コードを検証し、開発サイクルの早い段階で潜在的な問題を特定できます。

前提条件

テスト アカウントを作成して使用する前に、次の要件を満たしていることを確認してください。

  • Merchant Center アカウント: Merchant Center アカウントが必要です。
  • Merchant API へのアクセス: Merchant API の登録ユーザーである必要があります。

テスト アカウントのメリット

テスト アカウントを使用すると、主に次のようなメリットがあります。

  • 簡単な設定: テスト アカウントの設定は複雑なプロセスではなく、機能と統合のテストをすぐに開始できます。
  • データの完全性と安全性: 本番環境データは保護されたままとなり、本番環境アカウントでのポリシー違反のリスクがなくなります。
  • テストの効率性: テスト用に並行して本番環境アカウントを維持する負担なしに、さまざまなシナリオとエッジケースをテストできます。
  • 即時提案の検証: テスト アカウントのホームページの所有権主張と検証が自動的に免除されるため、提案の挿入を迅速にテストできます。テスト アカウントでは、オファーはデフォルトで承認されます。
  • 現実的なシミュレーション: 環境は、商品のアップロードや在庫管理などの重要な機能について本番環境の動作を反映しているため、テスト結果の信頼性が確保されます。
  • API の移行をスムーズに: テストアカウントを使用すると、Content API から Merchant API への移行や、ある 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 など）。

呼び出しが成功すると、新しいテスト アカウントの一意の accountId とリソース名を含む Account リソースが返されます。

  {
    "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 ビジネス プロフィール アカウントにリンクすることはできません。
  • テスト アカウントの登録なし: テスト アカウントの登録はできません。

ベスト プラクティス

テスト アカウントを使用する際は、次のベスト プラクティスに沿って行うことをおすすめします。

  • サンドボックス優先の開発: 新しい統合機能を本番環境に適用する前に、必ずテスト アカウントで検証してください。
  • 自動統合テスト: テスト アカウントを、自動回帰テストを実行するための安定した環境として使用します。
  • テスト アカウントの命名: account_name を使用して、各テスト アカウントの目的（「移行テスト」や「統合テスト アカウント」など）を示します。