これは Recommendations AI のみに関するドキュメントです。制限付き一般提供フェーズで Retail Search と統合された Retail コンソールを試すには、Cloud 営業担当者にお問い合わせくださいRetail Search を使用する予定がない場合は、通知があるまで引き続き Recommendations コンソールを使用してください。

Recommendations AI の v1beta バージョンを使用している場合は、Retail API バージョンに移行してください。

ベータ版から Retail API への移行

Recommendations AI で Retail API を使用することになりました。このページでは、v1beta1 バージョンの Recommendations Engine API(サービス エンドポイント https://recommendationengine.googleapis.com)から、一般提供された Retail API(サービス エンドポイント https://retail.googleapis.com)に移行する際の変更内容と移行のベスト プラクティスについて説明します。

Recommendations Engine API とそのドキュメント セットは引き続き使用できますが、更新はされません。

このドキュメントは、Recommendations AI の使用をベータ版のときに開始した方のみを対象としています。

おすすめの方法

  • 移行を完了する前に、検証専用トラフィックを送信します。
  • トラフィックを段階的に移行するほうが、すべてを一度に移行する場合よりも優れています。可能であれば、トラフィックを v1beta1 から v2 に段階的に移行します。
  • 複数のリージョンでサービスを実行している場合は、グローバルのサービス停止を避けるため、リージョンを 1 つずつ移行することをおすすめします。

ドキュメントの変更

このドキュメント セットは、一般提供版の Retail API 用です。

Recommendations Engine API 用のベータ版ドキュメント セットとそのドキュメント セットは引き続き使用できますが、更新はされません。次のベータ版ドキュメントをご覧ください。

REST と RPC のパス

REST と RPC のパスには、多くの変更が行われています。Retail API の API ドキュメントを必ず確認し、Retail API を正しく呼び出していることを確認してください。

すべてのパスで recommendationengine.googleapis.com ではなく retail.googleapis.com を使用するようになりました。

次に例を示します。

v1beta1 Recommendations Engine API:

GET https://recommendationengine.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID

v2 Retail API:

GET https://retail.googleapis.com/v2/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID

一部のリソースとメソッドの名前が変更されたか、削除されたか、新しく追加されました。以下の表を使用して、v1beta1 のリソースを v2 と比較してください。

v1beta1 リソースへのリンクは、v1beta1 の API ドキュメントに移動することに留意してください。

v1beta1 リソース メソッド v2 リソース メソッド
catalogs list catalogs list
patch patch
該当なし catalogs.branches.operations get
catalogs.catalogItems create catalogs.branches.products create
delete delete
get get
import import
list 削除済み
patch patch
catalogs.operations get catalogs.operations get
list list
catalogs.eventStores.operations get 削除済み
list
catalogs.eventStores.placements predict catalogs.placements predict
catalogs.eventStores.predictionApiKeyRegistrations create 削除済み
delete
list
catalogs.eventStores.userEvents collect catalogs.userEvents collect
import import
list 削除済み
purge purge
rejoin rejoin
write write
該当なし operations get
list

IAM の変更

Recommendations AI の Identity and Access Management(IAM)のロールと権限に次の変更が導入されました。

  • Recommendations AI は、Recommendations Engine v1beta1 で使用されていた automlrecommendations 名前空間ではなく、retail 名前空間の IAM ロールと権限を使用します。
  • ロールAdmin Viewer を削除しました。
  • predict メソッドはこの後独自の API キーを必要としないため、apiKeys の権限が削除されました。

カタログとユーザー イベントのスキーマ

カタログとユーザー イベントのスキーマが Retail API で変更されました。