Was ist die Metadata API – Übersicht

Dieses Dokument bietet eine allgemeine Übersicht über die Google Analytics Metadata API. Eine ausführliche Referenz zur API finden Sie in der API-Referenz.

Einführung

Die Metadata API gibt die Liste und die Attribute der Spalten (Dimensionen und Messwerte) zurück, die in den Google Analytics Reporting APIs verfügbar sind. Zu den zurückgegebenen Attributen gehören UI-Name, Beschreibung, Segmentunterstützung und mehr.

Sie können die Metadata API für Folgendes verwenden:

  • Neue Spalten automatisch erkennen
  • Zugriff auf alle Dimensions- und Messwertattribute für Google Analytics Reporting APIs

Sehen Sie sich eine Live-Antwort der Metadata API an. Im Entwicklerleitfaden erfahren Sie, wie Sie diese verwenden können.

Konzeptübersicht

Die Metadata API basiert auf folgenden grundlegenden Konzepten:

Spalte

Eine Spaltenressource in der Metadata API stellt eine einzelne Dimension oder einen einzelnen Messwert dar und enthält Informationen wie den Id und andere Attribute für diese Spalte. Eine Sammlung von Column-Ressourcen stellt alle Dimensionen und Messwerte für eine Reporting API dar.

Mit der API arbeiten

Beim Abfragen der API geben Sie den Berichtstyp an, für den Sie Metadaten abrufen möchten. Die Antwort der API enthält eine Sammlung aller Spalten (d.h. Dimensionen und Messwerte), die für diesen Berichtstyp verfügbar sind. Weitere Informationen zur API-Antwort und Codebeispiele finden Sie im Referenzhandbuch für die Metadata API. Details zur Arbeit mit der API finden Sie im Entwicklerleitfaden für die Metadata API.

API-Zugriff

Die Metadata API erfordert keine Authentifizierung und Autorisierung. Die einzige Anforderung besteht stattdessen darin, dass sich die Anwendung jedes Mal selbst identifizieren muss, wenn sie eine Anfrage an die Analytics API sendet. Weitere Informationen dazu findest du im Abschnitt API-Zugriff des Entwicklerhandbuchs.

Kontingent- und Einstellungsrichtlinien

Die Metadata API verarbeitet Millionen von Vorgängen. Es ist erforderlich, ein Kontingentsystem zu verwenden, um zu verhindern, dass das System mehr Vorgänge erhält, als es verarbeiten kann, und um eine gleichmäßige Verteilung der Systemressourcen zu gewährleisten. Weitere Informationen finden Sie im Leitfaden zu Limits und Kontingenten.

Ausführliche Informationen dazu, wie Änderungen an Berichts-API-Spalten (d.h. an Dimensionen und Messwerten) verarbeitet werden, finden Sie in der Richtlinie zur Einstellung von Daten. Informationen dazu, wie Sie mit der Metadata API nach verworfenen Spalten suchen können, finden Sie im Entwicklerleitfaden für die Metadata API.