Administrar los controles de entrega

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

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

Ver y editar los controles de publicación

Puedes ver los controles de entrega de Vertex AI Search para la venta minorista mediante la consola y la API.

Consulta y edita los controles de entrega en la consola

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

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 la página Detalles, que enumera todos los controles de entrega para esa configuración. Haz clic en el ícono Control de edición de un control para cambiar su configuración en el panel de Control de edición. Haz clic en el ícono Quitar control para desvincular el control de la configuración de entrega (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.

Ver los controles de entrega intercalados

Para ver un solo control de entrega 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 entrega intercalados, usa Controls.list.

De manera 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.

Si deseas 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 los campos en un control de entrega, 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 configurar 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 entrega, 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 la configuración de entrega.

Quita los controles de los parámetros de configuración de entrega intercalados

Para quitar un control de una configuración de entrega, 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 la configuración de entrega.

Borra un control de entrega

Puedes borrar un control de entrega desde la consola o de forma intercalada con el método Controls.delete.

Borra un control de entrega en la consola

Borra un control de entrega para quitarlo de todos los parámetros de configuración de entrega que lo usen.

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 entrega 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'

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 entrega a un archivo en un bucket de Cloud Storage.

Existen dos motivos por los que podrías querer importar y exportar los controles de entrega:

• Mover los controles de entrega de un proyecto a otro

• Realizar una edición masiva en todos o algunos controles de entrega Exporta los controles de entrega, edita el archivo exportado y, luego, importa el archivo para cambiar o agregar los controles de entrega.

Puedes importar y exportar a través de la consola de Search for Retail. Cuando exportas los controles de entrega, se exportan todos los controles de entrega del proyecto.

Para exportar los controles de entrega, 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 publicación, haz clic en Exportar controles.

3. En la ventana Exportar controles de entrega, 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 en el siguiente formato:

   projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson
   

5. Una vez que se complete la operación de exportación, puedes ver el estado de la operación en la lista Actividades de importación, exportación y eliminación masivas, en la ventana Exportar actividad. Para abrir la ventana Export activity, haz clic en Mostrar en la ventana del mensaje o sigue las instrucciones que se indican en Consulta el estado de una operación de integración específica.

Importa los 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 entrega 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 un proyecto diferente.

Información que debes saber sobre la importación de controles de entrega:

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

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

Para importar controles de entrega, haz lo siguiente:

1. Edita y revisa un archivo de control de entrega exportado y coloca el archivo en un bucket de Cloud Storage. (Para exportar los controles de entrega, consulta la tarea anterior Exporta controles de entrega).

   Asegúrate de que el archivo contenga solo controles de entrega de búsqueda o solo controles de entrega 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 Importar controles de entrega, haz lo siguiente:

   1. Explora y selecciona el bucket de Cloud Storage y el archivo NDJSON que contienen 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 importación. Los controles que se crearán se mostrarán en la pestaña Nuevo y los que se modificarán se mostrarán en la pestaña Modificados.

5. Haz clic en Importar.

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

6. Cuando se complete la operación de importación, podrás ver su estado 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 del mensaje o sigue las instrucciones que se indican en Consulta el estado de una operación de integración específica.