管理服务配置

本页介绍了如何删除、修改和列出投放配置，以及查看每个配置的统计信息。

如需有关创建新的投放配置的帮助，请参阅创建投放配置。

如果您已有展示位置或创建新的展示位置，请使用 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'

删除服务配置

您可以使用 Retail Search 控制台或 API 删除投放配置。

在控制台中删除服务配置

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

前往 Search for Retail 控制台中的投放配置页面。

前往“投放配置”页面
点击要删除的投放配置以打开其详情页面。
点击页面顶部按钮栏中的删除。
如果投放配置被视为有效，您必须重新键入其 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'

查看投放配置统计信息

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

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