> For the complete documentation index, see [llms.txt](https://docs.igenius.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.igenius.ai/italiano/crystal-console/topics/connect/tutorial-per-fonti-dati-specifiche/google-sheets.md).

# Connetti Google Sheets

Ora puoi collegare i Google Sheets come fonte di dati nel tuo progetto crystal usando l'account dell'utente Google.

Per configurare Google Sheets come fonte di dati, è necessario abilitare le API di Google Drive e Google Sheets e creare un account di servizio sulla console GCP. Tutti i passi di configurazione richiesti sono spiegati in dettaglio nelle seguenti sezioni di questo articolo.

Iniziamo!

### Google API configuration <a href="#google-api-configuration" id="google-api-configuration"></a>

\
Accedi alla piattaforma Google Cloud e vai alla [console GCP](https://console.cloud.google.com/). Seleziona il relativo progetto GCP e poi nel menu laterale sinistro della console GCP seleziona **APIs and Services** e poi **Library**.

![](/files/eQN27nmGAS39ScAzm9FJ)

Nel menu aperto cerca Google Sheets e seleziona **Google Sheets API**.

![](/files/la9NYlkekPsQWDjgInX9)

Clicca sul pulsante **Enable** per attivare l'API di Google Sheets per il progetto corrente.

![](/files/LEqfjzzjnliYG6iuFel2)

Una volta attivata l'API di Google Sheets, torna alla ricerca, cerca Google Drive e seleziona **Google Drive API.**

![](/files/fboWFCRLE2BNlFdc3gSW)

Clicca su **Enable** per attivare l'API di Google Drive per il progetto corrente.

![](/files/TnrLyxRrCbhfxjGCMd8v)

Ora, quando le API richieste sono abilitate, è necessario creare un account di servizio e collegarlo. Vediamo come si può fare sulla GCP Console.

### Create service account <a href="#create-service-account" id="create-service-account"></a>

Accedi alla [Console GCP](https://console.cloud.google.com/) e assicurati di selezionare il progetto corretto. Dal menu della barra laterale, seleziona **APIs and services** e poi seleziona **Credentials**.

![](/files/zKmjUVCB4liqxlsN61iz)

Dal menu in alto, seleziona **Create Credentials** e poi scegli l'opzione **Service Account**.

![](/files/pGXMKPbS8oApf1p041XB)

Nel modulo aperto compila il **Service account name**, poi clicca su **Create and continue** e continua la configurazione saltando tutti i passi opzionali.

![](/files/DDwHE815hUkLiATvI1h0)

Ora trova **Service Account** che hai appena creato nell'elenco degli account di servizio e apri il suo link.

![](/files/41pKBMjv2flQWR88AmN6)

Poi vai alla scheda **Keys**.

![](/files/RjSTIWu5yAg7iydUouQZ)

Clicca su **Add Key** e poi seleziona **Create new key**.

![](/files/tIt1vUnx6BaHRulHLYRq)

Nel menu aperto seleziona il formato **JSON** e poi clicca su **Create**. Questo scaricherà automaticamente il file dell'account di servizio JSON necessario per la seguente configurazione con crystal.

![](/files/4gPskHN6zqSl04cdkNyZ)

### Data source configuration on crystal Self-Service console <a href="#data-source-configuration-on-crystal-self-service-console" id="data-source-configuration-on-crystal-self-service-console"></a>

Una volta eseguiti i passaggi precedenti su Google Cloud Platform, è il momento di collegare Google Sheets al progetto crystal. Per farlo, apri la console Self-service e clicca su **Data Source Management**.

![](/files/HjY2trkIfCmEVPaAxtDN)

Clicca su **Connect new data source** nella parte inferiore dello schermo e nella sezione aperta scegli **Google Sheets**.

![](/files/70DTxQgjSKUsEUlrk80g)

Per compilare i campi nel menu aperto, avrai bisogno del file dell'account di servizio scaricato in precedenza. Apri il file JSON e metti le informazioni all'interno del modulo, poi clicca su **Test and connect**.

![](/files/GRbfHvb0ruLKCmldtYnN)

Dopo che il datasource è stato collegato con successo, dovrai condividere manualmente i tuoi fogli di Google Sheets con client email dell'account di servizio.

Per farlo, apri ogni foglio di Google Sheets che vuoi collegare al progetto di crystal, clicca su **Share** e inserisci il client email che puoi trovare nel file JSON.

{% hint style="info" %}
Le autorizzazioni "Viewer" sono sufficienti per permettere a crystal di accedere ai fogli di Google Spreadsheets
{% endhint %}

![](/files/EJQQxE8DqU9fTJwc1Lpq)

Una volta fatto, i fogli di Google Spreadsheets che hai condiviso con client email saranno mostrati nella collezione di tabelle nel primo passo della topic creation.

![](/files/GDbCUzr87mCDjB0ygI1T)

### Google Sheets (Autenticazione Oauth) <a href="#google-api-configuration" id="google-api-configuration"></a>

Puoi collegare i tuoi Google Sheets semplicemente effettuando l'accesso con il tuo account Google.

Per farlo, seleziona Google Sheets nel menu **Add new data source**:

![](/files/aH7CNX4BJzld1qAKj6Kj)

Comparirà una nuova finestra con due opzioni: **Manual Authentication** o **Oauth Authentication**. Seleziona la seconda, quindi fai clic su **Next**:

![​](/files/TA6gaOFWP3NbvC3ukm3s)

**Accedi con il tuo account Google** per collegare i tuoi Google Sheets. Verrà visualizzata una nuova finestra che ti consentirà di selezionare sia la **data** (gg/mm/aaa) che le **impostazioni locali** (formato del fuso orario locale).

Potrai anche impostare il **nome della tua datasource**. Quindi, clicca su **Test and connect** per procedere:

![​](/files/GIHX5Wy13BSrbMgUYJ0H)

***
