Vertex AI Search para retail cambia su nombre a Vertex AI Search para el sector del comercio. Estamos actualizando el contenido para reflejar la nueva marca.

Esta página se ha traducido con Cloud Translation API.

Gestionar configuraciones de publicación

En esta página se describe cómo eliminar, editar y enumerar las configuraciones de publicación, así como consultar estadísticas sobre cada configuración.

Si necesitas ayuda para crear una configuración de publicación, consulta el artículo Crear configuraciones de publicación.

No es necesario configurar una configuración de servicio para que funcione la búsqueda. Se puede colocar cualquier serving_config_id como parte de la solicitud de búsqueda. En ese caso, se asigna de forma predeterminada un control de publicación vacío o sin configurar. A continuación, se busca en el catálogo con la función de búsqueda predeterminada de Vertex AI Search para el sector del comercio.

Si ya tiene emplazamientos o crea otros nuevos, Vertex AI Search for commerce creará automáticamente una configuración de publicación asociada a cada emplazamiento. Crear una configuración de publicación no crea un emplazamiento correspondiente. Si se elimina una configuración de publicación, se elimina el emplazamiento correspondiente, y si se elimina un emplazamiento, se elimina la configuración de publicación correspondiente.

Editar configuraciones de publicación

Puedes editar las configuraciones de publicación mediante la consola de búsqueda de comercio o la API.

Editar configuraciones de publicación en la consola

Puedes ver y editar los controles de cada configuración de servicio en la página Configuraciones de servicio. Haga clic en una configuración de publicación para ver su página Detalles, en la que se muestran todos los controles de publicación y de todo el sitio de esa configuración.

En esta página, puedes editar controles, crear controles o aplicar controles a la configuración.

Las configuraciones de publicación recién creadas o actualizadas tardan unos minutos en estar listas para publicar tráfico real. Puede probar los cambios de inmediato en la página Evaluar.

Editar configuraciones de publicación directamente

Puedes actualizar los campos de configuración de publicación, añadir controles de publicación y quitar controles de publicación insertados mediante métodos de API.

Aplicar parches a las configuraciones de publicación de forma directa

Para actualizar los campos de una configuración de servicio, usa ServingConfig.patch e incluye una instancia de ServingConfig en el cuerpo de la solicitud. Especifica los campos que quieras actualizar con el parámetro updateMask o déjalo sin definir para actualizar todos los campos admitidos.

Para obtener más información sobre este método, consulta la referencia de la API ServingConfig.patch.

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'

Añadir controles a las configuraciones de publicación de forma integrada

Para añadir un control a una configuración de servicio, usa ServingConfig.addControl. El control se añade en la última posición de la lista de controles a la que pertenece. Por ejemplo, se aplica un control facetSpec en la última posición de servingConfig.facetSpecIds.

Para obtener más información sobre este método, consulta la referencia de la API ServingConfig.addControl.

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'

Eliminar controles de las configuraciones de publicación de forma directa

Para quitar un control de una configuración de servicio, usa ServingConfig.removeControl.

Para obtener más información sobre este método, consulta la referencia de la API ServingConfig.removeControl.

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'

Ver configuraciones de publicación

Puedes ver las configuraciones de servicio mediante la consola de búsqueda de comercio o la API.

Ver las configuraciones de publicación en la consola

Puedes ver todas tus configuraciones de publicación en la página Configuraciones de publicación.

Ver configuraciones de publicación insertadas

Para ver una sola configuración de servicio insertada, usa ServingConfig.get.

Para obtener más información sobre este método, consulta la referencia de la API ServingConfig.get.

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'

Para mostrar todas las configuraciones de servicio insertadas, usa ServingConfig.list.

También puedes usar el parámetro pageSize para definir el número máximo de resultados que se devolverán. Si hay más resultados disponibles, la respuesta list incluye un token de página. Puedes transferir un token de página en el parámetro pageToken de una solicitud list para obtener la siguiente página de resultados.

Para obtener más información sobre este método, consulta la referencia de la API ServingConfig.list.

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'

Eliminar una configuración de publicación

Puedes eliminar configuraciones de publicación mediante la consola de búsqueda de comercio o la API.

Eliminar configuraciones de servicio en la consola

Para eliminar una configuración de publicación en la consola, sigue estos pasos:

Ve a la página Serving Configs (Configuraciones de servicio) de la consola de Search for Commerce.

Ve a la página Configuraciones de servicio.
Haz clic en la configuración de publicación que quieras eliminar para abrir su página de detalles.
En la barra de botones de la parte superior de la página, haz clic en Eliminar.
Si la configuración de publicación se considera activa, debe volver a escribir su ID y hacer clic en Confirmar para completar la eliminación.

Eliminar una configuración de servicio insertada

Para eliminar una configuración de publicación concreta, usa ServingConfig.delete.

Para obtener más información sobre este método, consulta la referencia de la API ServingConfig.delete.

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'

Consultar estadísticas de configuraciones de publicación

Puedes ver los detalles de cada configuración de servicio en la página Configuraciones de servicio. Para ver las estadísticas de cualquier configuración de la tabla, haga clic en Ver analíticas.

Porcentaje de clics: muestra los clics por búsqueda de la configuración de servicio. Tasa de conversión: indica las compras por búsqueda de la configuración.