Preparare il foglio di calcolo

Cosa fare in Google Sheets prima di collegare: creare un foglio di calcolo, condividerlo e copiarne il link

Non devi creare un progetto Google Cloud, attivare un'API o scaricare una chiave JSON — l'account di servizio è già configurato lato servizio. Tutto ciò che ti serve fornire è il foglio di calcolo stesso, l'accesso a esso e il suo link.

Passaggio 1. Crea un foglio di calcolo

Apri Google Sheets e crea un nuovo foglio di calcolo — oppure usa quello con cui lavori già. Il nome del foglio di calcolo può essere qualsiasi, il servizio non lo controlla.

Passaggio 2. Copia l'indirizzo dell'account di servizio

L'indirizzo è mostrato nel tuo account — è l'account con cui condividerai il foglio di calcolo.

  1. Apri Accesso API — la voce "Accesso API" nel menu utente (angolo in alto a destra del tuo account).
  2. Trova la scheda "Google Sheets".
  3. Nella riga "Account di servizio", clicca sull'icona di copia accanto all'indirizzo — appare la notifica "Email copiata".
SchermataLa scheda "Google Sheets" nella pagina "Accesso API" nello stato "Non collegato": la riga "Account di servizio" con l'indirizzo e un pulsante per copiare, la riga "Foglio di calcolo" con il valore "Non collegato", e il pulsante "Collega" nell'intestazione della scheda.

Passaggio 3. Condividi il foglio di calcolo con il ruolo "Editor"

  1. Apri il tuo foglio di calcolo nel browser.
  2. Clicca su "Condividi" nell'angolo in alto a destra (in alcune versioni dell'interfaccia Google questa voce si chiama "Impostazioni di condivisione").
  3. Incolla l'indirizzo copiato dell'account di servizio.
  4. Scegli il ruolo "Editor".
  5. Clicca su "Invia".
Il ruolo "Visualizzatore" non è sufficiente: il servizio non si limita a leggere il foglio di calcolo, ci scrive anche i risultati. Finché l'accesso non viene concesso, il foglio di calcolo non esiste affatto per il servizio — il test di connessione risponde "Foglio di calcolo non trovato o non condiviso con l'account di servizio".
Questi stessi cinque passaggi sono sempre a portata di mano nel tuo account: il pulsante "Come?" accanto all'indirizzo dell'account di servizio li apre in una finestra. Il servizio mostra da solo la stessa finestra quando riscontra un accesso mancante.

Passaggio 4. Copia il link del foglio di calcolo

Il link è l'indirizzo del foglio di calcolo aperto, preso dalla barra degli indirizzi del browser:

https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit

Copialo per intero — non serve estrarre l'identificatore dal centro dell'indirizzo, il servizio lo fa da solo.

Il foglio di calcolo è pronto. Avanti — Collegare il foglio di calcolo.