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 projet Google Cloud, puis activer automatiquement l'API Google Analytics Admin.

Activer 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 :

REST

  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 :

REST

  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 remplacer https://www.googleapis.com/auth/analytics.user.deletion par https://www.googleapis.com/auth/analytics.edit dans tous les commandes de requête de code ou de jeton d'accès qui utilisent le premier.

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 mis à jour 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.