サービス提供構成を管理する

このページでは、サービス提供構成を削除、編集、一覧表示する方法と、各構成に関する統計情報の確認について説明します。

新しいサービス提供構成の作成方法については、サービス提供構成の作成をご覧ください。

既存のプレースメントがある場合や新しいプレースメントを作成する場合、Retail API は各プレースメントに関連付けられたサービス提供構成を自動的に作成します。サービス提供構成を作成しても、対応するプレースメントは作成されません。サービス提供構成を削除すると、対応するプレースメントが削除されます。プレースメントを削除すると、対応するサービス提供構成が削除されます。

サービス提供構成を編集する

サービス提供構成を編集するには、Retail コンソールまたは Retail API を使用します。

コンソールでサービス提供構成を編集する

各サービス提供構成のコントロールは、[サービス提供構成] ページで表示、編集できます。サービス提供構成をクリックすると、[詳細] ページが表示され、その構成のすべてのサービス提供とサイト全体のコントロールが一覧表示されます。

このページでは、コントロールを編集したり、新しいコントロールを作成したり、既存のコントロールを構成に適用したりできます。

新規作成または更新されたサービス提供構成がライブトラフィックを処理できるようになるまでに数分かかります。変更はすぐに [Evaluate] ページでテストできます。

サービス提供構成をインラインで編集する

サービス提供構成フィールドの更新、サービス提供コントロールの追加、サービス提供コントロールの削除は、Retail API メソッドを使用してインラインで行うことができます。

サービス提供構成をインラインでパッチ適用する

サービス提供構成のフィールドを更新するには、ServingConfig.patch を使用し、リクエスト本文に ServingConfig のインスタンスを含めます。更新するフィールドは updateMask パラメータで指定するか、サポートされているすべてのフィールドを更新するように設定しないでください。

このメソッドの詳細については、ServingConfig.patch API リファレンスをご覧ください。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

サービス提供構成にインラインでコントロールを追加する

サービス提供構成にコントロールを追加するには、ServingConfig.addControl を使用します。このコントロールは、そのコントロールが属するコントロールのリストの最後の位置に追加されます。たとえば、facetSpec コントロールは servingConfig.facetSpecIds の最後の位置に適用されます。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

サービス提供構成からインラインでコントロールを削除する

サービス提供構成からコントロールを削除するには、ServingConfig.removeControl を使用します。

このメソッドの詳細については、ServingConfig.removeControl API リファレンスをご覧ください。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:removeControl'

サービス提供構成を表示する

サービス提供構成を表示するには、Retail コンソールまたは Retail API を使用します。

コンソールでサービス提供構成を表示する

サービス提供構成はすべて、[サービス提供構成] ページで確認できます。

サービス提供構成をインラインで表示する

単一のサービス提供構成をインラインで表示するには、ServingConfig.get を使用します。

このメソッドの詳細については、ServingConfig.get API リファレンスをご覧ください。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

すべてのサービス提供構成をインラインで一覧表示するには、ServingConfig.list を使用します。

必要に応じて、パラメータ pageSize を使用して返される結果の最大数を設定できます。より多くの結果が使用可能な場合、list レスポンスにページトークンが含まれます。list リクエストの pageToken パラメータでページトークンを渡して、結果の次のページを取得できます。

このメソッドの詳細については、ServingConfig.list API リファレンスをご覧ください。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

サービス提供構成を削除する

サービス提供構成を削除するには、Retail コンソールまたは Retail API を使用します。

コンソールでサービス提供構成を削除する

コンソールでサービス提供構成を削除するには:

Google Cloud Console の [Retail Serving Configs] ページに移動します。

[サービス構成] ページに移動
削除するサービス提供構成をクリックして、詳細ページを開きます。
ページ上部のボタンバーで [削除] をクリックします。
サービス提供構成が有効だとみなされる場合は、ID を再入力して [確認] をクリックして削除を完了する必要があります。

サービス提供構成をインラインで削除する

単一のサービス提供構成をインラインで削除するには、ServingConfig.delete を使用します。

このメソッドの詳細については、ServingConfig.delete API リファレンスをご覧ください。

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

サービス提供構成の統計情報の確認

各サービス提供構成の詳細については、[Serving Configs] ページをご覧ください。表内の構成については、[分析情報の表示] をクリックすると統計情報が表示されます。

[クリック率] は、サービス提供構成の 1 回の検索でのクリック数を示します。[コンバージョン率] は、構成の 1 回の検索での購入を示します。