Panoramica dell'API Google Sheets

L'API Google Fogli è 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à:

  • Crea fogli di lavoro
  • Leggere e scrivere i valori delle celle del foglio di lavoro
  • Aggiorna la formattazione del foglio di lavoro
  • Gestisci Fogli connessi

Di seguito è riportato un elenco dei termini comuni utilizzati nell'API Fogli:

Foglio di lavoro

L'oggetto principale in Fogli Google può contenere più fogli, ciascuno con informazioni strutturate contenute nelle celle. Una risorsa del 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 in un URL di Fogli 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 di foglio rappresenta ogni foglio e ha un titolo e un valore numerico sheetId univoci. Puoi trovare l'ID del foglio in un 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 organizzate 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 più le coordinate di 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.

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.
  • A1:B2 si riferisce alle prime due celle nelle prime due righe del primo foglio visibile.
  • Sheet1 fa riferimento a tutte le celle nel 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 con spazi, caratteri speciali o una combinazione alfanumerica.
  • 'My Custom Sheet' si riferisce 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 in un foglio denominato A1. Allo stesso modo, Foglio1 si riferisce a tutte le celle in Foglio1. Tuttavia, se esiste un intervallo denominato "Foglio1", il 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 più le coordinate di 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 data 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 risorsa FilterView 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