Google Sheets csatlakozó

Google Sheets csatlakozó

Bevezetés

A Google Sheets API lehetővé teszi a felhasználók számára, hogy a Google-fiókjukhoz beállított megfelelő hozzáféréssel létrehozzák, olvassák és szerkesszék a Google Sheeteket. Ennek a csatlakozónak a célja, hogy a Tulip Oauth 2.0-ját kihasználva integrálódjon a Google Sheets-be HTTP-csatlakozók segítségével, és ügyfeleinknek egy olyan out of box csatlakozót biztosítson, amelyet be lehet importálni a saját példányukba.

Cél

1. Különböző HTTP-konnektor funkciókat fogunk kiemelni, amelyeket a Google Sheets API(v4) végpontjainak HTTP-hívásaival lehet építeni a Google táblázatkezelővel való interakcióhoz, hogy kipróbálhassuk a különböző olvasási és írási műveleteket a táblázatkezelőn, amelyeket különböző felhasználási esetekben lehet kihasználni.

API-dokumentum

1. Google Sheets API referenciadokumentum

Előfeltételek

1. Hozzon létre egy fiókot a Google felhő konzolján és konfigurálja az OAuth 2.0 hitelesítő adatokat. További információ a Google API dokumentációjában található.
2. Adja hozzá a példányok átirányítási URL-címét a Google felhőkonzolon.

Tulip kapcsolat részletei

A következő információkat kellene konfigurálni a Tulip csatlakozókon.

1. Futtatás: Felhőcsatlakozó gazdája
2. Host:sheets.googleapis.com
3. Port:443
4. TLS: Igen
5. OAuth 2(Admin): A hitelesítés az összes csatlakozófunkcióra továbbításra kerül.

Csatlakozó funkciók

Google Új táblázat

Cél

1. A felhasználók átadhatják a Spreadsheet Name és SheetName értékeket bemenetként, és a Tulip létrehoz egy új Spreadsheet-et a megadott lapnévvel. Az API válasza a táblázat metaadatai és különböző tulajdonságai lesznek, amelyek szűrőként használhatók a táblázatok adatainak lekérdezéséhez és frissítéséhez.
2. A Google sheets V4 API-ból származó információk a továbbiakban felhasználhatók a Tulip alkalmazásokban, a Tulip táblázatokban vagy a Tulip változókban, amelyeket más csatlakozófunkciókba vezetnek.

Végpont

HTTP POST hívás a https://sheets.googleapis.com/v4/spreadsheets végpontra.

Szükséges bemenet

A következő paraméterek a kérés testeként elküldött paraméterek

1. SpreadSheet Name - A táblázat címe
2. Sheet Name - A lap kezdeti címe

Kimeneti kivonat

1. Táblázat: A SpreadSheet egyedi azonosítója, amelyet a többi feladat elvégzéséhez használnak.
2. táblázatkezelő URL címe: Az újonnan létrehozott táblázatkezelő URL címe.

Google Get SpreadSheet Data (Táblázat adatainak lekérdezése)

Cél

Ez a csatlakozó lekérdezi a megadott spreadsheetId-ről az adatokat a megadott tartományon belül. Az adatokat sorok vagy oszlopok tömbjeként adja meg a csatlakozó funkcióhoz megadott lekérdezési paraméterek alapján.

Végpont

HTTP GET hívás a -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range} végponthoz.

Kötelező bemenet

A következő URL-paramétereket kell átadni

1. SpreadSheet Id
2. Tartomány - Egy [A1 formátumú] karakterlánc (https://developers.google.com/sheets/api/guides/concepts).

a1_notation)

A további lekérdezési paraméterek, amelyeket a csatlakozófüggvények szolgáltatnak, a következők

1. majorDimension : ROWS vagy COLUMNS dönti el, hogy mi legyen a belső adattömb.
2. dateTimeRenderOption meghatározza a DateTime mezők formátumát alapértelmezett érték:FORMATTED_STRING
3. valueRenderOption megadja, hogy az adatoknak formázva vagy formázatlanul kell-e szerepelniük a válaszban alapértelmezett érték: FORMATTED_VALUE

Kimeneti kivonatoló

1. Értékek: Ez egy Array of Arrays, az adatok minden sora egy tömb lesz.

Google SpreadSheet InsertRow

Cél

Értékeket csatol egy táblázatkezelőhöz. A bemeneti tartományt a meglévő adatok keresésére és a tartományon belüli "táblázat" keresésére használja. Az értékek a táblázat következő sorába kerülnek beillesztésre, a táblázat első oszlopával kezdve. A Connector a spreadsheetId, a Range és a cellákba beillesztendő értékek listáját veszi fel.

