Panoramica dell'API Fogli Google (original) (raw)

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. L'API Fogli ti consente di:

• 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 di termini comuni utilizzati nell'API Fogli:

Foglio di lavoro

L'oggetto principale in Fogli Google. Può contenere più Sheets, ciascuno con informazioni strutturate contenute in Cells. La risorsaspreadsheets rappresenta un foglio di lavoro. Contiene un valore spreadsheetIdunico.

ID foglio di lavoro

L'identificatore univoco di un foglio di lavoro. Si tratta di una stringa particolare contenente lettere, numeri e alcuni caratteri speciali che fanno riferimento a un foglio di lavoro e può essere ricavata dall'URL del foglio di lavoro. Gli ID delle schede di lavoro sono stabili, anche se il nome della scheda di lavoro cambia.

https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID

Foglio

Una pagina o una scheda all'interno di un foglio di lavoro. La risorsaSheets rappresenta un foglio. Contiene un valore numerico sheetId e un fogliotitle univoci nell'ambito dell'oggettoSheetProperties.

ID foglio

L'identificatore univoco di un foglio specifico all'interno di un foglio di lavoro. Si tratta di un determinato numero intero contenente numeri che fanno riferimento a un foglio e può essere dedotto dall'URL del foglio di lavoro. Gli ID foglio sono stabili, anche se il nome del foglio cambia. Per un esempio, consulta ID foglio di lavoro.

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. La risorsaCells rappresenta ogni cella, ma non ha un valore ID univoco. Le celle vengono invece identificate dai valori di riga e colonna.

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 delle celle iniziale e finale utilizzando le lettere delle colonne e i numeri di riga. Questo metodo è il più comune e utile quando si fa riferimento a un intervallo di celle assoluto.

• Sheet1!A1:B2 fa riferimento a tutte le celle nelle prime due righe e colonne del foglio 1.
• Sheet1!A:A fa riferimento a tutte le celle della prima colonna del foglio 1.
• Sheet1!1:2 fa riferimento a tutte le celle nelle prime due righe del foglio 1.
• Sheet1!A5:A fa riferimento a tutte le celle della prima colonna del foglio 1, a partire dalla riga 5.
• 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 del foglio 1.
• 'Jon's_Data'!A1:D5 fa riferimento a tutte le celle delle prime cinque righe e delle quattro colonne di un foglio denominato "Dati_di_Giovanni".
• 'My Custom Sheet'!A:A fa riferimento a tutte le celle della prima colonna di un foglio denominato "Il mio foglio personalizzato".
• 'My Custom Sheet' si riferisce a tutte le celle di "Il mio foglio personalizzato".

Le virgolette singole sono obbligatorie per i nomi dei fogli con spazi o caratteri speciali.

Suggerimento: se possibile, utilizza nomi distinti per gli oggetti nei fogli di lavoro. Ad esempio, A1 (senza virgolette) si riferisce alla cella A1 nel primo foglio visibile. 'A1' fa riferimento a un foglio con il nome A1. Analogamente, Foglio1 fa riferimento a un foglio con il nome Foglio1. Tuttavia, se esiste un intervallo denominato denominato "Foglio1 ", Foglio1 fa riferimento all'intervallo denominato e 'Sheet1' 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, oltre ai coordinati delle celle iniziale e finale 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.

• Sheet1!R1C1:R2C2 fa riferimento alle prime due celle nelle due righe superiori del foglio 1.
• R1C1:R2C2 si riferisce alle prime due celle nelle due righe superiori del primo foglio visibile.
• Sheet1!R[3]C[1] si riferisce alla cella 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. UnaFilterViewrisorsa rappresenta un intervallo denominato.

Intervallo protetto

Una cella o un intervallo di celle definito che non può essere modificato. UnaProtectedRangerisorsa rappresenta un intervallo protetto.

• Per scoprire di più sullo sviluppo con le API Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Sviluppare su Google Workspace.
• Per scoprire come configurare ed eseguire un'app API Sheets, prova la guida rapida di JavaScript.

Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.

Ultimo aggiornamento 2025-06-11 UTC.