Die Embed API bietet Entwicklern mehrere integrierte Komponenten zum Abfragen und Anzeigen von Berichtsdaten. Alle Komponenten basieren auf einer gemeinsamen Basis und nutzen daher viele identische Methoden. In diesem Abschnitt erhalten Sie einen Überblick über die Verwendung dieser Methoden. Weitere Informationen zu den einzelnen Komponenten finden Sie in der Komponentenreferenz.
Komponentenoptionen
Komponentenoptionen werden beim Erstellen über die Konstruktorfunktion festgelegt, indem die set-Methode für die Instanz aufgerufen wird. Sie können jederzeit get aufrufen, um den Status einer Komponenteninstanz abzurufen. Die aktuellen Optionen werden dann zurückgegeben.
Komponenteninteraktion
Komponenten geben Ereignisse aus, wenn etwas Wichtiges passiert, sodass andere Komponenten reagieren können, wenn diese Ereignisse eintreten. Rufen Sie einfach die Methode on auf, um einen Handler mit einem bestimmten Ereignis zu registrieren. Alternativ können Sie die Methode once verwenden, die dem on ähnelt. Der Handler wird jedoch nur beim ersten Mal aufgerufen und dann automatisch entfernt. Zum Entfernen eines Handlers können Sie die Methode off verwenden.
Normalerweise warten Sie nur auf die Standardereignisse, die von den Komponenten ausgegeben werden. Wenn Sie jedoch ein eigenes Ereignis ausgeben müssen, können Sie dies über die Methode emit tun.
Analytics-Clientbibliothek
Die Embed API lädt auch die Google Analytics-Clientbibliothek, mit der Sie bei Bedarf auf viele weitere Google Analytics APIs zugreifen können.
Die folgenden APIs sind in diesen Namespaces verfügbar:
gapi.client.analytics.data.ga gapi.client.analytics.data.mcf gapi.client.analytics.data.realtime gapi.client.analytics.management gapi.client.analytics.metadata