Administra los controles de publicación

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

Para obtener información general sobre los controles de publicación, además de instrucciones sobre cómo crearlos consulta Acerca de los controles de publicación y Crea controles de entrega.

Cómo ver y editar controles de publicación

Puedes ver los controles de entrega de Vertex AI Search for Retail desde 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 para 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 página Configuraciones de entrega. Haz clic en una configuración de entrega para ver la página Detalles, en la que se enumeran todos 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 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 tus cambios se aplicaron en En la página Evaluar de la consola.

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

También puedes usar el parámetro pageSize para establecer una cantidad máxima de para mostrar resultados. 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 entrega, usa Controls.patch e incluir una instancia de Control en el cuerpo de la solicitud. Especifica el campos para actualizar con el parámetro updateMask o dejarla 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 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 de forma intercalada los controles de los parámetros de configuración de entrega

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 los parámetros de configuración de entrega.

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

Para borrar los controles de entrega de forma intercalada, 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 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 la entrega editar el archivo exportado y, luego, importarlo para modificarlo o agregarlo controles de entrega.

Puedes importar y exportar a través de la consola de Search for Retail. 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 publicación, haz clic en Controles de exportación.

  3. En la ventana Exportar controles de entrega, selecciona el bucket de Cloud Storage. a la cual 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 Importar, exportar y borrar actividades masivas en la ventana Exportar actividad. Abre la ventana Export activity haciendo clic en Show en la ventana del mensaje o siguiendo las instrucciones que aparecen en Ver el estado de un una operación de integración específica.

Importa controles de entrega

Para agregar controles de publicación o modificar los existentes de forma masiva, puedes hacer que tus 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 entrega si contiene ambos controles de entrega de búsquedas y recomendaciones.

  • Cuando importas controles de entrega, todos los del archivo se convierten asociada con la configuración de entrega 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 entrega, haz lo siguiente:

  1. Edita y revisa un archivo de control de publicaciones exportado y colócalo 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 los controles de publicación de la búsqueda. los 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 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 la nueva y modificada controles de seguridad.

  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. Abre la sección Activity estado haciendo clic en Mostrar en la ventana del mensaje o siguiendo las instrucciones en Consulta el estado de una operación de integración específica.