Gestionar controles de publicación

En esta página se describe cómo ver, editar, eliminar, exportar e importar controles de publicación.

Para obtener información general sobre los controles de publicación e instrucciones sobre cómo crearlos, consulta Acerca de los controles de publicación y Crear controles de publicación.

Ver y editar los controles de publicación

Puedes ver los controles de servicio de Vertex AI Search para el sector del comercio mediante la consola y la API.

Ver y editar los controles de publicación en la consola

En la pestaña Controles de publicación de la página Controles se muestran todos los controles de publicación y sus configuraciones de publicación asociadas. Haz clic en el icono editEditar control de un control para cambiar su configuración y las configuraciones de publicación asociadas en el panel Editar control. Haz clic en el icono deleteEliminar control de un control para eliminarlo, lo que también lo quitará de todas las configuraciones de publicación.

También puede ver y editar los controles de una configuración de servicio específica en la página Configuraciones de servicio. Haga clic en una configuración de publicación para ver su página Detalles, que muestra todos los controles de publicación de esa configuración. Haz clic en el icono editEditar control de un control para cambiar sus ajustes en el panel Editar control. Haz clic en el icono do_not_disturb_onQuitar control para desvincular el control de la configuración de servicio (esto no elimina el control).

Los controles recién creados o actualizados tardan unos minutos en estar listos para servir tráfico real. Puedes comprobar si los cambios se han aplicado en la página Evaluar de la consola.

Ver los controles de publicación de forma integrada

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

Para obtener más información sobre este método, consulta la referencia de la API 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 servicio en línea, usa Controls.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 mostrar solo los controles asociados a una configuración de publicación concreta, usa el parámetro de consulta filter para especificar el ID de la configuración de publicación.

Para obtener más información sobre este método, consulta la referencia de la API 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 publicación de parches insertados

Para actualizar los campos de un control de publicación, usa Controls.patch e incluye una instancia de Control 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 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'

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.

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

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

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

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

Eliminar un control de servicio

Puedes eliminar un control de publicación desde la consola o de forma insertada mediante el método Controls.delete.

Eliminar un control de publicación en la consola

Elimina un control de servicio para quitarlo de todas las configuraciones de servicio que lo usen.

1. Ve a la página Controles de la consola de búsqueda de comercio.
   
   Ve a la página Controles.

2. En la fila de la tabla del control que quieras quitar, haz clic en deleteEliminar.

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

Eliminar un control de publicación insertado

Para eliminar los controles de publicación de forma insertada, usa Controls.delete.

Para obtener más información sobre este método, consulta la referencia de la API 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 servicio

Puedes exportar tus controles de servicio a un archivo de un segmento de Cloud Storage.

Hay dos motivos por los que puede querer exportar e importar controles de publicación:

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

• Para editar en bloque todos o algunos controles de publicación, siga estos pasos: Exporta los controles de publicación, edita el archivo exportado y, a continuación, impórtalo para cambiar o añadir controles de publicación.

Puedes exportar e importar a través de la consola de búsqueda de comercio. Cuando exportas controles de publicación, se exportan todos los controles de publicación del proyecto.

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

1. Ve a la página Controles de la consola de búsqueda de comercio.
   
   Ve a la página Controles.

2. En la pestaña Controles de publicación, haga clic en Exportar controles.

3. En la ventana Export Serving Controls (Exportar controles de publicación), selecciona el segmento de Cloud Storage al que quieras exportar el archivo de controles.

4. Haz clic en Exportar.

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

   projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

5. Una vez que se haya completado la operación de exportación, podrás ver su estado en la lista Importar, exportar y eliminar actividades en bloque de la ventana Exportar actividad. Abre la ventana Exportar actividad haciendo clic en Mostrar en la ventana de mensajes o siguiendo las instrucciones de Consultar el estado de una operación de integración específica.

Importar controles de publicación

Para añadir controles de publicación o modificar los que ya tienes en bloque, puedes hacer los cambios en un archivo de controles exportado. A continuación, puedes importarlos al proyecto original o a otro.

Aspectos que debes tener en cuenta al 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 de recomendaciones.

• Cuando importa controles de publicación, todos los controles de publicación del archivo se asocian a la configuración de publicación que especifique durante la importación. Si un control de servicio ya está asociado a otra configuración de servicio del proyecto, esa asociación también se mantiene.

Para importar controles de servicio, haz lo siguiente:

1. Edita y revisa un archivo de control de publicación exportado y colócalo en un segmento de Cloud Storage. Para exportar los controles de publicación, consulta la tarea anterior Exportar controles de publicación.

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

2. Ve a la página Controles de la consola de búsqueda de comercio.
   
   Ve a la página Controles.

3. En la pestaña Controles de publicación, haga clic en Importar controles.

4. En la ventana Importar controles de publicación, haz lo siguiente:

   1. Busca y selecciona el segmento de Cloud Storage y el archivo NDJSON que contenga los controles que quieras importar.

   2. Seleccione la configuración de publicación a la que quiera asociar los controles de publicación 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 haya completado la operación de importación, podrás ver su estado en la pestaña Controles de la ventana Estado de la actividad. Abre la ventana Estado de la actividad haciendo clic en Mostrar en la ventana de mensajes o siguiendo las instrucciones de Ver el estado de una operación de integración específica.