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:
- Das Änderungsprotokoll der entsprechenden API wird mit Details zu den neuen Spalten aktualisiert.
- Die Spalten sind dann in der Metadata API verfügbar.
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
aufDEPRECATED
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 aufDEPRECATED
und das AttributreplacedBy
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:
- Das Änderungslog der Metadata API wird mit Details zum Gruppennamen und zu Änderungen der Reihenfolge aktualisiert.