Die Google Analytics Management API ermöglicht den programmatischen Zugriff auf Konten, Properties und Datenansichten. In diesem Dokument wird beschrieben, wie Sie die Einrichtung Ihres Google Analytics-Kontos mithilfe verschiedener API-Ressourcen konfigurieren.
Einleitung
Es gibt zwei gängige Anwendungsfälle, die bei der Konfiguration Ihres Google Analytics-Kontos von der Management API unterstützt werden. Zum einen muss schnell eine Kontoübersicht der gesamten hierarchischen Struktur Ihrer Konten, Properties und Datenansichten abgerufen werden. Die zweite besteht darin, bestimmte Konfigurationsänderungen vorzunehmen.
Kontozusammenfassungen
Über den Endpunkt Kontozusammenfassungen können Sie schnell und einfach Informationen zu Google Analytics-Konten, -Properties und -Datenansichten für autorisierte Nutzer abrufen.
Mithilfe von Kontozusammenfassungen kann ein Index der Kontohierarchie erstellt werden. Anwendungen, die in Google Analytics eingebunden werden können, bieten häufig eine Oberfläche zur Auswahl eines Kontos, einer Property und einer Datenansicht. Mit einer einzigen Anfrage an die API können Sie alle relevanten Informationen zum Erstellen eines solchen Selektors abrufen. Ein Beispiel finden Sie im Abfrage-Explorer und in den Codebeispielen auf GitHub.
Weitere Informationen und Codebeispiele finden Sie in der Ressourcenreferenz zu „Kontozusammenfassungen“ und der Referenz zu Listenmethoden.
Kontokonfiguration
Im Gegensatz zu Kontozusammenfassungen, wenn Sie die Listenmethode der Ressourcen Account, Property und View verwenden, gibt die API vollständige Details zu jeder Ressource zurück.
Konten
Als übergeordnete Entität ist accounts wichtig, da für jede API-Anfrage einer niedrigeren Ebene eine Konto-ID erforderlich ist. Die Management API lässt list nur für Konten zu. Beachten Sie in der API-Antwort das Attribut childlink, das die API-Anfrage für alle untergeordneten Web-Properties sendet.
Attribute
Die Entität der zweiten Ebene, die auch Web-Properties genannt wird, ist wichtig, weil die gesamte Datenerfassung auf dieser Ebene stattfindet. Wenn Sie beispielsweise einer Website oder mobilen App Tracking-Code hinzufügen, muss die ID so aussehen: UA-XXXXX-Y. Diese ID wird Property-ID oder Tracking-ID genannt und bestimmt, in welcher Google Analytics-Kontodaten gespeichert werden. Sie können mit der API Properties erstellen oder aktualisieren. Details und Codebeispiele finden Sie in der Property-Ressource.
Aufrufe
Als dritte Ebene in der Kontohierarchie sind Datenansichten (Profile) wichtig, da sie auf dieser Ebene für Berichte verwendet werden. Bei der Core Reporting API wird die ID der Datenansicht (Profil) als Schlüsselparameter verwendet, um anzugeben, aus welcher Datenansicht Daten abgerufen werden sollen. Neben der Berichtsebene sind auch viele andere Ressourcen entweder verknüpft oder untergeordnete Ressourcen wie 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 "Ansicht (Profil)".
Nächste Schritte
Nachdem Sie diese Anleitung gelesen haben, sollten Sie wissen, wie Sie mit der Management API die verschiedenen Kontokonfigurationsentitäten durchsuchen und bearbeiten können. Im nächsten Leitfaden erfahren Sie, wie Sie die API für die Nutzerverwaltung verwenden.