管理服务配置

本页面介绍如何删除、修改和列出服务配置，以及查看每项配置的统计信息。

如需创建新的服务配置方面的帮助，请参阅创建服务配置。

如果您已有展示位置，或者创建新的展示位置，则 Vertex AI Search for Retail 会自动创建与每个展示位置关联的服务配置。创建服务配置不会创建相应的放置位置。删除服务配置会删除其对应的放置位置，而删除展示位置则会删除其相应的服务配置。

修改服务配置

您可以使用 Search for Retail 控制台或 API 修改服务配置。

在控制台中修改服务配置

您可以在“服务配置”页面上查看和修改每项服务配置的控件。点击一项服务配置可查看其详细信息页面，其中列出了该配置的所有服务和网站级控件。

在此页面上，您可以修改控件、创建新控件或将现有控件应用于配置。

新创建的或更新的服务配置可能需要几分钟时间才能处理实时流量。您可以立即在评估页面上测试更改。

就地修改服务配置

您可以使用 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'

查看服务配置

您可以使用 Search for 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'

删除服务配置

您可以使用 Search for Retail 控制台或 API 删除服务配置。

在控制台中删除服务配置

如需在控制台中删除服务配置，请执行以下操作：

  1. 转到 Search for Retail 控制台中的服务配置页面。

    转到“服务配置”页面

  2. 点击要删除的服务配置，打开其详情页面。

  3. 点击页面顶部按钮栏中的 删除。

  4. 如果服务配置被视为活跃，您必须重新输入其 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'

查看服务配置统计信息

您可以在“服务配置”页面上查看每项服务配置的详细信息。对于该表中的任何配置，点击查看分析可查看其统计信息。

点击率显示服务配置的每次搜索点击次数。转化率表示每次搜索带来的购买次数。