Interfejs Embed API udostępnia programistom kilka wbudowanych komponentów do wysyłania zapytań i wyświetlania danych w raportach. Wszystkie komponenty są oparte na wspólnej podstawy i mają wiele tych samych metod. Z tej sekcji dowiesz się, jak korzystać z tych metod udostępnianych. Więcej informacji o poszczególnych komponentach znajdziesz w dokumentacji komponentów.
Opcje komponentu
Opcje komponentów są ustawiane w czasie tworzenia za pomocą funkcji konstruktora poprzez wywołanie w instancji metody set. Aby w dowolnym momencie uzyskać stan instancji komponentu, możesz wywołać metodę get
. Zwrócone zostaną jej bieżące opcje.
Interakcja komponentowa
Komponenty emitują zdarzenia, gdy wydarzy się coś ważnego, dzięki czemu inne komponenty mogą zareagować, gdy wystąpią takie zdarzenia. Aby zarejestrować moduł obsługi w danym zdarzeniu, wywołaj metodę on
. Możesz też użyć metody once
, która jest podobna do on
, ale jej moduł obsługi zostanie wywołany tylko za pierwszym razem, a następnie automatycznie usunięty. Moduł obsługi możesz usunąć za pomocą metody off
.
Zwykle nasłuchujesz tylko domyślnych zdarzeń generowanych przez te komponenty, ale jeśli chcesz wygenerować własne zdarzenie, możesz to zrobić za pomocą metody emit
.
Biblioteka klienta Analytics
Interfejs Embed API wczytuje też bibliotekę klienta Google Analytics, która w razie potrzeby umożliwia dostęp do wielu innych interfejsów API Google Analytics.
W tych przestrzeniach nazw dostępne są następujące interfejsy API:
gapi.client.analytics.data.ga gapi.client.analytics.data.mcf gapi.client.analytics.data.realtime gapi.client.analytics.management gapi.client.analytics.metadata