--- title: "Google Sheets Connector" slug: "google-sheets-connector" updated: 2023-11-03T16:41:08Z published: 2023-11-03T16:41:08Z canonical: "support.tulip.co/google-sheets-connector" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Connettore Google Sheets ## Connettore Google Sheets ## Introduzione L'API di Google Sheets consente agli utenti di creare, leggere e modificare i fogli di Google con il giusto accesso impostato sui loro account di Google. L'obiettivo di questo connettore è sfruttare Oauth 2.0 di Tulip per integrarsi con Google Sheets utilizzando i [connettori](https://support.tulip.co/docs/what-are-connectors) HTTP e fornire ai nostri clienti un connettore pronto all'uso che può essere importato nella loro istanza. [Embedded content](https://www.youtube.com/embed/O8ZQMUmo56s) #### Scopo 1. Verranno evidenziate diverse funzioni di connettore HTTP che possono essere costruite effettuando chiamate HTTP agli endpoint delle API di Google Sheets (v4) per interagire con il foglio di calcolo di Google e provare varie azioni di lettura e scrittura sul foglio di calcolo che potrebbero essere sfruttate per vari casi d'uso. #### Documento API 1. [Documento di riferimento API di Google Sheets](https://developers.google.com/sheets/api/reference/rest) #### Prerequisiti 1. Creare un account sulla Console cloud di Google e configurare le credenziali OAuth 2.0. Ulteriori informazioni sono disponibili nei documenti API di Google. 2. Aggiungere l'URL di reindirizzamento delle istanze su Google Cloud Console. #### Dettagli della connessione Tulip Le seguenti informazioni devono essere configurate sui connettori di Tulip. 1. In esecuzione su: Host del connettore cloud 2. Host: sheets.googleapis.com 3. Porta: 443 4. TLS: Sì 5. OAuth 2(Admin): L'autenticazione sarà trasferita a tutte le funzioni del connettore. ## Funzioni del connettore #### Nuovo foglio elettronico di Google #### Scopo 1. Gli utenti possono passare un nome di foglio di calcolo e un nome di foglio come input e Tulip creerà un nuovo foglio di calcolo con il nome del foglio fornito. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà del foglio di calcolo, che possono essere ulteriormente utilizzati come filtri per recuperare e aggiornare i dati dai fogli di calcolo. 2. Le informazioni estratte da Google sheets V4 API possono essere ulteriormente utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip che vengono convogliate in altre funzioni del connettore. #### Punto finale Chiamata HTTP POST all'endpoint **[https://sheets.googleapis.com/v4/spreadsheets](https://sheets.googleapis.com/v4/spreadsheets)**. #### Input richiesti I parametri che vengono inviati come corpo della richiesta sono i seguenti 1. Nome del foglio di calcolo - il titolo del foglio di calcolo 2. Nome foglio - Titolo iniziale del foglio #### Estrattore di output 1. foglio di calcolo: Identificatore univoco dello SpreadSheet che verrà utilizzato per eseguire le altre attività 2. URL del foglio di calcolo: L'URL del foglio di calcolo appena creato. #### #### Google Ottieni dati del foglio di calcolo #### Scopo Questo connettore recupera i dati dallo spreadsheetId fornito entro l'intervallo indicato. I dati saranno forniti come array di righe o colonne in base ai parametri di query forniti alla funzione del connettore. #### Punto finale Chiamata HTTP GET all'endpoint [-https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/valori/{range}](https://sheets.googleapis.com/v4/spreadsheets/%7BspreadsheetId%7D/values/%7Brange%7D) #### Input richiesti I parametri URL da passare sono i seguenti 1. Id del foglio di calcolo 2. Intervallo - Una stringa nel [formato A1](https://developers.google.com/sheets/api/guides/concepts ## a1_notation) I parametri di query aggiuntivi che verranno forniti dalle funzioni del connettore sono 1. majorDimension : ROWS o COLUMNS decide quale debba essere l'array interno di dati 2. dateTimeRenderOption specifica il formato dei campi DateTime Valore predefinito:FORMATTED_STRING 3. valueRenderOption specifica se i dati devono essere formattati o non formattati nella risposta valore predefinito: FORMATTED_VALUE #### Estrattore di output 1. Valori: Si tratta di un array di array, ogni riga di dati sarà un array. #### Foglio elettronico di Google InserisciRiga #### Scopo Aggiunge valori a un foglio di calcolo. L'intervallo di input viene utilizzato per cercare i dati esistenti e trovare una "tabella" all'interno di tale intervallo. I valori saranno aggiunti alla riga successiva della tabella, a partire dalla prima colonna della tabella. Il connettore accetta spreadsheetId, Range e l'elenco dei valori da inserire nelle celle. #### Punto finale Chiamata HTTP POST all'endpoint -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/valori/{range}[:append](https://sheets.googleapis.com/v4/spreadsheets/%7BspreadsheetId%7D/values/%7Brange%7D:append) #### Input richiesti I parametri di query da passare sono i seguenti 1. ID foglio di calcolo 2. Intervallo 3. Valori: per questo connettore, abbiamo considerato 8 valori di colonna con ciascun parametro denominato in base alla colonna che verrà inserita. Questo verrà passato all'API come un array di valori. I parametri di query aggiuntivi che verranno forniti dalle funzioni del connettore sono : 1. valueInputOption: È un campo obbligatorio e sarà inviato dal connettore, valore predefinito: USER_ENTERED #### Estrattore di output 1. foglio di calcoloId 2. Righe aggiornate: Specifica il numero di righe che sono state inserite. #### Cancellazione del foglio di calcolo di Google #### Scopo Cancella i valori da un foglio di calcolo. Il chiamante deve specificare l'ID del foglio di calcolo e l'intervallo. Vengono cancellati solo i valori, mentre tutte le altre proprietà della cella (come la formattazione, la convalida dei dati, ecc.) vengono mantenute. Il connettore accetta l'ID del foglio di calcolo, l'intervallo e l'elenco dei valori da inserire nelle celle. #### Punto finale Chiamata HTTP POST all'endpoint -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/valori/{range}[:clear](https://sheets.googleapis.com/v4/spreadsheets/%7BspreadsheetId%7D/values/%7Brange%7D:clear) #### Input richiesti I parametri di query da passare sono i seguenti 1. ID foglio di calcolo 2. Intervallo #### Google Ottieni dettagli del foglio elettronico per filtro #### Scopo Questo connettore recupera i dettagli del foglio di calcolo con lo spreadsheetId fornito e la condizione specifica specificata nel filtro dei dati. #### Punto finale Chiamata HTTP POST all'endpoint -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}[:getbyDataFilter](https://sheets.googleapis.com/v4/spreadsheets/%7BspreadsheetId%7D:getbyDataFilter) #### Input richiesti I parametri di query da passare sono i seguenti 1. spreadSheetId 2. includeGridData: Il valore predefinito è False I seguenti parametri vengono inviati come parte del corpo della richiesta in formato JSON 1. grigliaCampo #### Estrattori di output 1. spreadSheetId 2. Titolo 3. Locale 4. ricalcolo automatico 5. timeZone 6. ID foglio 7. titolo del foglio 8. tipo di foglio 9. foglioConteggio righe 10. foglioColonna 11. spreadSheetUrl Esistono altri parametri che possono essere inclusi come parte dell'output in base al caso d'uso dell'utente. #### Google Ottieni dati batch #### Scopo Questo connettore recupera i dati dallo spreadsheetId fornito all'interno del connettore. I dati vengono forniti come array di righe o colonne in base ai parametri di query forniti al connettore. #### Punto finale Chiamata HTTP GET all'endpoint [-https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values](https://sheets.googleapis.com/v4/spreadsheets/%7BspreadsheetId%7D/values):batchGet #### Input richiesto I parametri della query da passare sono i seguenti 1. Id del foglio di calcolo 2. Intervallo - Una stringa in [A1Format](https://developers.google.com/sheets/api/guides/concepts ## a1_notation) I parametri di query aggiuntivi che verranno forniti dalle funzioni del connettore sono 1. majorDimension : ROWS o COLUMNS decide quale debba essere l'array interno di dati 2. dateTimeRenderOption specifica il formato dei campi DateTime Valore predefinito:FORMATTED_STRING 3. valueRenderOption specifica se i dati devono essere formattati o non formattati nella risposta Valore predefinito:FORMATTED_VALUE #### Estrattore di output 1. valueRanges: Si tratta di un array di oggetti. Ogni oggetto descrive un intervallo #### Filtro Google Get Batch Data #### Scopo Questo connettore recupera i dati dal foglio di calcoloId fornito all'interno della condizione di filtro data come un batch di dati. I dati saranno forniti come array di righe o colonne in base ai parametri di query forniti al connettore. #### Punto finale Chiamata HTTP POST all'endpoint [-https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values](https://sheets.googleapis.com/v4/spreadsheets/%7BspreadsheetId%7D/values):batchGetByDataFilter #### Input richiesto I parametri di query da passare sono i seguenti 1. Id del foglio di calcolo I parametri aggiuntivi del corpo della richiesta che verranno forniti dalle funzioni del connettore sono 1. Filtri dati 2. majorDimension : ROWS o COLUMNS decide quale debba essere l'array interno di dati 3. dateTimeRenderOption specifica il formato dei campi DateTime Valore predefinito:FORMATTED_STRING 4. valueRenderOption specifica se i dati devono essere formattati o non formattati nella risposta valore predefinito: FORMATTED_VALUE #### Estrattore di output 1. valueRanges: Si tratta di un array di oggetti. Ogni oggetto dettaglia un intervallo #### Video