Konektor Arkuszy Google

Konektor Arkuszy Google

Wprowadzenie

Interfejs API Arkuszy Google umożliwia użytkownikom tworzenie, odczytywanie i edytowanie arkuszy Google z odpowiednim dostępem do ich kont Google. Celem tego konektora jest wykorzystanie Tulip's Oauth 2.0 do integracji z Google Sheets przy użyciu konektorów HTTP i zapewnienie naszym klientom gotowego konektora, który można zaimportować do ich instancji.

Cel

1. Zamierzamy wyróżnić różne funkcje konektorów HTTP, które można zbudować, wykonując wywołania HTTP do punktów końcowych Google Sheets API (v4) w celu interakcji z arkuszem kalkulacyjnym Google, aby wypróbować różne akcje odczytu i zapisu w arkuszu kalkulacyjnym, które można wykorzystać w różnych przypadkach użycia.

Dokument API

1. Dokument referencyjny interfejsu API Arkuszy Google

Wymagania wstępne

1. Utwórz konto w Google Cloud Console i skonfiguruj poświadczenia OAuth 2.0. Więcej informacji można znaleźć w dokumentach API Google.
2. Dodaj adres URL przekierowania instancji w Google Cloud Console

Szczegóły połączenia Tulip

W konektorach Tulip należy skonfigurować następujące informacje.

1. Uruchomione na: Host konektora w chmurze
2. Host:sheets.googleapis.com
3. Port:443
4. TLS: Tak
5. OAuth 2(Admin): Uwierzytelnianie zostanie przeniesione do wszystkich funkcji konektora.

Funkcje konektora

Nowy arkusz kalkulacyjny Google

Cel

1. Użytkownicy mogą przekazać nazwę arkusza kalkulacyjnego i nazwę arkusza jako dane wejściowe, a Tulip utworzy nowy arkusz kalkulacyjny z podaną nazwą arkusza. Odpowiedzią API będą metadane i różne właściwości arkusza kalkulacyjnego, które mogą być dalej używane jako filtry do pobierania i aktualizowania danych z arkuszy kalkulacyjnych.
2. Informacje pobierane z API Arkuszy Google V4 mogą być następnie dalej wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przesyłane do innych funkcji konektora.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego https://sheets.googleapis.com/v4/spreadsheets

Wymagane dane wejściowe

Jako treść żądania wysyłane są następujące parametry

1. SpreadSheet Name - tytuł arkusza kalkulacyjnego
2. Sheet Name - początkowy tytuł arkusza

Ekstraktor danych wyjściowych

1. arkusz kalkulacyjny: Unikalny identyfikator arkusza kalkulacyjnego, który będzie używany do wykonywania innych zadań.
2. adres URL arkusza kalkulacyjnego: Adres URL nowo utworzonego arkusza kalkulacyjnego

Google Get SpreadSheet Data

Cel

Ten konektor pobierze dane z podanego identyfikatora spreadsheetId w podanym zakresie. Dane zostaną dostarczone jako tablica wierszy lub kolumn w oparciu o parametry zapytania dostarczone do funkcji łącznika.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać

1. Identyfikator arkusza kalkulacyjnego
2. Range - String w [A1 Format](https://developers.google.com/sheets/api/guides/concepts

a1_notation)

Dodatkowe parametry zapytania, które będą dostarczane z funkcji łącznika to

1. majorDimension : ROWS lub COLUMNS decyduje o tym, jaka powinna być wewnętrzna tablica danych
2. dateTimeRenderOption określa format pól DateTime wartość domyślna:FORMATTED_STRING
3. valueRenderOption określa, czy dane mają być sformatowane czy niesformatowane w odpowiedzi wartość domyślna: FORMATTED_VALUE

Ekstraktor danych wyjściowych

1. Wartości: Jest to tablica tablic, każdy wiersz danych będzie tablicą.

Google SpreadSheet InsertRow

Cel

Dodaje wartości do arkusza kalkulacyjnego. Zakres wejściowy jest używany do wyszukiwania istniejących danych i znajdowania "tabeli" w tym zakresie. Wartości zostaną dołączone do następnego wiersza tabeli, zaczynając od pierwszej kolumny tabeli. Connector pobiera spreadsheetId, Range i listę wartości, które mają zostać wstawione do komórek.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

Wymagane dane wejściowe

Poniżej przedstawiono parametry zapytania, które należy przekazać

