Administra los controles de entrega

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

Para 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 Crea controles de entrega.

Visualiza y edita los controles de entrega

Puedes ver los controles de entrega de AI Commerce Search con la consola y la API.

Visualiza 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 configuraciones de entrega asociadas. 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 de un control para borrarlo, lo 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 Configuración de entregas página. Haz clic en una configuración de entrega para ver su página de Detalles, en la que se enumeran todos los controles de entrega para 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 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.

Visualiza 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 Control.get referencia de la 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/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.

Para enumerar solo los controles asociados con una determinada configuración de entrega, 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 Control.list referencia de la 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/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Aplica parches a los controles de entrega intercalados

Para actualizar los campos en un control de entrega, usa Controls.patch e 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 Controls.patch referencia de la 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/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 un parámetro de configuración de entrega, usa ServingConfig.addControl.

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

Para ver un ejemplo de este método, consulta Administra los parámetros de configuración de entrega.

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

Para quitar un control de un parámetro de configuración de entrega, usa ServingConfig.removeControl.

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

Para ver un ejemplo de este método, consulta Administra los parámetros de configuración de entrega.

Borra un control de entrega

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

Borra un control de entrega en la consola

Borra un control de entrega para quitar ese control de todos los parámetros de configuración de entrega que lo usan.

1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.
   
   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 controles de entrega intercalados, usa Controls.delete.

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

Exporta controles de entrega

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden 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 es posible que desees exportar e importar controles de entrega:

• Para trasladar controles de entrega de un proyecto a otro

• Para 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 controles de entrega.

Puedes importar y exportar a través de la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente. Cuando exportas controles de entrega, exportas todos los controles de entrega del proyecto.

Para exportar controles de entrega, haz lo siguiente:

1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.
   
   Ir a la página Controles

2. En la pestaña Controles de entrega, 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 completa 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 Actividad de exportación. Para abrir la ventana Actividad de exportación, haz clic en Mostrar en la ventana de mensajes o sigue las instrucciones en Consulta el estado de una operación de integración específica.

Importa controles de entrega

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden 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 uno diferente.

Aspectos 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 especificas en la importación. Si un control de entrega ya está asociado con otro parámetro de configuración de entrega en el proyecto, también se mantiene esa asociación.

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 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 AI Commerce Search en Gemini Enterprise para la experiencia del cliente.
   
   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. Busca 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 importación. Los controles que se crearán se muestran en la pestaña Nuevo , y los controles que se modificarán se muestran en la pestaña Modificado.

5. Haz clic en Importar.

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

6. Una vez que se completa la operación de importación, puedes 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 en Consulta el estado de una operación de integración específica.