Végpont

HTTP POST hívás a -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append végponthoz.

Kötelező bemenet

A következő lekérdezési paramétereket kell átadni

1. Táblázat azonosítója
2. Tartomány
3. Értékek: Ehhez a csatlakozóhoz 8 oszlopértéket vettünk figyelembe, minden egyes paramétert a beillesztendő oszlop ellenében neveztünk el. Ezt az API-nak értékek tömbjeként kell átadni.

A további lekérdezési paraméterek, amelyeket a csatlakozófüggvények szolgáltatnak, a következők:

1. valueInputOption: Ez egy kötelező mező, amelyet a csatlakozó küld el, alapértelmezett értékkészlet: USER_ENTERED

Kimeneti kivonatoló

1. spreadsheetId
2. UpdatedRows: Megadja a beillesztett sorok számát.

Google SpreadSheet Clear

Cél

Értékek törlése egy táblázatkezelőből. A hívónak meg kell adnia a táblázat azonosítóját és a tartományt. Csak az értékek törlődnek - a cella minden más tulajdonsága (például formázás, adatérvényesítés stb.) megmarad. A Connector a spreadsheetId, a Range és a cellákba beillesztendő értékek listáját veszi fel.

Végpont

HTTP POST hívás a -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear végponthoz.

Kötelező bemenet

A következő lekérdezési paramétereket kell átadni

1. Táblázat azonosítója
2. Tartomány

Google Get SpreadSheet Details byFilter

Cél

Ez a csatlakozó a megadott spreadsheetId azonosítóval és az adatszűrőben megadott feltételekkel rendelkező táblázatok részleteit hívja le.

Végpont

HTTP POST hívás a -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getbyDataFilter végpontra.

Kötelező bemenet

A következő lekérdezési paramétereket kell átadni

1. spreadSheetId
2. includeGridData: Alapértelmezett érték: False

A következő paraméterek a kérés testének részeként kerülnek elküldésre JSON formátumban.

1. gridRange

Kimeneti kivonatolók

1. spreadSheetId
2. Title
3. Locale
4. automatikus újraszámítás
5. timeZone
6. sheetId
7. sheetTitle
8. sheetType
9. sheetRowCount
10. sheetColumnCount
11. spreadSheetUrl

Vannak más paraméterek is, amelyek a kimenet részeként szerepelhetnek a felhasználói felhasználási eset alapján

Google Get Batch Data

Cél

Ez a csatlakozó lekérdezi az adatokat a megadott spreadsheetId-ből Az adatok sorok vagy oszlopok tömbjeként lesznek megadva a csatlakozónak megadott lekérdezési paraméterek alapján.

Végpont

HTTP GET hívás a végponthoz -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

Kötelező bemenet

A következő lekérdezési paramétereket kell átadni

1. SpreadSheet Id
2. Range - A String in A1Formátum

a1_notation)

A csatlakozófüggvények által szolgáltatott további lekérdezési paraméterek a következők

1. majorDimension : ROWS vagy COLUMNS eldönti, hogy mi legyen a belső adattömb.
2. dateTimeRenderOption meghatározza a DateTime mezők formátumát alapértelmezett érték:FORMATTED_STRING
3. valueRenderOption megadja, hogy az adatokat formázva vagy formázatlanul kell-e megjeleníteni a válaszban alapértelmezett érték:FORMATTED_VALUE

Kimeneti kivonatoló

1. valueRanges: Ez egy objektumokból álló tömb. Minden objektum egy tartományt részletez

Google Get Batch Data szűrő

Cél

Ez a csatlakozó a megadott szűrőfeltételen belül megadott spreadsheetId-ből egy köteg adatot fog lekérni. Az adatok sorok vagy oszlopok tömbjeként kerülnek átadásra a csatlakozónak megadott lekérdezési paraméterek alapján.

Végpont

HTTP POST hívás a -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter végponthoz.

Kötelező bemenet

A következő lekérdezési paramétereket kell átadni

1. SpreadSheet Id

A csatlakozófüggvények által szolgáltatandó további kéréstest paraméterek a következők

1. Datfilters
2. majorDimension : ROWS vagy COLUMNS dönti el, hogy mi legyen a belső adattömb.
3. dateTimeRenderOption meghatározza a DateTime mezők formátumát alapértelmezett érték:FORMATTED_STRING
4. valueRenderOption megadja, hogy az adatokat formázva vagy formázatlanul kell-e megjeleníteni a válaszban alapértelmezett érték: FORMATTED_VALUE

Kimeneti kivonatoló

1. valueRanges: Ez egy objektumokból álló tömb. Minden objektum egy tartományt részletez

Video