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. 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