Richtlinie zur Einstellung von Daten für Google Analytics APIs

In diesem Dokument wird die Richtlinie zur Einstellung von Daten für die Core Reporting and Metadata APIs beschrieben.

Übersicht

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

Alle Spaltenänderungen werden über Änderungslogs kommuniziert. Die Metadata API wird automatisch entsprechend aktualisiert.

Was ist von dieser Richtlinie abgedeckt?

Diese Richtlinie deckt die Dimensionen und Messwerte ab, die von öffentlichen APIs bereitgestellt werden. Sie umfasst nicht 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 Spalten aktualisiert, die entfernt werden sollen.
  • In der Metadata API wird das Attribut status der Spalte auf DEPRECATED gesetzt.
  • Die Spalten funktionieren noch mindestens 6 Monate lang in Berichtsabfragen.
  • Nach 6 Monaten werden die Spalte(n) aus der Metadata API entfernt und bei der Abfrage von Spalten in der Reporting API wird der Fehler 400 Bad Request gemeldet.

Daten umbenennen

Wenn Spalten umbenannt werden, gilt Folgendes:

  • Das Änderungsprotokoll der entsprechenden API wird mit Details zu den ursprünglichen 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üngliche(n) Spalte(n) funktionieren noch mindestens 6 Monate lang in Berichtsabfragen.
  • Nach 6 Monaten werden die ursprünglichen Spalten aus der Metadata API entfernt und die Abfrage der Spalten in der Reporting API führt zu einem 400 Bad Request-Fehler.

Attributentfernung

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

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

Gruppen

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