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 dei fogli di lavoro
  • Aggiorna 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, ciascuno con informazioni strutturate all'interno di 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 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 disposte in righe e colonne e possono essere raggruppate come intervalli. 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 iniziale e finale della cella mediante lettere di colonna e numeri di riga. Questo è il metodo 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 fa riferimento 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 fa riferimento 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 si riferisce a tutte le celle in Foglio1.
  • 'My Custom Sheet'!A:A fa riferimento 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' 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 del foglio. 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 iniziale e finale della cella mediante 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 FiltroView rappresenta un intervallo denominato.

Intervallo protetto

Una cella definita o un intervallo di celle che non può essere modificato. Una risorsa ProtectedRange rappresenta un intervallo protetto.

Passaggi successivi

  • Per scoprire di più sullo sviluppo con le API di Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta la pagina Sviluppare su Google Workspace.

  • Per scoprire come configurare ed eseguire una semplice app dell'API Fogli, leggi la panoramica delle guide rapide.