L'API Fogli Google è un'interfaccia RESTful che consente di leggere e modificare i dati di un foglio di lavoro. L'API Fogli 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 Fogli:
- Foglio di lavoro
L'oggetto principale in Fogli Google. Può contenere più
Sheets
, ciascuno con informazioni strutturate contenute inCells
. La risorsaspreadsheets
rappresenta un foglio di lavoro. Contiene un valorespreadsheetId
univoco.- ID foglio di lavoro
- L'identificatore univoco di un foglio di lavoro. Si tratta di una stringa particolare contenente lettere, numeri e alcuni caratteri speciali che fanno riferimento a un foglio di lavoro e può essere ricavata dall'URL del foglio di lavoro. Gli ID delle schede di lavoro sono stabili, anche se il nome della scheda 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 numericosheetId
e un fogliotitle
univoci nell'ambito dell'oggettoSheetProperties
.- ID foglio
- L'identificatore univoco di un foglio specifico all'interno di un foglio di lavoro. È una particolare stringa contenente lettere, numeri e alcuni caratteri speciali che fa riferimento a un foglio e può essere ricavata dall'URL del foglio di lavoro. Gli ID foglio sono stabili, anche se il nome del foglio cambia. Ad esempio, consulta ID foglio di lavoro.
- 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. La risorsa
Cells
rappresenta ogni cella, ma non ha un valore ID univoco. Le celle vengono invece identificate dalle coordinate di riga e colonna.- Notazione A1
- Una 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, usando lettere di colonna e numeri di riga. Questo metodo è il più comune e utile quando si fa riferimento a un intervallo di celle assoluto.
Mostra esempi
Sheet1!A1:B2
fa riferimento a tutte le celle nelle prime due righe e colonne del foglio 1.Sheet1!A:A
fa riferimento a tutte le celle nella prima colonna di Foglio1.Sheet1!1:2
fa riferimento a tutte le celle nelle prime due righe del foglio 1.Sheet1!A5:A
fa riferimento a tutte le celle della prima colonna del foglio 1, a partire dalla riga 5.A1:B2
fa riferimento a tutte le celle nelle prime due righe e colonne del primo foglio visibile.Sheet1
fa riferimento a tutte le celle del foglio 1.'Jon's_Data'!A1:D5
fa riferimento a tutte le celle delle prime cinque righe e delle quattro colonne di un foglio denominato "Dati_di_Giovanni".'My Custom Sheet'!A:A
fa riferimento 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, caratteri speciali o una combinazione alfanumerica.
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. Analogamente, Foglio1 fa riferimento a un foglio con il nome Foglio1. Tuttavia, se esiste un intervallo denominato 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 contenente il nome del foglio e le coordinate di inizio e fine della cella, usando 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
fa riferimento alle prime due celle nelle due righe superiori del foglio 1.R1C1:R2C2
si riferisce alle prime due celle nelle due righe superiori del primo foglio visibile.Sheet1!R[3]C[1]
si riferisce alla cella 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
FilterView
risorsa 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.
Argomenti correlati
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 un'app con l'API Fogli, prova la guida rapida di JavaScript.