Fulfillment API をテストする

Order with Google のフルフィルメント API の購入手続き注文送信を実装したら、ハンドラをテストして両方のフローが機能することを確認します。

Prerequisites

フルフィルメント API のテストを準備するには、次の手順を行います。

  • パートナー ポータルで、Order with Google アカウントに関連付けられている GCP プロジェクトの編集権限があることを確認します。プロジェクトへのアクセス権は、Google Cloud Identity Access Management(IAM)コンソールを使用して確認および変更できます。

  • テストに使用するデータフィード JSON ファイルをアップロードします。データフィードには、少なくとも 1 つの Restaurant エンティティと、対応する Service エンティティと Menu エンティティを含める必要があります。Order with Google のデータフィードで作成した、有効なデータフィードのいずれかを使用できます。

  • 実装した ご購入手続き注文送信のアクション コードで、Fulfillment API を更新します。

  • 注文処理 URL エンドポイントが一般公開されていることを確認します。

テスト

購入手続きのテストは、パートナー ポータル自動統合テストまたはクイックテストか、有効なデータフィードを使用して行うことができます。可能であれば、自動テストメソッドを使用すると、結果をすばやくテストできます。

自動テストツールでテストする

パートナー ポータルには、購入手続きをテストし送信するために、フルフィルメント エンドポイントに対して実行できる一連の自動テストが用意されています。このテスト方法でテストプロセスを自動化し、再現可能なテストセットを用意することで、時間を節約できます。

フルフィルメント API の購入手続きハンドラと注文ハンドラを送信する手順は次のとおりです。

  1. 環境セレクタから適切な環境が選択されていることを確認します。
  2. パートナー ポータルの [Inventory > Integration Testing] に移動します。
  3. [新しいテスト] をクリックします。
  4. [Fulfillment endpoint] フィールドに、テストに使用するフルフィルメント エンドポイントの URL を入力します。
  5. [テストケース] セクションの [購入手続き] プルダウンで、実行するテストケースを選択します。最初は対象カート - オプションのない商品アイテムを選択することをおすすめします。
  6. [テストケース] セクションの [注文を送信] プルダウンで、注文送信ハンドラで実行するテストケースを選択します。まずは、対象となるカートのテストケースから開始することをおすすめします。
  7. サンプルと QPS パラメータも調整できます。
    • サンプル: テスト対象のランダムに選択されたレストラン エンティティの数。
    • QPS: フルフィルメント API がサポートする最大 QPS。
  8. テストを開始するには、[実行] をクリックします。

テストが完了するまで待ちます。選択したエンティティとテストケースの数によっては、最大で 20 分ほどかかることがあります。

統合テストの結果を確認して、フィードとフルフィルメント API が想定どおりに機能することを確認します。各テストの成功率は 95% 以上である必要があります。成功率の低いテストケースの場合は、テストケースをクリックすると、関連するエラー メッセージの詳細を確認できます。

クイックテストツールで手動でテストする

Order with Google サービスの有効なデータフィードを使用して、購入手続きとアクションの送信先をテストできます。このテストプロセスでは、クイックテストツールを使用して、ユーザーの注文フローを確認し、カートの購入手続きと注文送信をシミュレートします。

データフィードを手動でテストする手順は次のとおりです。

  1. パートナー ポータルダッシュボードのクイックテストに移動します。
  2. [ファイルをアップロード] を使用して、テストに使用するデータフィードをアップロードします。このファイルは NDJSON 形式である必要があります。
  3. アップロードが完了したら、[送信] をクリックします。
  4. データフィード ファイルの処理が完了するまで待ちます。この処理には数分かかることがあります。テーブルが自動的に更新されます。
  5. ステータスが [成功] になったら、[クイックテスト] をクリックします。
  6. [Test API] フィールドに、テストするフルフィルメント API エンドポイントを挿入します。
  7. [クイックテスト] をクリックして注文フローを開始します。
  8. Order with Google のフローに沿って、ご希望のレストランを選択し、カートを作成します。

  9. [ご購入手続き] ボタンをクリックして購入手続きのエンドポイントをテストします。

  10. 購入手続きが正常に完了したら、[注文] ボタンをクリックして送信エンドポイントをテストします。

  11. 注文が正常に送信されると、注文の詳細が記載された確認ページが表示されます。

参考情報

上記の手順に加えて、コンソールツールを使用して、注文処理のテストとトラブルシューティングをさらに行うことができます。

詳細なガイダンスについては、次のツールをご覧ください。

  • Chrome DevTools コンソールは、コンソールとフルフィルメント エンドポイントの間でリクエストとレスポンスの JSON を出力します。この出力を参照して、手動テストを行い、特定の問題のトラブルシューティングを行います。
  • フルフィルメント エンドポイントは、その Stackdriver ログを Google Cloud Console に出力します。フルフィルメント コードに関する問題のトラブルシューティングを行う場合は、これらのログで詳細なエラー メッセージを確認してください。