User Deletion API – Übersicht

In diesem Dokument erhalten Sie einen allgemeinen Überblick über die Google Analytics User Deletion API.

Einführung

Mit der Google Analytics User Deletion API können Kunden das Löschen von Daten verarbeiten, die mit einer bestimmten User-ID verknüpft sind. Dieses Tool ist eines von mehreren verfügbaren Tools zum Schutz Ihrer Daten.

Überblick

Mit der User Deletion API können Google Analytics-Kunden Daten für eine bestimmte User-ID aus einem Projekt oder einer Web-Property löschen. Anfragen zum Löschen von Nutzern können über Firebase-Projekte oder Google Analytics-Properties gestellt werden.

Löschen von Daten beantragen

Verwenden Sie die upsert-Methode, um das Löschen von Daten für einen bestimmten Nutzer anzufordern. Für die Upsert-Methode wird eine Ressource vom Typ „Löschanfrage für Nutzer“ als einzigen Parameter verwendet. Eine Anfrage zum Löschen von Daten kann entweder auf eine Google Analytics-Web-Property (angegeben durch das Feld webPropertyId) oder auf eine GA4-Property(angegeben durch das Feld propertyId) angewendet werden. Wenn Sie einen Nutzer angeben möchten, dessen Daten gelöscht werden sollen, legen Sie eine der IDs im Feld id.userId fest. Der Typ der Kennung muss im Feld id.type angegeben werden. Unterstützte Nutzer-ID-Typen:

  • CLIENT_ID: Google Analytics-Client-ID (wird nur unterstützt, wenn das Feld webPropertyId oder propertyId festgelegt ist).
  • USER_ID: Google Analytics-User-ID (wird nur unterstützt, wenn das Feld webPropertyId oder propertyId festgelegt ist)
  • APP_INSTANCE_ID: Firebase-Anwendungsinstanz-ID (nur unterstützt, wenn das Feld firebaseProjectId oder propertyId festgelegt ist).

Weitere Informationen zu den Funktionen User-ID und Client-ID finden Sie in der Analytics-Hilfe.

Datenlöschung

Die Methode upsert gibt eine Löschanfrageressource für Nutzer mit einem festgelegten Feld deletionRequestTime zurück. Im Feld deletionRequestTime wird der Zeitpunkt angegeben, zu dem die Löschanfrage in Google Analytics eingegangen ist.

Der OAuth 2.0-Bereich https://www.googleapis.com/auth/analytics.user.deletion ist erforderlich, um die Methode upsert aufzurufen.