Skip to content

Supprimer les utilisateurs

post

/users/delete

Utilisez cet endpoint pour supprimer un profil utilisateur en spécifiant un identifiant utilisateur connu.

Jusqu’à 50 external_ids, user_aliases, braze_ids, email_addresses, ou phone_numbers peuvent être inclus dans une seule demande. Une seule des adresses external_ids, user_aliases, braze_ids, email_addresses, ou phone_numbers peut être incluse dans une seule demande.

Si vous avez un cas d’utilisation qui ne peut pas être résolu avec la suppression en bloc d’utilisateurs via l’API, contactez l’ équipe d’assistance de Braze pour obtenir de l’aide.

Conditions préalables

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation users.delete.

Limite de débit

We apply a shared rate limit of 20,000 requests per minute to this endpoint. This rate limit is shared with the /users/alias/new, /users/identify, /users/merge, and /users/alias/update endpoints, as documented in API rate limits.

Corps de la demande

Paramètres de demande

Paramètre Requis Type de données Description
external_ids Facultatif Tableau de chaînes de caractères Identifiants externes à supprimer.
user_aliases Facultatif Tableau d’objets Alias utilisateur Alias utilisateur à supprimer.
braze_ids Facultatif Tableau de chaînes de caractères Suppression des identifiants des utilisateurs de Braze.
email_addresses Facultatif Tableau de chaînes de caractères Les e-mails des utilisateurs à supprimer. Pour plus d’informations, reportez-vous à la section Suppression d’utilisateurs par e-mail.
phone_numbers Facultatif Tableau de chaînes de caractères Numéros de téléphone de l’utilisateur à supprimer.

Suppression des utilisateurs par e-mail

Si un email est spécifié comme identifiant, une valeur prioritization supplémentaire est requise dans l’identifiant. Le prioritization est un tableau ordonné et doit spécifier quel utilisateur supprimer si plusieurs utilisateurs sont trouvés. Cela signifie que la suppression des utilisateurs ne se produira pas si plus d’un utilisateur correspond à une priorisation.

Les valeurs autorisées pour le tableau sont les suivantes : identified, unidentified, most_recently_updated. most_recently_updated signifie que la priorité est accordée à l’utilisateur ayant effectué la dernière mise à jour.

Une seule des options suivantes peut exister à la fois dans le tableau de priorisation :

  • identified Il s’agit de donner la priorité à un utilisateur ayant une external_id
  • unidentified Il s’agit de donner la priorité à un utilisateur qui n’a pas de external_id

Exemple de demande

Réponse

CETTE PAGE A-T-ELLE ÉTÉ UTILE?
New Stuff!