Administra los controles de publicación

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

Si necesitas información general sobre los controles de publicación y las instrucciones para crearlos, consulta Acerca de los controles de publicación y Cómo crear controles de publicación.

Consulta y edita los controles de entrega

Puedes ver los controles de entrega de Vertex AI Search for Retail desde la consola y la API.

Visualiza y edita los controles de entrega en la consola

El Pestaña Controles de entrega de la página Controles, en una lista con todos tus controles de publicación los parámetros de configuración de entrega. Haz clic en el ícono editEl ícono Editar control para cambiar un control sus parámetros y los parámetros de configuración de entrega asociados en el control de edición panel. Haz clic en el ícono deleteBorrar 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 editEditar control de un control para cambiar su configuración en el panel Editar control. Haz clic en el ícono do_not_disturb_onQuitar el control para que puedas hacer lo siguiente: 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 tus cambios se aplicaron en 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 de forma intercalada, usa Controls.list.

De forma 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 list. para recuperar la siguiente página de resultados.

Para enumerar solo los controles asociados a 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 publicación, usa Controls.patch y, luego, incluye 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 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 los parámetros de configuración de entrega.

Quita los controles de las configuraciones de entrega intercaladas

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 las configuraciones de publicación.

Borra un control de entrega

Puedes borrar un control de entrega desde la consola o de forma intercalada con el 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 deleteBorrar.

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 se recomienda importar y exportar controles de entrega:

• Para mover los controles de entrega 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 entrega, exportas todos los controles de entrega en un proyecto final.

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 entrega, haz clic en Exportar controles.

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 finalizada la operación de exportación, puedes ver el estado de la operación en la lista Importar, exportar y borrar actividades de forma masiva en la sección Exportar Activity. 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 proyecto original o en una diferente en un proyecto final.

Información sobre la importación de controles de entrega:

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

• Cuando importas controles de publicación, todos los controles de publicación del archivo se asocian con la configuración de publicación que especificas en la importación. Si un el control de entrega ya está asociado con otra configuración de entrega en 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 que contiene 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 publicación, haz clic en Importar controles.

4. En la ventana Importar controles de entrega (Import Serving Controls), haz lo siguiente:

   1. Navega y selecciona bucket de Cloud Storage y el archivo NDJSON que contiene los controles que que quieres importar.

   2. Selecciona la configuración de entrega que quieres asociar a la entrega importada controles de acceso.

   3. Revisa el plan de vista previa de importación. Los controles que se crearán son en la pestaña Nuevo y los controles que se se muestran en la pestaña Modificados.

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 finalizada la operación de importación, puedes ver el estado de la operación en Pestaña Controles de la ventana Estado de 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.