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'.
});