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:

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.

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.

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.

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.