Von der Google Analytics User Deletion API migrieren

Die alte Google Analytics User Deletion API wird eingestellt. Die Google Analytics Admin API bietet eine Ersatzmethode SubmitUserDeletion, um das Löschen von Daten für einen bestimmten Nutzer zu beantragen.

Muss ich migrieren?

Wenn in Ihrem Code die Methode upsert der alten User Deletion API aufgerufen wird, müssen Sie Ihren Code migrieren, um die Funktion zum Löschen von Nutzern weiterhin verwenden zu können.

Migrationsschritte

So verwenden Sie die neue SubmitUserDeletion-Methode:

Google Analytics Admin API aktivieren

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

Google Analytics Admin API aktivieren

Aufrufe der alten User Deletion API suchen und ersetzen

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

Beispiel für eine upsert-Anfrage an die alte 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"
  }

Aktualisierung der angeforderten OAuth-Bereiche

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

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

Sie sollten alle Code- oder Zugriffstokenanforderungsbefehle, 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 SubmitUserDeletion-Methode zu verwenden, können Sie die Legacy-API in Ihrem Google Cloud-Projekt deaktivieren.

Öffnen Sie diesen Link, um den alten 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.