Method: projects.locations.dataStores.userEvents.purge

Supprime définitivement tous les événements utilisateur spécifiés par le filtre fourni. Selon le nombre d'événements spécifiés par le filtre, cette opération peut prendre plusieurs heures, voire plusieurs jours. Pour tester un filtre, utilisez d'abord la commande list.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de ressource du catalogue sous lequel les événements sont créés. Il a le format suivant : projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "filter": string,
  "force": boolean
}
Champs
filter

string

Obligatoire. Chaîne de filtre permettant de spécifier les événements à supprimer,avec une limite de 5 000 caractères. Les champs éligibles pour le filtrage sont les suivants :

  • eventType : chaîne UserEvent.event_type entre guillemets doubles.
  • eventTime : au format ISO 8601 "zulu".
  • userPseudoId : chaîne entre guillemets doubles. Si vous spécifiez ce champ, tous les événements associés à un visiteur seront supprimés.
  • userId : chaîne entre guillemets doubles. Si vous spécifiez ce champ, tous les événements associés à un utilisateur seront supprimés.

Remarque : Cette API ne permet de supprimer définitivement que les événements d'une période maximale de 30 jours.

Exemples :

  • Supprimer tous les événements d'une période donnée : eventTime > "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z"
  • Supprimer un type d'événement spécifique dans une période donnée : eventTime > "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z" eventType = "search"
  • Supprimer tous les événements d'un visiteur spécifique dans une période donnée : eventTime > "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z" userPseudoId = "visitor1024"
  • Supprimer les événements des 30 derniers jours dans un DataStore : *

Les champs de filtrage sont supposés avoir un AND implicite.
force

boolean

Le champ force n'est actuellement pas compatible. Les requêtes de suppression définitive d'événements utilisateur suppriment définitivement tous les événements pouvant être supprimés. Une fois le développement terminé : si force est défini sur "false", la méthode renvoie le nombre de suppressions attendu sans supprimer d'événements utilisateur. Si ce champ n'est pas inclus dans la requête, la valeur par défaut est "false".

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • 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

Pour plus d'informations, consultez la page Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • discoveryengine.userEvents.purge

Pour en savoir plus, consultez la documentation IAM.