Über die Google Analytics Management API können Sie programmatisch auf Konten, Properties und Datenansichten zugreifen. In diesem Dokument wird beschrieben, wie Sie verschiedene API-Ressourcen zur Konfiguration Ihres Google Analytics-Kontos verwenden können.
Einführung
Die Management API bietet zwei häufige Anwendungsfälle für die Konfiguration Ihres Google Analytics-Kontos. Zuerst muss schnell eine Kontoübersicht über die gesamte Hierarchie der Konten, Properties und Datenansichten erstellt werden. Die zweite Möglichkeit ist, bestimmte Konfigurationsänderungen vorzunehmen.
Kontozusammenfassungen
Über den Endpunkt Kontozusammenfassungen lassen sich einfache Informationen zu Google Analytics-Konten, -Properties und -Datenansichten für einen autorisierten Nutzer mit einer einzigen und schnellen Anfrage auflisten.
Kontozusammenfassungen können verwendet werden, um einen Index der Kontohierarchie zu erstellen. Anwendungen, die in Google Analytics eingebunden werden, stellen eine Schnittstelle bereit, über die Nutzer ein Konto, eine Property und eine Datenansicht auswählen können. Mit einer einzigen Anfrage an die API können Sie alle relevanten Informationen abrufen, um einen solchen Selektor zu erstellen. Ein Beispiel finden Sie unter Abfrage-Explorer und Codebeispiele auf GitHub.
Weitere Informationen und Codebeispiele finden Sie in den Ressourcenreferenzen zu Konten und in der Referenz zur Methodenmethode.
Kontokonfiguration
Im Gegensatz zu Kontozusammenfassungen werden bei Verwendung der Listenmethode Konto, Property und View vollständige Details für jede Ressource zurückgegeben.
Konten
Da es sich um die Konten auf oberster Ebene handelt, ist für jede API-Anfrage auf niedrigerer Ebene eine Konto-ID erforderlich. Die Management API lässt den list-Vorgang nur für Konten zu. In der API-Antwort ist das Attribut childlink angegeben, das die API-Anfrage für alle untergeordneten Web-Properties erhält.
Attribute
Auch als Web-Properties bezeichnet, ist das Element der zweiten Ebene wichtig, weil die gesamte Datenerhebung auf dieser Ebene erfolgt. Wenn Sie beispielsweise Tracking-Code auf einer Website oder in einer mobilen App einfügen, müssen Sie eine ID angeben, die ungefähr UA-XXXXX-Y aussieht. Diese ID wird als Property-ID oder Tracking-ID bezeichnet und unterscheidet die Daten in den Google Analytics-Kontodaten. Mit der API können Sie Attribute erstellen oder aktualisieren. Details und Codebeispiele finden Sie in der Property-Ressource.
Aufrufe
Als dritte Ebene in der Kontohierarchie sind Datenansichten (Profile) wichtig, weil dies die Ebene ist, auf der Berichte erstellt werden. Bei der Core Reporting API wird die Datenansichts-ID (Profil-ID) als Schlüsselparameter verwendet, um festzulegen, von welcher Ansicht die Daten abgerufen werden sollen. Zusätzlich zur Berichtsebene sind viele andere Ressourcen entweder verknüpft oder sind untergeordnete Ressourcen dieser Ressource, z. B. Zielvorhaben, Tests, Gesamtdatenberichte und Filterlinks. Sie können die API verwenden, um Ansichten zu erstellen oder zu aktualisieren. Details und Codebeispiele finden Sie in der Ressource „Datenansicht“ (Profil).
Nächste Schritte
Nachdem Sie diesen Leitfaden gelesen haben, sollten Sie mit der Verwendung der Management API vertraut sein, um die verschiedenen Kontenkonfigurationsentitäten durchsuchen und bearbeiten zu können. Im nächsten Leitfaden erfahren Sie, wie Sie die API zur Nutzerverwaltung verwenden können.