L'API Fogli Google è un'interfaccia RESTful che consente di leggere e modificare i dati di un foglio di lavoro. Gli utilizzi più comuni di questa API includono le seguenti attività:
- 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 dei termini comuni utilizzati nell'API Fogli:
- Foglio di lavoro
L'oggetto principale in Fogli Google che può contenere più fogli, ognuno con informazioni strutturate contenute nelle celle. Una risorsa foglio di lavoro rappresenta ogni foglio di lavoro e ha un valore
spreadsheetId
univoco contenente lettere, numeri, trattini o trattini bassi. Puoi trovare l'ID del foglio di lavoro nell'URL di un foglio Google:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
- Foglio
Una pagina o una scheda all'interno di un foglio di lavoro. Una risorsa del foglio rappresenta ogni foglio e ha un titolo e un valore numerico univoci
sheetId
. Puoi trovare l'ID foglio nell'URL di Fogli Google:https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
- Cella
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. Una risorsa CellData rappresenta ogni cella, ma non ha un valore ID univoco. Invece, le coordinate di riga e colonna identificano le celle.
- Notazione A1
Sintassi utilizzata per definire una cella o un intervallo di celle con una stringa contenente il nome del foglio e le coordinate di inizio e fine della cella, 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.
Mostra esempi
Sheet1!A1:B2
si riferisce alle prime due celle nelle prime due righe di Foglio1.Sheet1!A:A
si riferisce a tutte le celle nella prima colonna di Foglio1.Sheet1!1:2
si riferisce a tutte le celle nelle prime due righe di Foglio1.Sheet1!A5:A
si riferisce a tutte le celle della prima colonna del foglio 1, a partire dalla riga 5 in poi.A1:B2
si riferisce alle prime due celle nelle prime due righe del primo foglio visibile.Sheet1
fa riferimento a tutte le celle in Foglio1.'My Custom Sheet'!A:A
si riferisce a tutte le celle nella prima colonna di un foglio denominato "Il mio foglio personalizzato". Le virgolette singole sono obbligatorie per i nomi dei fogli che includono spazi, caratteri speciali o una combinazione alfanumerica.'My Custom Sheet'
fa riferimento a tutte le celle in "Il mio foglio personalizzato".
Suggerimento: se possibile, utilizza nomi distinti per gli oggetti all'interno dei fogli di lavoro. Ad esempio, A1 si riferisce alla cella A1 nel primo foglio visibile, mentre "A1" si riferisce a tutte le celle di un foglio denominato A1. Allo stesso modo, Foglio1 fa riferimento a tutte le celle in Foglio1. Tuttavia, se esiste un intervallo denominato "Foglio1", "Foglio1" si riferisce all'intervallo denominato e "Foglio1" si riferisce al foglio.
- Notazione R1C1
Sintassi utilizzata per definire una cella o un intervallo di celle con una stringa contenente il nome del foglio e le coordinate di inizio e fine della cella utilizzando i numeri di riga e 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.
Mostra esempi
Sheet1!R1C1:R2C2
si riferisce alle prime due celle nelle prime due righe di Foglio1.R1C1:R2C2
si riferisce alle prime due celle nelle 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 risorsaFilterView rappresenta un intervallo denominato.
- Intervallo protetto
Una cella o un intervallo di celle definito che non può essere modificato. Una risorsa ProtectedRange rappresenta un intervallo protetto.
Passaggi successivi
Per informazioni sullo sviluppo con le API di Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Sviluppare su Google Workspace.
Per scoprire come configurare ed eseguire una semplice app dell'API Fogli, leggi la panoramica delle guide rapide.