L'API Google Sheets consente di leggere i valori da celle, intervalli, insiemi di intervalli e interi fogli. Gli esempi in questa pagina illustrano alcune operazioni di lettura comuni con la risorsa spreadsheets.values
. Puoi anche leggere i valori delle celle utilizzando il metodo
spreadsheets.get
, ma solitamente
spreadsheets.values.get
o
spreadsheets.values.batchGet
è più facile.
Questi esempi sono presentati sotto forma di richieste HTTP per essere indipendenti dalla lingua. Per scoprire come implementare le letture in lingue diverse utilizzando le librerie client delle API di Google, consulta Leggere e scrivere valori delle celle.
In questi esempi, il segnaposto SPREADSHEET_ID indica dove fornire l'ID del foglio di lavoro, che può essere rilevato dall'URL del foglio di lavoro. Gli intervalli da leggere sono specificati utilizzando la notazione A1 nell'URL della richiesta. Un intervallo di esempio è Foglio1!A1:D5.
Dati di origine
Per questi esempi, supponiamo che il foglio di lavoro letto contenga i seguenti dati di origine nel primo foglio ("Foglio1"). Le stringhe nella prima riga sono le etichette per le singole colonne. Per visualizzare esempi di lettura da altri fogli del foglio di lavoro, consulta la notazione A1.
A | B | C | D | |
1 | Elemento | Costo | Disponibile | Data di spedizione |
2 | Ruota | 20,50 $ | 4 | 1/3/2016 |
3 | Porta | 15 $ | 2 | 15/03/2016 |
4 | Motore | 100 $ | 1 | 20/03/2016 |
5 | Totali | 135,5 $ | 7 | 20/03/2016 |
Leggere un singolo intervallo
Il seguente
spreadsheets.values.get
esempio di codice mostra come leggere i valori dell'intervallo Foglio1!A1:D5 e restituirli
nella risposta. Le righe e le colonne finali vuote vengono omesse.
Il protocollo di richiesta è mostrato qui.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5
La risposta è costituita da un oggetto
ValueRange
che descrive i valori dell'intervallo. Il
campo
majorDimension
indica che gli array sono elenchi di valori organizzati per righe.
{ "range": "Sheet1!A1:D5", "majorDimension": "ROWS", "values": [ ["Item", "Cost", "Stocked", "Ship Date"], ["Wheel", "$20.50", "4", "3/1/2016"], ["Door", "$15", "2", "3/15/2016"], ["Engine", "$100", "1", "30/20/2016"], ["Totals", "$135.5", "7", "3/20/2016"] ], }
Leggere un singolo intervallo raggruppato per colonna
Il seguente
spreadsheets.values.get
esempio di codice mostra come leggere i valori dell'intervallo Foglio1!A1:D3 e restituirli
nella risposta, ma raggruppati per colonna. Le righe e le colonne finali vuote vengono omesse.
Il protocollo di richiesta è mostrato qui.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS
La risposta è costituita da un oggetto
ValueRange
che descrive i valori dell'intervallo. Il campo
majorDimension
indica che gli array sono elenchi di valori organizzati per colonne.
{ "range": "Sheet1!A1:D3", "majorDimension": "COLUMNS", "values": [ ["Item", "Wheel", "Door"], ["Cost", "$20.50", "$15"], ["Stocked", "4", "2"], ["Ship Date", "3/1/2016", "3/15/2016"] ], }
Leggere un singolo intervallo con opzioni di rendering
Il seguente
spreadsheets.values.get
esempio di codice mostra come leggere i valori dell'intervallo Foglio1!A1:D5 e restituirli
nella risposta, ma utilizza le opzioni di rendering per gestire il modo in cui queste informazioni
vengono restituite. L'impostazione ValueRenderOption
di FORMULA
indica che le formule devono essere restituite anziché il valore calcolato, mentre l'impostazione DateTimeRenderOption
di SERIAL_NUMBER
indica che le date devono essere restituite come numeri.
Sono possibili anche altre impostazioni. Le righe e le colonne finali vuote vengono omesse.
Il protocollo di richiesta è mostrato qui.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5? valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER
La risposta è costituita da un oggetto
ValueRange
che descrive i valori dell'intervallo. Il
campo
majorDimension
indica che gli array sono elenchi di valori organizzati per righe.
{ "range": "Sheet1!A1:D5", "majorDimension": "ROWS", "values": [ ["Item", "Cost", "Stocked", "Ship Date"], ["Wheel", "$20.50", "4", "42430"], ["Door", "$15", "2", "42444"], ["Engine", "$100", "1", "42449"], ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"] ], }
Leggere più intervalli
Il seguente
spreadsheets.values.batchGet
esempio di codice mostra come leggere i valori dagli intervalli Foglio1!B:B e Foglio1!D:D e
li restituisce nella risposta. L'impostazione ValueRenderOption
di UNFORMATTED_VALUE
indica che i valori vengono calcolati, ma non formattati nella risposta. Le righe e le colonne finali vuote vengono omesse.
Il protocollo di richiesta è mostrato qui.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet? ranges=Sheet1!B:B&ranges=Sheet1!D:D&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
La risposta a questa chiamata di metodo è costituita da un oggetto con l'ID del foglio di lavoro e da un array di oggetti ValueRange
corrispondenti a ogni intervallo richiesto, elencati nell'ordine in cui sono stati richiesti. Il campo
majorDimension
indica che gli array sono elenchi di valori organizzati per colonne. Ad esempio:
{ "spreadsheetId": SPREADSHEET_ID, "valueRanges": [ { "range": "Sheet1!B1:B1000", "majorDimension": "COLUMNS", "values": [ ["Cost",20.5,15,100,135.5] ] }, { "range": "Sheet1!D1:D1000", "majorDimension": "COLUMNS", "values": [ ["Ship Date",42430,42444,42449,42449] ]s } ] }
Leggere più intervalli in più fogli
Il seguente
spreadsheets.values.batchGet
esempio di codice mostra come leggere i valori dagli intervalli dei fogli Foglio1!A1:D5,
Prodotti!D1:D100 e Vendite!E4:F6 e restituirli nella risposta. L'impostazione ValueRenderOption
di UNFORMATTED_VALUE
indica che i valori vengono calcolati, ma non formattati nella risposta. Le righe e le colonne finali vuote vengono omesse.
Il protocollo di richiesta è mostrato qui.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet? ranges=Sheet1!A1:D5&ranges=Products!D1:D100&ranges=Sales!E4:F6&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
La risposta a questa chiamata di metodo è costituita da un oggetto con l'ID del foglio di lavoro e da un array di oggetti ValueRange
corrispondenti a ogni intervallo richiesto, elencati nell'ordine in cui sono stati richiesti. Il campo
majorDimension
indica che gli array sono elenchi di valori organizzati per colonne. Ad esempio:
{ "spreadsheetId": SPREADSHEET_ID, "valueRanges": [ { "range": "Sheet1!A1:D5", "majorDimension": "COLUMNS", "values": [ [...], [...] ] }, { "range": "Products!D1:D100", "majorDimension": "COLUMNS", "values": [ [...] ] }, { "range": "Sales!E4:F6", "majorDimension": "COLUMNS", "values": [ [...], [...] ] } ] }