Richtlinie zur Einstellung von Daten für Google Analytics APIs

In diesem Dokument wird die Richtlinie zur Datenverwerfung für die Core Reporting API und die Metadata API beschrieben.

Überblick

Dimensionen und Messwerte (Spalten) werden zur Abfrage der Google Analytics Reporting APIs verwendet. Gelegentlich ist es erforderlich, diese Spalten hinzuzufügen, zu entfernen oder umzubenennen. Die Richtlinie zur Einstellung von Daten soll die Transparenz hinsichtlich der Umsetzung dieser Änderungen erhöhen.

Alle Änderungen an Spalten werden über Änderungsprotokolle mitgeteilt und die Metadata API wird automatisch entsprechend aktualisiert.

Inhalt dieser Datenschutzerklärung

Diese Richtlinie deckt die von öffentlichen APIs bereitgestellten Dimensionen und Messwerte ab. Nicht enthalten sind die API-Anfrage (Abfrageparameter), die API-Antwort, die von der API zurückgegebenen Werte oder gültige Kombinationen aus Dimensionen und Messwerten.

Neue Daten

Wenn einer API neue Spalten hinzugefügt werden, gilt Folgendes:

Datenentfernung

Wenn Spalten aus einer API entfernt werden, gilt Folgendes:

  • Das Änderungsprotokoll der entsprechenden API wird mit Details zu den zu entfernenden Spalten aktualisiert.
  • In der Metadata API wird das Attribut in der Spalte status auf DEPRECATED gesetzt.
  • Die Spalte(n) funktioniert(en) noch mindestens 6 Monate lang in Berichtsabfragen.
  • Nach sechs Monaten werden die Spalten aus der Metadata API entfernt. Die Abfrage der Spalten in der Reporting API führt zu einem 400 Bad Request-Fehler.

Umbenennung von Daten

Wenn Spalten umbenannt werden:

  • Das Änderungsprotokoll der entsprechenden API wird mit Details zu den ursprünglichen Spalten und den Ersatzspalten aktualisiert.
  • In der Metadata API wird das Attribut status der ursprünglichen Spalte auf DEPRECATED und das Attribut replacedBy auf die ID der Ersatzspalte festgelegt.
  • Die ursprünglichen Spalten funktionieren noch mindestens 6 Monate in Berichtsabfragen.
  • Nach sechs Monaten werden die ursprünglichen Spalten aus der Metadata API entfernt. Die Abfrage der Spalten in der Reporting API führt zum Fehler 400 Bad Request.

Attributentfernung

Wenn Attribute aus der Metadata API entfernt werden, gilt Folgendes:

  • Das Änderungsprotokoll der Metadata API wird mit Details zu den zu entfernenden Attributen aktualisiert.
  • Die Attribute sind noch mindestens 6 Monate in der Metadata API verfügbar.
  • Nach 6 Monaten werden die Attribute aus der Metadata API entfernt.

Gruppen

Manchmal ist es erforderlich, den Namen einer Gruppe oder die Reihenfolge der Spalten zu ändern. In diesem Fall geschieht Folgendes: