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 notwendig, diese Spalten hinzuzufügen, zu entfernen oder umzubenennen. Die Richtlinie zur Einstellung von Daten soll transparenter machen, wie diese Änderungen wirksam werden.

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

Umfang dieser Richtlinien

Diese Richtlinie deckt die Dimensionen und Messwerte ab, die von öffentlichen APIs zur Verfügung gestellt werden. 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:

Datenlöschung

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 status in der Spalte auf DEPRECATED gesetzt.
  • Die Spalte(n) funktionieren mindestens 6 Monate lang bei Berichtsabfragen.
  • Nach 6 Monaten werden die Spalten aus der Metadata API entfernt und die Abfrage der Spalten in der Reporting API führt zum Fehler 400 Bad Request.

Umbenennung von Daten

Beim Umbenennen von Spalten gilt Folgendes:

  • 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 mindestens 6 Monate lang bei Berichtsabfragen.
  • Nach 6 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.

Attribut entfernen

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

  • Das Änderungsprotokoll der Metadata API wird mit Details zu den entfernten Attributen aktualisiert.
  • Die Attribute sind in der Metadata API noch mindestens sechs Monate lang 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: