Zur Google Analytics Admin API für das Löschen von Nutzern migrieren

Die Legacy-Google Analytics User Deletion API (Version 3) wurde zusammen mit Universal Analytics eingestellt. Die Google Analytics Admin API (Version 1alpha) bietet die Ersatzmethode SubmitUserDeletion , mit der Sie das Löschen von Daten für Nutzer in Google Analytics-Properties anfordern können.

Muss ich migrieren?

Wenn Ihr Code weiterhin die Methode upsert der Legacy-User Deletion API (Version 3) aufruft, müssen Sie zur Google Analytics Admin API migrieren, um Nutzerdaten für Ihre Google Analytics-Properties zu löschen.

Migrationsschritte

Führen Sie die folgenden Schritte aus, um die neue Methode SubmitUserDeletion zu verwenden.

Google Analytics Admin API aktivieren

Klicken Sie auf die Schaltfläche Google Analytics Admin API aktivieren , um ein neues Google Cloud-Projekt auszuwählen oder zu erstellen und die Google Analytics Admin API automatisch zu aktivieren.

Google Analytics Admin API aktivieren

Aufrufe der Legacy-User Deletion API suchen und ersetzen

Ersetzen Sie alle Aufrufe der Legacy-upsert Methode der Legacy- User Deletion API durch Aufrufe der neuen SubmitUserDeletion Methode der Google Analytics Admin API.

Beispiel für eine upsert-Anfrage an die Legacy-User Deletion API:

REST

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

Beispiel für eine entsprechende SubmitUserDeletion-Anfrage der Google Analytics Admin API:

REST

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

Angeforderte OAuth-Bereiche aktualisieren

Die neue Methode SubmitUserDeletion der Google Analytics Admin API verwendet den Bereich https://www.googleapis.com/auth/analytics.edit.

Das unterscheidet sich von der Legacy-User Deletion API, die den Bereich https://www.googleapis.com/auth/analytics.user.deletion verwendet hat.

Sie sollten alle Code- oder Zugriffstoken-Anforderungsbefehle, die https://www.googleapis.com/auth/analytics.user.deletion verwenden, so aktualisieren, dass stattdessen https://www.googleapis.com/auth/analytics.edit angefordert wird.

Wenn Sie eine Clientbibliothek verwenden, sollten die erforderlichen Bereiche automatisch angefordert werden.

Legacy-API deaktivieren

Nachdem Sie Ihren Code aktualisiert haben, um die Methode SubmitUserDeletion zu verwenden, können Sie die Legacy-API in Ihrem Google Cloud-Projekt deaktivieren.

Öffnen Sie den folgenden Link um den Legacy-Universal Analytics API-Endpunkt in der Google Cloud Console zu öffnen. Wählen Sie Ihr Cloud-Projekt aus und klicken Sie auf die Schaltfläche API deaktivieren.