Administra los controles de publicación

En esta página, se describe cómo ver, editar, borrar, exportar e importar controles de entrega.

Si deseas obtener información general sobre los controles de publicación y las instrucciones para crearlos, consulta Acerca de los controles de publicación y Cómo crear controles de publicación.

Cómo ver y editar los controles de publicación

Puedes ver los controles de publicación de Vertex AI Search for Retail con la consola y la API.

Consulta y edita los controles de publicación en la consola

En la pestaña Controles de entrega de la página Controles, se enumeran todos los controles de entrega y sus configuraciones de entrega asociadas. Haz clic en el ícono Editar control de un control para cambiar su configuración y las configuraciones de entrega asociadas en el panel Editar control. Haz clic en el ícono Borrar control de un control para borrarlo, lo que también lo quitará de todas las configuraciones de publicación.

También puedes ver y editar los controles de una configuración de entrega específica en la página Configuraciones de entrega. Haz clic en una configuración de entrega para ver su página Detalles, en la que se enumeran todos los controles de entrega de esa configuración. Haz clic en el ícono Editar control de un control para cambiar su configuración en el panel Editar control. Haz clic en el ícono Quitar control para disociar el control de la configuración de publicación (esto no borra el control).

Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Cómo ver los controles de publicación intercalados

Para ver un solo control de publicación intercalado, usa Control.get.

Para obtener más información sobre este método, consulta la referencia de la API de Control.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/controls/CONTROL_ID'

Para enumerar varios controles de publicación intercalados, usa Controls.list.

De forma opcional, puedes usar el parámetro pageSize para establecer una cantidad máxima de resultados que se mostrarán. Si hay más resultados disponibles, la respuesta list incluye un token de página. Puedes pasar un token de página en el parámetro pageToken de una solicitud list para recuperar la siguiente página de resultados.

Para enumerar solo los controles asociados con una configuración de entrega determinada, usa el parámetro de consulta filter para especificar el ID de la configuración de entrega.

Para obtener más información sobre este método, consulta la referencia de la API de Control.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/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Controles de entrega de parches intercalados

Para actualizar campos en un control de publicación, usa Controls.patch y, luego, incluye una instancia de Control en el cuerpo de la solicitud. Especifica los campos que se actualizarán con el parámetro updateMask o déjalo sin definir para actualizar todos los campos compatibles.

Para obtener más información sobre este método, consulta la referencia de la API de Controls.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/controls/CONTROL_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/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Agrega controles a los parámetros de configuración de entrega intercalados

Para agregar un control a una configuración de publicación, usa ServingConfig.addControl.

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

Para ver un ejemplo de este método, consulta Administra las configuraciones de publicación.

Quita los controles de las configuraciones de entrega intercaladas

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

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

Para ver un ejemplo de este método, consulta Administra las configuraciones de publicación.

Borra un control de entrega

Puedes borrar un control de publicación de la consola o intercalarlo con el método Controls.delete.

Borra un control de publicación en la consola

Borra un control de publicación para quitarlo de todas las configuraciones de publicación que lo usan.

1. Ve a la página Controles en la consola de Search for Retail.
   
   Ir a la página Controles

2. En la fila de la tabla del control que planeas quitar, haz clic en Borrar.

3. En la ventana de confirmación, haz clic en Borrar para completar la eliminación.

Borra un control de entrega intercalado

Para borrar los controles de publicación intercalados, usa Controls.delete.

Para obtener más información sobre este método, consulta la referencia de la API de Controls.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/controls/SERVING_CONTROL_ID'

Cómo exportar controles de entrega

Vista previa

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Puedes exportar tus controles de publicación a un archivo en un bucket de Cloud Storage.

Existen dos motivos por los que podrías querer exportar e importar controles de publicación:

• Para mover controles de publicación de un proyecto a otro.

• Para realizar una edición masiva en todos o algunos controles de publicación. Exporta los controles de entrega, edita el archivo exportado y, luego, impórtalo para cambiar o agregar controles de entrega.

Puedes exportar e importar datos a través de la consola de Búsqueda para venta minorista. Cuando exportas controles de publicación, exportas todos los controles de publicación del proyecto.

Para exportar controles de publicación, haz lo siguiente:

1. Ve a la página Controles en la consola de Search for Retail.
   
   Ir a la página Controles

2. En la pestaña Controles de entrega, haz clic en Exportar controles.

3. En la ventana Export Serving Controls, selecciona el bucket de Cloud Storage al que deseas exportar el archivo de controles.

4. Haz clic en Exportar.

   Los controles exportados se guardan en un archivo NDJSON en el bucket seleccionado con un nombre con el siguiente formato:

   projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

5. Una vez que se complete la operación de exportación, podrás ver el estado de la operación en la lista Importar, exportar y borrar actividades masivas en la ventana Exportar actividad. Para abrir la ventana Export activity, haz clic en Show en la ventana de mensajes o sigue las instrucciones que se indican en Ver el estado de una operación de integración específica.

Cómo importar controles de entrega

Vista previa

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para agregar controles de publicación o modificar los existentes de forma masiva, puedes realizar los cambios en un archivo de controles exportado. Luego, puedes importarlos al proyecto original o a uno diferente.

Información que debes saber para importar controles de publicación:

• No puedes importar un archivo de control de publicación si contiene controles de publicación de búsqueda y recomendaciones.

• Cuando importas controles de publicación, todos los controles de publicación del archivo se asocian con la configuración de publicación que especificas en la importación. Si un control de publicación ya está asociado con otra configuración de publicación en el proyecto, esa asociación también se mantiene.

Para importar controles de publicación, haz lo siguiente:

1. Edita y revisa un archivo de control de publicación exportado y colócalo en un bucket de Cloud Storage. (Para exportar controles de publicación, consulta la tarea anterior Cómo exportar controles de publicación).

   Asegúrate de que el archivo contenga solo controles de publicación de búsqueda o solo controles de publicación de recomendaciones. No puedes importar un archivo que contenga ambos tipos.

2. Ve a la página Controles en la consola de Search for Retail.
   
   Ir a la página Controles

3. En la pestaña Controles de entrega, haz clic en Importar controles.

4. En la ventana Import Serving Controls, haz lo siguiente:

   1. Explora y selecciona el bucket de Cloud Storage y el archivo NDJSON que contiene los controles que deseas importar.

   2. Selecciona la configuración de entrega con la que deseas asociar los controles de entrega importados.

   3. Revisa el plan de vista previa de la importación. Los controles que se crearán se muestran en la pestaña New y los que se modificarán se muestran en la pestaña Modified.

5. Haga clic en Import.

   Se inicia una operación de larga duración para importar los controles nuevos y modificados.

6. Una vez que se complete la operación de importación, podrás ver el estado de la operación en la pestaña Controles de la ventana Estado de la actividad. Para abrir la ventana Estado de la actividad, haz clic en Mostrar en la ventana de mensajes o sigue las instrucciones que se indican en Consulta el estado de una operación de integración específica.