1. Identyfikator arkusza kalkulacyjnego
2. Zakres
3. Values: dla tego łącznika uwzględniliśmy 8 wartości kolumn z każdym parametrem nazwanym względem kolumny, do której zostaną wstawione. Zostaną one przekazane do interfejsu API jako tablica wartości.

Dodatkowe parametry zapytania, które będą dostarczane z funkcji konektora to :

1. valueInputOption: Jest to pole obowiązkowe i będzie wysyłane z konektora, Domyślny zestaw wartości: USER_ENTERED

Ekstraktor danych wyjściowych

1. spreadsheetId
2. UpdatedRows: Określa liczbę wstawionych wierszy.

Wyczyść arkusz kalkulacyjny Google

Cel

Czyści wartości z arkusza kalkulacyjnego. Osoba wywołująca musi określić identyfikator arkusza kalkulacyjnego i zakres. Usuwane są tylko wartości - wszystkie inne właściwości komórki (takie jak formatowanie, sprawdzanie poprawności danych itp.) są zachowywane. Connector pobiera spreadsheetId, Range i listę wartości, które mają zostać wstawione do komórek.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear

Wymagane dane wejściowe

Poniżej znajdują się parametry zapytania, które należy przekazać

1. Identyfikator arkusza kalkulacyjnego
2. Zakres

Google Get SpreadSheet Details byFilter

Cel

Ten łącznik pobierze szczegóły arkusza kalkulacyjnego z podanym identyfikatorem arkusza kalkulacyjnego i określonym warunkiem określonym w filtrze danych.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getbyDataFilter

Wymagane dane wejściowe

Poniżej przedstawiono parametry zapytania, które należy przekazać

1. spreadSheetId
2. includeGridData: Wartość domyślna to False

Następujące parametry są wysyłane jako część treści żądania w formacie JSON

1. gridRange

Ekstraktory danych wyjściowych

1. spreadSheetId
2. Tytuł
3. Locale
4. auto recalc
5. timeZone
6. sheetId
7. sheetTitle
8. sheetType
9. sheetRowCount
10. sheetColumnCount
11. spreadSheetUrl

Istnieją inne parametry, które mogą być uwzględnione jako część danych wyjściowych w oparciu o przypadek użycia użytkownika

Pobieranie danych wsadowych Google

Cel

Ten konektor pobierze dane z identyfikatora arkusza kalkulacyjnego podanego w Dane zostaną dostarczone jako tablica wierszy lub kolumn w oparciu o parametry zapytania dostarczone do konektora.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

Wymagane dane wejściowe

Poniżej przedstawiono parametry zapytania, które należy przekazać

1. SpreadSheet Id
2. Range - String w [A1Format](https://developers.google.com/sheets/api/guides/concepts

a1_notation)

Dodatkowe parametry zapytania, które będą dostarczane z funkcji łącznika, to

1. majorDimension : ROWS lub COLUMNS decyduje o tym, jaka powinna być wewnętrzna tablica danych
2. dateTimeRenderOption określa format pól DateTime wartość domyślna:FORMATTED_STRING
3. valueRenderOption określa, czy dane mają być sformatowane czy niesformatowane w odpowiedzi wartość domyślna:FORMATTED_VALUE

Ekstraktor danych wyjściowych

1. valueRanges: Jest to tablica obiektów. Każdy obiekt określa jeden zakres

Filtr Google Get Batch Data

Cel

Ten konektor pobierze dane z arkusza kalkulacyjnegoId dostarczonego w ramach podanego warunku filtra jako partię danych. Dane zostaną dostarczone jako tablica wierszy lub kolumn w oparciu o parametry zapytania dostarczone do konektora.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter

Wymagane dane wejściowe

Poniżej przedstawiono parametry zapytania, które należy przekazać

1. Id arkusza kalkulacyjnego

Dodatkowe parametry treści żądania, które będą dostarczane z funkcji łącznika, to

1. Datfilters
2. majorDimension : ROWS lub COLUMNS decyduje o tym, jaka powinna być wewnętrzna tablica danych
3. dateTimeRenderOption określa format pól DateTime wartość domyślna:FORMATTED_STRING
4. valueRenderOption określa, czy dane mają być sformatowane czy niesformatowane w odpowiedzi wartość domyślna: FORMATTED_VALUE

Ekstraktor danych wyjściowych

1. valueRanges: Jest to tablica obiektów. Każdy obiekt określa jeden zakres

Wideo