Aby utworzyć społecznościowe oprogramowanie sprzęgające, należy:
- Utwórz nowy projekt Apps Script.
- Napisz kod oprogramowania sprzęgającego.
- Wypełnij plik manifestu projektu.
Tworzenie nowego projektu Apps Script
Aby utworzyć nowy projekt, otwórz stronę Google Apps Script. Apps Script
utworzy za Ciebie domyślny skrypt. Możesz usunąć funkcję myFunction
i zmienić nazwę projektu. (Więcej informacji o Apps Script)
Pisanie kodu oprogramowania sprzęgającego
Każde oprogramowanie sprzęgające musi mieć zdefiniowany określony zestaw funkcji. Funkcje te będą wykonywane przez aplikację hostującą (np. Looker Studio). Oprogramowanie sprzęgające powinno obsługiwać przychodzące żądania i odpowiadać w sposób opisany w dokumentacji interfejsu Community Connector API. Jeśli podczas tworzenia kodu wystąpią problemy, przeczytaj przewodnik dotyczący debugowania, aby uzyskać pomoc.
Zdefiniuj typ uwierzytelniania w getAuthType()
Funkcja ta jest wywoływana w celu identyfikacji metody uwierzytelniania używanej w usłudze innej firmy. Więcej informacji znajdziesz w dokumentacji getAuthType(). Obecnie obsługiwane metody uwierzytelniania znajdziesz w dokumentacji AuthType
.
Na przykład poniższe oprogramowanie sprzęgające nie wymaga uwierzytelniania:
Jeśli Twoje źródło danych wymaga uwierzytelniania OAuth 2.0, zapoznaj się z przewodnikiem po uwierzytelnianiu OAuth 2.0 i dodaj do oprogramowania sprzęgającego dodatkowe wymagane funkcje.
Zdefiniuj konfigurację za pomocą opcji getConfig()
Funkcja getConfig()
jest wywoływana w celu pobrania konfiguracji oprogramowania sprzęgającego z uwzględnieniem wartości podanych przez użytkownika, które są wymagane przez oprogramowanie sprzęgające. Więcej informacji znajdziesz w dokumentacji getConfig()
.
Na podstawie odpowiedzi przesłanej przez getConfig()
Looker Studio wyrenderuje ekran konfiguracji oprogramowania sprzęgającego. Obsługiwane elementy konfiguracji znajdziesz w dokumentacji ConfigType
.
Jeśli Twoje źródło danych wymaga parametru date, wywołaj config.setDateRangeRequired(true). Jeśli musisz zadać pytania dotyczące konfiguracji warunkowej lub dynamicznej, zapoznaj się z sekcją dotyczącą konfiguracji krokowej.
Poniżej znajdziesz przykład oprogramowania sprzęgającego, które wymaga od użytkownika wpisania kodu nazwy pakietu npm. Pole informacji i pole do wprowadzania danych są zdefiniowane w funkcji getConfig()
:
Zdefiniuj pola za pomocą metody getSchema()
Ta funkcja jest wywoływana w celu pobrania schematu dla danego żądania. Wszystkie parametry konfiguracji zdefiniowane przez funkcję getConfig()
będą podane w argumencie request
. Więcej informacji znajdziesz w dokumentacji getSchema()
.
W zależności od źródła danych oprogramowania sprzęgającego i konfiguracji udostępnionej przez użytkownika schemat może być stały lub wymagać dynamicznego dostarczania w momencie żądania.
Jeśli na przykład oprogramowanie sprzęgające pobiera dane raportu na podstawie identyfikatora raportu, dane zwrócone z tego raportu, więc schemat może być wcześniej nieznane.
W tym przypadku getSchema()
może wymagać pobrania danych i konieczne jest obliczenie schematu.
Pobieranie i zwracanie danych za pomocą metody getData()
Funkcja ta jest wywoływana w celu uzyskania danych dla danego żądania. Wszystkie parametry konfiguracji zdefiniowane przez funkcję getConfig()
będą podane w argumencie request
. Więcej informacji znajdziesz w dokumentacji getData()
.
Te parametry żądania getData()
wymagają dodatkowej uwagi:
lastRefresh
lastRefresh
oznacza sygnaturę czasową, która wskazuje czas ostatniego żądania odświeżenia danych. Możesz przeanalizować wartość za pomocą funkcjinew Date(timestampString)
. Jeśli korzystasz z usługi Apps Script Cache lub innej metody buforowania, sygnatura czasowalastRefresh
może pomóc Ci w określeniu, czy wysłać nowe żądanie pobierania do źródła danych, czy udostępniać dane z pamięci podręcznej.dateRange
JeślidateRangeRequired
ma w żądaniugetConfig()
wartośćtrue
, każde wywołaniegetData()
będzie zawierać w żądaniu wybrany zakres dat. Więcej informacji znajdziesz w artykule Praca z zakresami dat.
Poniższy przykład pobiera dane na podstawie przychodzącego żądania i zwraca statystyki pakietu:
Wypełnij plik manifestu projektu
Plik manifestu zawiera informacje o społecznościowym oprogramowaniu sprzęgającym, które są wymagane do wdrożenia oprogramowania sprzęgającego i korzystania z niego w Looker Studio.
Aby edytować plik manifestu w środowisku programistycznym Apps Script, kliknij menu Widok i wybierz Pokaż plik manifestu. Spowoduje to utworzenie nowego pliku manifestu appsscript.json
.
Zaktualizuj plik manifestu, aby zawierał te dane:
Szczegółowe informacje o pliku manifestu Looker Studio znajdziesz w dokumentacji pliku manifestu.
Dalsze kroki
Następnym krokiem będzie wdrożenie społecznościowego oprogramowania sprzęgającego.