Dieses Dokument bietet einen allgemeinen Überblick über die Google Analytics Metadata API. Eine detaillierte Referenz zur API finden Sie in der API-Referenz.
Einleitung
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 unter anderem der UI-Name, die Beschreibung und die Segmentunterstützung.
Sie können die Metadata API für Folgendes verwenden:
- Neue Spalten automatisch erkennen
- Zugriff auf alle Dimensionen und Messwertattribute für Google Analytics Reporting APIs
Sehen Sie sich eine Live-Antwort der Metadata API an und erfahren Sie im Entwicklerleitfaden, wie Sie diese verwenden können.
Konzeptübersicht
Die grundlegenden Konzepte, die der Metadata API zugrunde liegen, sind:
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 Metadata API-Referenzhandbuch. Das Metadata API-Entwicklungshandbuch enthält Details zur Arbeit mit der API.
API-Zugriff
Die Metadata API erfordert keine Authentifizierung und Autorisierung. Die einzige Anforderung besteht darin, dass sich die Anwendung jedes Mal selbst identifiziert, wenn sie eine Anfrage an die Analytics API sendet. Weitere Informationen dazu finden Sie im Entwicklerleitfaden im Abschnitt API-Zugriff.
Kontingent- und Einstellungsrichtlinien
Die Metadata API verarbeitet Millionen von Vorgängen. Damit das System nicht mehr Vorgänge erhält, als es verarbeiten kann, und um für eine gleichmäßige Verteilung der Systemressourcen zu sorgen, ist ein Kontingentsystem erforderlich. Weitere Informationen finden Sie im Leitfaden zu Limits und Kontingenten.
Ausführliche Informationen dazu, wie Änderungen an den Spalten der Reporting API (z.B. an Dimensionen und Messwerten) verarbeitet werden, finden Sie in der Richtlinie zur Einstellung von Daten. Informationen dazu, wie Sie mit der Metadata API nach eingestellten Spalten suchen können, finden Sie im Entwicklerleitfaden für die Metadata API.