Panoramica dell'API Fogli Google

L'API Fogli Google è un'interfaccia RESTful che ti consente di leggere e modificare nel foglio di lavoro. Gli utilizzi più comuni di questa API sono: 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, ciascuno con informazioni strutturate contenute nelle celle. R La risorsa foglio di lavoro rappresenta ogni foglio di lavoro e ha una valore spreadsheetId univoco, contenenti lettere, numeri, trattini o trattini bassi. Puoi trovare ID 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. R La risorsa del foglio rappresenta ogni foglio e ha un titolo univoco e un numero sheetId. Tu possono 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 raggruppati come intervallo di celle. R La risorsa CellData rappresenta ogni cella, ma non ha un valore ID univoco. Invece, riga e le coordinate di colonna identificano le celle.

Notazione A1

Una sintassi utilizzata per definire una cella o un intervallo di celle con una stringa che contiene il nome del foglio più 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", il foglio1 si riferisce all'intervallo denominato e "Foglio1" fa riferimento al foglio.
Notazione R1C1

Una sintassi utilizzata per definire una cella o un intervallo di celle con una stringa che contiene il nome del foglio più le coordinate di inizio e fine della cella utilizzando 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 al posizione.

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 come riferimento in un'applicazione. R La risorsaFilterView rappresenta un intervallo denominato.

Intervallo protetto

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

Passaggi successivi

  • Per saperne di più sullo sviluppo con le API Google Workspace, inclusa la gestione l'autenticazione e l'autorizzazione, consulta Sviluppa su Google Workspace.

  • Per scoprire come configurare ed eseguire una semplice app con l'API Fogli, leggi l'articolo Panoramica delle guide rapide.