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 in questa API:

Foglio di lavoro

L'oggetto principale in Fogli Google che può contenere più fogli, ciascuno con informazioni strutturate contenute nelle celle. Un Spreadsheet rappresenta ogni volta foglio di lavoro e ha un indirizzo valore spreadsheetId, 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. Un Sheet rappresenta ogni volta foglio e ha un titolo e un numero Valore 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. Un CellData rappresenta ogni volta ma non ha un valore ID univoco. Riga e colonna, invece, le coordinate 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 a tutte le celle nelle prime due righe e colonne 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 a tutte le celle nelle prime due righe e colonne del primo foglio visibile.
  • Sheet1 fa riferimento a tutte le celle in Foglio1.
  • 'Jon's_Data'!A1:D5 si riferisce a tutte le celle nelle prime cinque righe e a quattro colonne di un foglio denominato "Jon's_Data".
  • 'My Custom Sheet'!A:A si riferisce a tutte le celle nella prima colonna di un foglio denominato "Il mio foglio personalizzato".
  • 'My Custom Sheet' fa riferimento a tutte le celle in "Il mio foglio personalizzato".

Le virgolette singole sono obbligatorie per i nomi dei fogli che includono spazi, caratteri speciali o una combinazione alfanumerica.

Suggerimento: se possibile, utilizza nomi distinti per gli oggetti nei fogli di lavoro. Ad esempio, A1 si riferisce alla cella A1 nel primo foglio visibile, mentre A1 fa riferimento a tutte le celle di un foglio denominato "A1". Analogamente, Sheet1 fa riferimento a tutte le celle in Foglio1. Tuttavia, se esiste un intervallo denominato "Foglio1", Foglio1 si riferisce all'intervallo denominato e Sheet1 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 a un la posizione della 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 come riferimento in un'applicazione. Un FilterView risorsa rappresenta un intervallo denominato.
Intervallo protetto
Una cella o un intervallo di celle definito che non può essere modificato. R ProtectedRange risorsa rappresenta un intervallo protetto.

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

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