Panoramica dell'API Fogli Google

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 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. 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 numerico sheetId e un foglio title univoci nell'ambito dell'oggetto SheetProperties.

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.