Method: projects.locations.collections.dataStores.userEvents.purge

Borra de forma permanente todos los eventos de usuario especificados por el filtro proporcionado. Según la cantidad de eventos especificados por el filtro, esta operación podría tardar horas o días en completarse. Para probar un filtro, primero usa el comando list.

Solicitud HTTP

POST https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*/collections/*/dataStores/*}/userEvents:purge

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso del catálogo en el que se crean los eventos. El formato es projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "filter": string,
  "force": boolean
}
Campos
filter

string

Obligatorio. Es la cadena de filtro para especificar los eventos que se borrarán con un límite de longitud de 5,000 caracteres. Estos son los campos aptos para filtrar:

  • eventType: Cadena UserEvent.event_type entre comillas dobles.
  • eventTime: En formato ISO 8601 "zulu".
  • userPseudoId: Cadena entre comillas dobles. Si especificas esto, se borrarán todos los eventos asociados con un visitante.
  • userId: Cadena entre comillas dobles. Si especificas esto, se borrarán todos los eventos asociados con un usuario.

Nota: Esta API solo admite la eliminación definitiva de un rango máximo de 30 días.

Ejemplos:

  • Borrar todos los eventos en un período: eventTime > "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z"
  • Borrar un eventType específico en un período: eventTime > "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z" eventType = "search"
  • Borrar todos los eventos de un visitante específico en un período: eventTime > "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z" userPseudoId = "visitor1024"
  • Borrar los eventos de los últimos 30 días dentro de un DataStore: *

Se supone que los campos de filtrado tienen un AND implícito.
force

boolean

Actualmente, no se admite el campo force. Las solicitudes de eliminación definitiva de eventos de usuario borrarán de forma permanente todos los eventos que se puedan borrar. Una vez que se complete el desarrollo, si force se establece en falso, el método mostrará el recuento de eliminación definitiva previsto sin borrar los eventos de usuario. Este campo se establecerá de forma predeterminada en falso si no se incluye en la solicitud.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • discoveryengine.userEvents.purge

Para obtener más información, consulta la documentación de IAM.