本页面介绍如何删除、修改和列出服务配置,以及查看每项配置的统计信息。
如需创建新的服务配置方面的帮助,请参阅创建服务配置。
如果您已有展示位置,或者创建新的展示位置,则 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 删除服务配置。
在控制台中删除服务配置
如需在控制台中删除服务配置,请执行以下操作:
转到 Search for Retail 控制台中的服务配置页面。
转到“服务配置”页面点击要删除的服务配置,打开其详情页面。
点击页面顶部按钮栏中的 delete 删除。
如果服务配置被视为活跃,您必须重新输入其 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'
查看服务配置统计信息
您可以在“服务配置”页面上查看每项服务配置的详细信息。对于该表中的任何配置,点击查看分析可查看其统计信息。
点击率显示服务配置的每次搜索点击次数。转化率表示每次搜索带来的购买次数。