Google Sheets-Verbindung

Google Sheets-Verbindung

Einführung

Google Sheets API ermöglicht es den Nutzern, Google Sheets zu erstellen, zu lesen und zu bearbeiten, wenn sie den richtigen Zugang zu ihren Google-Konten haben. Das Ziel dieses Konnektors ist es, Tulips Oauth 2.0 zu nutzen, um Google Sheets über HTTP-Konnektoren zu integrieren und unseren Kunden einen fertigen Konnektor zu bieten, der in ihre Instanz importiert werden kann.

Zweck

1. Wir werden verschiedene HTTP-Connector-Funktionen hervorheben, die durch HTTP-Aufrufe an Google Sheets API(v4)-Endpunkte erstellt werden können, um mit dem Google Spreadsheet zu interagieren und verschiedene Lese- und Schreibaktionen auf dem Spreadsheet auszuprobieren, die für verschiedene Anwendungsfälle genutzt werden können.

API-Dokument

1. Google Sheets API-Referenzdokument

Vorraussetzungen

1. Erstellen Sie ein Konto in der Google Cloud Console und konfigurieren Sie die OAuth 2.0-Anmeldedaten. Weitere Informationen finden Sie in den API-Dokumenten von Google.
2. Fügen Sie die Instanzen Redirect URL auf der Google Cloud Console hinzu

Tulip Verbindungsdetails

Die folgenden Informationen müssen für die Tulip-Konnektoren konfiguriert werden.

1. Läuft auf: Cloud Connector Host
2. Host:sheets.googleapis.com
3. Anschluss:443
4. TLS: Ja
5. OAuth 2(Verwaltung): Die Authentifizierung wird an alle Connector-Funktionen weitergegeben

Konnektor-Funktionen

Google Neue Tabellenkalkulation

Zweck

1. Benutzer können einen Spreadsheet-Namen und SheetName als Eingabe übergeben & Tulip wird ein neues Spreadsheet mit dem angegebenen Sheet-Namen erstellen. Die Antwort der API sind die Metadaten und verschiedene Eigenschaften des Arbeitsblatts. Diese können weiter als Filter zum Abrufen und Aktualisieren von Daten aus den Arbeitsblättern verwendet werden.
2. Die Informationen, die aus Google Sheets V4 API gezogen werden, können dann entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen geleitet werden.

Endpunkt

HTTP POST-Aufruf an den Endpunkt https://sheets.googleapis.com/v4/spreadsheets

Erforderliche Eingabe

Die folgenden Parameter werden als Request Body gesendet

1. SpreadSheet Name - Der Spreadsheet-Titel
2. Sheet Name - Ursprünglicher Titel des Arbeitsblatts

Ausgabe-Extraktor

1. Tabellenkalkulationsblatt: Eindeutiger Bezeichner des SpreadSheets, der für die Ausführung der anderen Aufgaben verwendet wird
2. Spreadsheet URL: Die URL des neu erstellten Tabellenblatts

Google SpreadSheet-Daten abrufen

Zweck

Dieser Konnektor holt die Daten aus der angegebenen spreadsheetId innerhalb des angegebenen Bereichs. Die Daten werden als Array von Zeilen oder Spalten geliefert, basierend auf den Abfrageparametern, die an die Konnektorfunktion übergeben werden

Endpunkt

HTTP GET-Aufruf an den Endpunkt -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

Erforderliche Eingabe

Im Folgenden sind die URL-Parameter aufgeführt, die übergeben werden müssen

1. Tabellenkalkulations-Id
2. Bereich - Eine Zeichenfolge im [A1-Format](https://developers.google.com/sheets/api/guides/concepts

a1_notation)

Die zusätzlichen Abfrageparameter, die von den Konnektorfunktionen geliefert werden, sind

1. majorDimension : ROWS oder COLUMNS legt fest, wie das interne Datenfeld aussehen soll
2. dateTimeRenderOption gibt das Format der DateTime-Felder an Standardwert:FORMATTED_STRING
3. valueRenderOption gibt an, ob die Daten in der Antwort formatiert oder unformatiert sein müssen Standardwert: FORMATTED_VALUE

Ausgabe-Extraktor

1. Werte: Dies ist ein Array von Arrays, jede Datenzeile wird ein Array sein.

Google SpreadSheet InsertRow

Zweck

Hängt Werte an ein Tabellenblatt an. Der Eingabebereich wird verwendet, um nach vorhandenen Daten zu suchen und eine "Tabelle" innerhalb dieses Bereichs zu finden. Die Werte werden an die nächste Zeile der Tabelle angehängt, beginnend mit der ersten Spalte der Tabelle. Der Connector nimmt spreadsheetId, Range und die Liste der Werte entgegen, die in die Zellen eingefügt werden sollen.

Endpunkt

HTTP POST-Aufruf an den Endpunkt -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

Erforderliche Eingabe

