User Deletion API – Übersicht

Dieses Dokument bietet einen allgemeinen Überblick über die Google Analytics User Deletion API.

Einführung

Mit der Google Analytics User Deletion API können Nutzer Daten löschen, die mit einer bestimmten Nutzerkennung verknüpft sind. Dieses Tool ist eines von mehreren verfügbaren Tools zum Schutz Ihrer Daten.

Übersicht

Mit der User Deletion API kann ein Google Analytics-Kunde Daten einer bestimmten Nutzerkennung 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 anfordern

Verwenden Sie die Methode upsert, um das Löschen von Daten für einen bestimmten Nutzer anzufordern. Für die Upsert-Methode ist eine Ressource zum Löschen von Nutzern der einzige Parameter. Eine Anfrage zum Löschen von Daten kann entweder auf eine Google Analytics-Web-Property (durch das Feld webPropertyId) oder auf eine GA4-Property(durch das Feld propertyId angegeben) angewendet werden. Ein Nutzer, dessen Daten gelöscht werden sollen, kann durch Festlegen einer der IDs im Feld id.userId angegeben werden. Der Typ der ID 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-Instanzinstanz-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.

Daten löschen

Die Methode upsert gibt eine Ressource zum Löschen von Nutzern mit dem Feld deleteRequestTime zurück. Das Feld deleteRequestTime gibt den Zeitpunkt an, zu dem die Löschanfrage von Google Analytics empfangen wurde.

Der OAuth 2.0-Bereich https://www.googleapis.com/auth/analytics.user.delete ist zum Aufrufen der Methode upsert erforderlich.