In diesem Dokument finden Sie eine Referenz zu den wichtigsten Embed API-Methoden sowie eine Übersicht dazu, wie diese Methoden mit den Embed API-Komponenten und der zugrunde liegenden Analytics-Clientbibliothek interagieren.
Kernmethoden
Die Hauptmethoden der Embed API sind die Methoden im gapi.analytics
-Objekt.
ready
Stellt eine Callback-Funktion in die Warteschlange, die aufgerufen werden soll, sobald die Embed API-Bibliothek vollständig geladen wurde. Callbacks werden in der Reihenfolge aufgerufen, in der sie hinzugefügt wurden.
Die ready
-Funktion wird durch das Embed API-Snippet definiert, sodass sie sofort verwendet werden kann. Alle anderen Funktionen sollten innerhalb des ready
-Callbacks platziert werden, damit die Bibliothek vor ihrem Aufruf geladen wird.
Nutzung
gapi.analytics.ready(callback)
Parameter
Name | Typ | Beschreibung |
---|---|---|
callback |
Function |
Die Funktion, die aufgerufen werden soll, sobald die Embed API-Bibliothek vollständig geladen ist. |
Beispiel
gapi.analytics.ready(function() { // Code in here will be invoked once the library fully loads. });
createComponent
Erstellt eine Komponente mit dem angegebenen Namen und den Prototypmethoden. Die erstellte Komponente wird unter gapi.analytics.ext
mit dem übergebenen Namen gespeichert.
Die Funktion createCallback
sollte immer in einem Bereitschafts-Callback aufgerufen werden, damit die Embed API-Clientbibliothek geladen wird.
Nutzung
gapi.analytics.createComponent(name, prototypeMethods)
Parameter
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name der Komponente. |
prototypeMethods |
Object |
Ein Objekt, dessen Eigenschaften und Methoden im Prototyp der Komponente gespeichert werden. |
Beispiel
gapi.analytics.ready(function() { gapi.analytics.createComponent('MyComponent', { foo: function() { alert('foo'); }, bar: function() { alert('bar'); } }); var myComponentInstance = new gapi.analytics.ext.MyComponent(); myComponentInstance.foo(); // Alerts 'foo'. });