Panoramica dell'API Fogli Google

L'API Google Sheets è un'interfaccia RESTful che consente di leggere e modificare i dati di un foglio di lavoro. L'API Sheets ti consente di:

  • Creare fogli di lavoro
  • Leggere e scrivere i valori delle celle del foglio di lavoro
  • Aggiornare la formattazione del foglio di lavoro
  • Gestire Fogli connessi

Di seguito è riportato un elenco di termini comuni utilizzati nell'API Sheets:

Foglio di lavoro

L'oggetto principale in Fogli Google. Può contenere più Sheets, ognuno con informazioni strutturate contenute in Cells. La risorsa spreadsheets rappresenta un foglio di lavoro. Contiene un valore spreadsheetId univoco.

ID foglio di lavoro
L'identificatore univoco di un foglio di lavoro. È una stringa particolare che contiene lettere, numeri e alcuni caratteri speciali che fanno riferimento a un foglio di lavoro e può essere derivata dall'URL del foglio di lavoro. Gli ID foglio di lavoro sono stabili, anche se il nome del foglio di lavoro cambia.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
Foglio

Una pagina o una scheda all'interno di un foglio di lavoro. La risorsa Sheets rappresenta un foglio. Contiene un valore numerico univoco sheetId e un foglio title come parte dell'oggetto SheetProperties.

ID foglio
L'identificatore univoco di un foglio specifico all'interno di un foglio di lavoro. Si tratta di un numero intero particolare contenente numeri che fanno riferimento a un foglio e può essere derivato dall'URL del foglio di lavoro. Gli ID foglio sono stabili, anche se il nome del foglio cambia. Per un esempio, vedi ID foglio di lavoro.
Cell

Un singolo campo di testo o dati all'interno di un foglio. Le celle sono disposte in righe e colonne e possono essere raggruppate come intervallo di celle. La risorsa Cells rappresenta ogni cella, ma non ha un valore ID univoco. Invece, le coordinate di riga e colonna identificano le celle.

Notazione A1
Una sintassi utilizzata per definire una cella o un intervallo di celle con una stringa che contiene il nome del foglio più le coordinate della cella iniziale e finale utilizzando lettere di colonna e numeri di riga. Questo metodo è il più comune e utile quando si fa riferimento a un intervallo assoluto di celle.
  • Sheet1!A1:B2 si riferisce a tutte le celle delle prime due righe e colonne di Foglio1.
  • Sheet1!A:A si riferisce a tutte le celle della prima colonna del Foglio1.
  • Sheet1!1:2 si riferisce a tutte le celle delle prime due righe del Foglio1.
  • Sheet1!A5:A si riferisce a tutte le celle della prima colonna del Foglio 1, dalla riga 5 in poi.
  • A1:B2 si riferisce a tutte le celle delle prime due righe e colonne del primo foglio visibile.
  • Sheet1 si riferisce a tutte le celle del Foglio1.
  • 'Jon's_Data'!A1:D5 si riferisce a tutte le celle delle prime cinque righe e quattro colonne di un foglio denominato "Dati_di_Giovanni".
  • 'My Custom Sheet'!A:A si riferisce a tutte le celle della prima colonna di un foglio denominato "Il mio foglio personalizzato".
  • 'My Custom Sheet' si riferisce a tutte le celle di "Il mio foglio personalizzato".

Le virgolette singole sono obbligatorie per i nomi dei fogli con spazi o caratteri speciali.

Suggerimento: se possibile, utilizza nomi distinti per gli oggetti nei fogli di lavoro. Ad esempio, A1 (senza virgolette) si riferisce alla cella A1 nel primo foglio visibile. 'A1' fa riferimento a un foglio con il nome A1. Allo stesso modo, Foglio1 si riferisce a un foglio con il nome Foglio1. Tuttavia, se esiste un intervallo denominato "Foglio1 ", Foglio1 fa riferimento all'intervallo denominato e 'Sheet1' fa riferimento al foglio.

Notazione R1C1
Una sintassi utilizzata per definire una cella o un intervallo di celle con una stringa che contiene il nome del foglio più le coordinate della cella iniziale e finale utilizzando numeri di riga e numeri di colonna. Questo metodo è meno comune della notazione A1, ma può essere utile quando si fa riferimento a un intervallo di celle rispetto alla posizione di una determinata cella.
  • Sheet1!R1C1:R2C2 si riferisce alle prime due celle delle prime due righe del Foglio1.
  • R1C1:R2C2 si riferisce alle prime due celle delle prime due righe del primo foglio visibile.
  • Sheet1!R[3]C[1] si riferisce alla cella che si trova tre righe sotto e una colonna a destra della cella corrente.
Intervallo denominato
Una cella o un intervallo di celle definito con un nome personalizzato per semplificare i riferimenti in un'applicazione. Una risorsa FilterView rappresenta un intervallo denominato.
Intervallo protetto
Una cella o un intervallo di celle definiti che non possono essere modificati. Una risorsa ProtectedRange rappresenta un intervallo protetto.

  • Per scoprire di più sullo sviluppo con le API Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta la sezione Sviluppare su Google Workspace.

  • Per scoprire come configurare ed eseguire un'app API Google Sheets, prova la guida rapida JavaScript.