Im Folgenden sind die Abfrageparameter aufgeführt, die übergeben werden müssen

1. Spreadsheet ID
2. Bereich
3. Werte: Für diesen Konnektor haben wir 8 Spaltenwerte berücksichtigt, wobei jeder Parameter mit der Spalte benannt ist, in die er eingefügt werden soll. Dies wird als Array von Werten an die API übergeben.

Die zusätzlichen Abfrageparameter, die von den Konnektorfunktionen geliefert werden, sind:

1. WertEingabeOption: Dies ist ein Pflichtfeld und wird vom Konnektor gesendet, Standardwert gesetzt: USER_ENTERED

Ausgabe-Extraktor

1. spreadsheetId
2. AktualisierteZeilen: Gibt die Anzahl der Zeilen an, die eingefügt wurden

Google SpreadSheet löschen

Zweck

Löscht Werte aus einer Kalkulationstabelle. Der Aufrufer muss die Tabellenkalkulations-ID und den Bereich angeben. Es werden nur Werte gelöscht - alle anderen Eigenschaften der Zelle (wie Formatierung, Datenüberprüfung usw.) bleiben erhalten. Der Connector nimmt spreadsheetId, Range und die Liste der Werte an, die in die Zellen eingefügt werden sollen.

Endpunkt

HTTP POST-Aufruf an den Endpunkt -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear

Erforderliche Eingabe

Im Folgenden sind die Abfrageparameter aufgeführt, die übergeben werden müssen

1. Arbeitsblatt-ID
2. Bereich

Google Tabellenkalkulationsdetails abrufen nachFilter

Zweck

Dieser Konnektor ruft die Tabellenkalkulationsdetails mit der angegebenen SpreadsheetId und der im Datenfilter angegebenen spezifischen Bedingung ab.

Endpunkt

HTTP POST-Aufruf an den Endpunkt -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getbyDataFilter

Erforderliche Eingabe

Die folgenden Abfrageparameter sind zu übergeben

1. spreadSheetId
2. includeGridData: Standardwert ist False

Die folgenden Parameter werden als Teil des Abfragekörpers im JSON-Format gesendet

1. gridRange

Ausgabe-Extraktoren

1. spreadSheetId
2. Titel
3. Gebietsschema
4. auto recalc
5. timeZone
6. sheetId
7. sheetTitle
8. BlattTyp
9. sheetRowCount
10. sheetColumnCount
11. spreadSheetUrl

Es gibt weitere Parameter, die je nach Anwendungsfall in die Ausgabe einbezogen werden können

Google Batch-Daten abrufen

Zweck

Dieser Konnektor ruft die Daten aus der spreadsheetId ab, die in Die Daten werden als Array von Zeilen oder Spalten basierend auf den Abfrageparametern geliefert, die dem Konnektor übergeben werden

Endpunkt

HTTP GET-Aufruf an den Endpunkt -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

Erforderliche Eingabe

Im Folgenden sind die Abfrageparameter aufgeführt, die übergeben werden müssen

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

a1_notation)

Die zusätzlichen Abfrageparameter, die von den Konnektor-Funktionen geliefert werden, sind

1. majorDimension : ROWS oder COLUMNS bestimmt, wie das interne Datenarray aussehen soll
2. dateTimeRenderOption gibt das Format der DateTime-Felder an Standardwert:FORMATTED_STRING
3. valueRenderOption legt fest, ob die Daten in der Antwort formatiert oder unformatiert sein sollen Standardwert:FORMATTED_VALUE

Ausgabe-Extraktor

1. valueRanges: Dies ist ein Array von Objekten. Jedes Objekt beschreibt einen Bereich

Google Get Batch Data-Filter

Zweck

Dieser Konnektor holt die Daten aus der spreadsheetId, die innerhalb der gegebenen Filterbedingung angegeben wurde, als einen Datenstapel. Die Daten werden als Array von Zeilen oder Spalten geliefert, basierend auf den Abfrageparametern, die dem Konnektor übergeben werden

Endpunkt

HTTP POST Aufruf an den Endpunkt -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter

Erforderliche Eingabe

Im Folgenden sind die Abfrageparameter aufgeführt, die übergeben werden müssen

1. Tabellenblatt-Id

Die zusätzlichen Request Body-Parameter, die von den Connector-Funktionen geliefert werden, sind

1. Datenfilter
2. majorDimension : ROWS oder COLUMNS bestimmt, wie das interne Datenarray aussehen soll
3. dateTimeRenderOption legt das Format der DateTime-Felder fest Standardwert:FORMATTED_STRING
4. valueRenderOption gibt an, ob die Daten in der Antwort formatiert oder unformatiert sein müssen Standardwert: FORMATTED_VALUE

Ausgabe-Extraktor

1. valueRanges: Dies ist ein Array von Objekten. Jedes Objekt beschreibt einen Bereich

Video