MENU
    Konektor Arkuszy Google
    • 03 Nov 2023
    • 4 Minuty do przeczytania
    • Współtwórcy

    Konektor Arkuszy Google


    Streszczenie artykułu

    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


    Czy ten artykuł był pomocny?