Administra los controles de publicación

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 crearlos, consulta Acerca de los controles de entrega y Crea controles de entrega.

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

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

Cómo ver y editar 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 editEditar 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 deleteBorrar control para borrar un control, lo que también lo quitará 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 Configuración de entrega. 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 editEditar control de un control para cambiar su configuración en el panel Editar control. Haz clic en el ícono do_not_disturb_onQuitar control para disociar 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.

Cómo ver los controles de entrega 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 entrega intercalados, usa Controls.list.

De manera opcional, puedes usar el parámetro pageSize para establecer una cantidad máxima de resultados que se devolverá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 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 integrados

Para actualizar los 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 configurar para actualizar todos los campos admitidos.

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 de forma intercalada

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 la configuración de entrega.

Cómo quitar controles de las configuraciones de entrega de forma directa

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 publicación 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 commerce.
   
   Ir a la página Controles

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

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

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 controles de entrega:

• Mover los controles de publicación 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, impórtalo para cambiar o agregar controles de entrega.

Puedes importar y exportar a través de la consola de Search for commerce. Cuando exportas los controles de entrega, exportas 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 commerce.
   
   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 en 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 Actividades de importación, exportación y eliminación masivas de la ventana Actividad de exportación. Para abrir la ventana Export activity, haz clic en Show en la ventana de mensaje o sigue las instrucciones que se indican en Visualización del estado de una operación de integración específica.

Cómo importar controles de entrega

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 otro proyecto.

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

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

• 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 a otra configuración de entrega en el proyecto, también se mantiene esa asociación.

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 entrega, consulta la tarea anterior Exportar controles de entrega).

   Asegúrate de que el archivo contenga solo controles de publicación de la 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 commerce.
   
   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. Busca 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 la importación. Los controles que se crearán se muestran en la pestaña Nuevo, y los que se modificarán, 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 complete la operación de importación, podrás ver su estado en la pestaña Controles de la ventana Estado de actividad. Para abrir la ventana Estado de actividad, haz clic en Mostrar en la ventana de mensaje o sigue las instrucciones que se indican en Consulta el estado de una operación de integración específica.