Migrer vers l'API Google Analytics Admin pour la suppression d'utilisateurs

L'ancienne API User Deletion de Google Analytics (v3) a été abandonnée en même temps qu'Universal Analytics. L'API Google Analytics Admin (v1alpha) fournit une méthode de remplacement SubmitUserDeletion pour demander la suppression des données des utilisateurs dans les propriétés Google Analytics.

Dois-je migrer ?

Si votre code appelle toujours la méthode upsert de l'ancienne API User Deletion (v3), vous devez migrer vers l'API Google Analytics Admin pour supprimer des utilisateurs de vos propriétés Google Analytics.

Procédure de migration

Suivez ces étapes pour commencer à utiliser la nouvelle méthode SubmitUserDeletion.

Activer l'API Google Analytics Admin

Cliquez sur le bouton Activer l'API Google Analytics Admin ci-dessous pour sélectionner ou créer un nouveau projet, puis activer automatiquement l'API Google Analytics Admin.

Rechercher et remplacer les appels à l'ancienne API User Deletion

Remplacez tous les appels à l'ancienne méthode upsert de l'ancienne API User Deletion par des appels à la nouvelle SubmitUserDeletion méthode de l'API Google Analytics Admin.

Exemple de requête upsert adressée à l'ancienne API User Deletion :

  POST https://analytics.googleapis.com/analytics/v3/userDeletion/userDeletionRequests:upsert
  {
    "propertyId": "1234567",
    "id": {
      "type": "USER_ID",
      "userId": "user123"
    }
  }

Exemple de requête SubmitUserDeletion équivalente de l'API Google Analytics Admin :

  POST https://analyticsadmin.googleapis.com/v1alpha/properties/1234567:submitUserDeletion
  {
    "userId": "user123"
  }

Mettre à jour les champs d'application OAuth demandés

La nouvelle méthode SubmitUserDeletion de l'API Google Analytics Admin utilise le champ d'application https://www.googleapis.com/auth/analytics.edit.

Cela diffère de l'ancienne API User Deletion, qui utilisait le champ d'application https://www.googleapis.com/auth/analytics.user.deletion.

Vous devez modifier toutes les commandes de code ou de requête de jeton d'accès qui utilisent https://www.googleapis.com/auth/analytics.user.deletion pour demander https://www.googleapis.com/auth/analytics.edit à la place.

Si vous utilisez une bibliothèque cliente, elle doit demander automatiquement les champs d'application nécessaires.

Désactiver l'ancienne API

Une fois que vous avez modifié votre code pour utiliser la méthode SubmitUserDeletion, vous pouvez désactiver l'ancienne API dans votre projet Google Cloud.

Ouvrez le lien suivant pour ouvrir l'ancien point de terminaison de l'API Universal Analytics dans votre console Google Cloud. Sélectionnez votre projet Cloud, puis cliquez sur le bouton Désactiver l'API.