Migrer depuis l'API User Deletion de Google Analytics

L'ancienne API User Deletion de Google Analytics va disparaître. L'API Google Analytics Admin fournit une méthode de remplacement SubmitUserDeletion pour demander la suppression des données d'un utilisateur donné.

Dois-je migrer ?

Si votre code appelle la méthode upsert de l'ancienne API User Deletion, vous devez le migrer pour continuer à utiliser la fonctionnalité de suppression d'utilisateur.

Étapes 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 pour sélectionner ou créer un projet Google Cloud et 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 méthode SubmitUserDeletion de l'API Google Analytics Admin.

Exemple de requête upsert envoyé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 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 mettre à jour toutes les commandes de code ou de demande 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 niveaux d'accès 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 la console Google Cloud. Sélectionnez votre projet Cloud, puis cliquez sur le bouton Désactiver l'API.