Retail のインタラクティブ チュートリアル

このページでは、Google Cloud Shell Editor で実行できるアクションを含む、Google Retail API のインタラクティブ チュートリアルの一覧を示します。このツールを使用すると、クラウド ネイティブ アプリケーションの作成、ビルド、テスト、実行、デバッグをブラウザから直接行うことができます。

概要

学習したい内容に応じて、さまざまなチュートリアルをお試しください。

カタログ情報をインポートする

これらのチュートリアルでは、カタログ情報を Retail API にインポートし、最新の状態に保つ方法について説明します。

BigQuery からカタログデータをインポート

このチュートリアルでは、BigQuery テーブルを使用して、大量のカタログデータを無制限にインポートする方法を説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

Cloud Storage からカタログデータをインポートする

このチュートリアルでは、カタログに多数のアイテムをインポートする方法を説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

インラインでカタログデータをインポートする

このチュートリアルでは、商品をインラインでカタログにインポートする方法について説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

カタログ情報を管理する

これらのチュートリアルでは、Retail API にカタログをインポートした後に商品情報を管理する方法について説明します。カタログ内の商品の読み取り、書き込み、削除を行うことができます。

選択した言語で Google Cloud Retail API を呼び出す方法を学びます。

商品の作成、取得、更新、削除のチュートリアル

このチュートリアルでは、以下のアクションを実行する Retail API Product Service メソッドの使用方法について説明します。

  • 商品を作成する
  • 商品を入手する
  • 商品を更新する
  • 商品を削除

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

商品作成のチュートリアル

このチュートリアルでは、単一の商品を作成する方法について説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

商品取得のチュートリアル

このチュートリアルでは、商品アイテムを取得する方法について説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

商品更新のチュートリアル

このチュートリアルでは、カタログ内の商品を更新する方法について説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

商品削除のチュートリアル

このチュートリアルでは、カタログから商品を削除する方法を説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

過去のユーザー イベントをインポートする

このチュートリアルでは、過去のイベントからユーザー イベントデータを一括インポートする方法について説明します。Retail API モデルでは、トレーニングにユーザー イベント データが必要です。

Cloud Storage チュートリアルからイベントをインポートする

このチュートリアルでは、Cloud Storage からユーザー イベントをインポートする方法を説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

BigQuery チュートリアルからイベントをインポートする

このチュートリアルでは、BigQuery からユーザー イベントをインポートする方法を説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

イベントのインライン チュートリアルをインポートする

このチュートリアルでは、ユーザー イベントデータをインラインでインポートする方法を説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

リアルタイムのユーザー イベントを記録する

このチュートリアルでは、リアルタイムのユーザー イベントを記録、表示、削除する方法について説明します。Retail API では、リアルタイムのユーザー イベントを使用しておすすめ情報と検索結果を生成します。有効な商品情報を使用してできるだけ多くの種類のユーザー イベントを記録することで、結果の品質が向上します。

ユーザー イベント作成のチュートリアル

このチュートリアルでは、userEvents.write メソッドを使用してユーザー イベントを記録する方法を説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

ユーザー イベントの再結合のチュートリアル

このチュートリアルでは、POST リクエストを userEvents:rejoin エンドポイントに送信して、ユーザー イベントを再結合する方法を説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

ユーザー イベント チュートリアルを削除する

このチュートリアルでは、ユーザー イベントを完全に削除する方法を説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

チュートリアルを検索

Retail API search() メソッドは、検索クエリや filter、facet、order_by などのパラメータに従ってカタログの検索に使用されます。

デフォルトでは、検索レスポンスには、関連性の高い順に並べられた妥当な数の検索結果が含まれます。

クエリのチュートリアル

このチュートリアルでは、シンプルな検索クエリを Retail サービスに送信し、そのレスポンスを分析する方法について説明します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

ページ分けのチュートリアル

このチュートリアルでは、検索リクエストでページネーションを制御する方法を示します。買い物客が店内の商品を探している場合、検索結果でナビゲーションを向上させることができます。たとえば、ページサイズ機能を使用して検索レスポンス内のアイテム数を制限したり、オフセット機能を使用して目的のページにジャンプしたりできます。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

クエリ拡張のチュートリアル

このチュートリアルでは、クエリ拡張機能を有効にする方法について説明します。買い物客があいまいなまたは複数の単語からなる検索フレーズを使用すると、空のレスポンスが返される場合があります。クエリ拡張を有効にすると、Retail Search はリクエストを分析し、解析された検索クエリに基づいて商品の拡張リストを返します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

フィルタリングのチュートリアル

このチュートリアルでは、フィルタリング機能について説明します。ご自身やお客様のニーズに応じて、検索リクエストを細かく調整できます。 単一または複数のフィールドでフィルタしたり、テキスト フィールドまたは数値フィールド、またはその両方でフィルタすることもできます。式言語を使用して、フィールドごとに述語を作成したり、論理演算子を使用して異なる式を結合したりできます。たとえば、靴を探している買い物客はフィルタを使用して、希望するブランドや色に検索結果を絞り込めます。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

並べ替えのチュートリアル

このチュートリアルでは、検索レスポンス内のアイテムを並べ替える方法について説明します。買い物客がサイトで商品を検索すると、Retail Search は複数のフィールド順で結果を表示できます。たとえば、買い物客が価格と割引が最高のドレスを探しているとします。ここでは価格と割引のフィールドが複数あります。Retail Search には、買い物客の洋服が価格順に表示され、同じ価格の洋服について割引順に表示されます。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

ブーストのチュートリアル

このチュートリアルでは、検索結果に商品が表示される様子の例を示します。ブースティングを使用すると、ブーストを検索結果に適用して、検索結果での優先順位付けを行えます。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

リダイレクト制御のチュートリアル

このチュートリアルでは、リダイレクト制御の使用方法について説明します。リダイレクト制御を使用すると、ユーザーが特定の検索クエリを使用するときにリダイレクトできる URL を指定できます。たとえば、ユーザーが「サステナブルな製品」をリクエストした場合は、作業中の環境ブランドを含むページにリダイレクトできます。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

Retail Search の在庫を更新する

Product の作成、読み取り、更新、削除（CRUD）メソッドは Product の属性の広範な変更に使用されますが、広告枠に固有のフィールドをさまざまな粒度で更新するために使用する一連の Product メソッドもあります。次の Product フィールドが広告枠フィールドとみなされます。

  • Product.price_info
  • Product.availability
  • Product.available_quantity
  • Product.fulfillment_info

フルフィルメント追加のチュートリアル

このチュートリアルでは、AddFulfillmentPlaces メソッドを使用して商品のフルフィルメント情報を更新する方法について説明します。このようにして、Retail Search は商品が入手可能で注文が納品可能な場所の最新情報を表示できます。たとえば、買い物客が店で青いジーンズを探しているが、在庫切れになっているとします。ジーンズの在庫がこの店や他の店でなくなったら、Retail Search に最新情報が表示され、買い物客は注文をに進むことができます。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

フルフィルメント削除のチュートリアル

このチュートリアルでは、[RemoveFulfillmentPlaces][remove-fulfillment-places] メソッドを使用して商品のフルフィルメント情報を更新する方法を示します。このように、Retail Search は商品の在庫がなく注文を履行できない更新も表示できます。たとえば、買い物客が店で青いジーンズを探しているとします。ジーンズがこの店舗で在庫切れになった場合、Retail Search は更新情報を表示し、買い物客は注文を続行できません。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

在庫設定のチュートリアル

このチュートリアルでは、商品全体を更新する代わりに、SetInventory メソッドを使用して在庫の更新を push する方法を示します。

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示