L'API Fogli Google consente di leggere 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 di solito spreadsheets.values.get o spreadsheets.values.batchGet è più semplice.
Questi esempi sono presentati sotto forma di richieste HTTP per essere neutrali dal linguaggio. Per scoprire come implementare le letture in diversi linguaggi utilizzando le librerie client delle API di Google, consulta Lettura e scrittura di valori delle celle.
In questi esempi, il segnaposto SPREADSHEET_ID indica dove dovresti 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 etichette per le singole colonne. Per visualizzare esempi di lettura da altri fogli nel foglio di lavoro, vedi la notazione A1.
| R | B | C | D | |
| 1 | Elemento | Costo | A disposizione | Data di spedizione |
| 2 | Ruota | 20,50 $ | 4 | 1/03/2016 |
| 3 | Porta | 15 HKD | 2 | 15/03/2016 |
| 4 | Engine | 100 $ | 1 | 20/03/2016 |
| 5 | Totali | 135,5 $ | 7 | 20/03/2016 |
Leggi un singolo intervallo
Il seguente esempio di codice di spreadsheets.values.get mostra come leggere i valori dall'intervallo Sheet1!A1:D5 e li restituisce nella risposta. Le righe e le colonne finali vuote vengono omesse.
Il protocollo della richiesta viene mostrato qui.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5
La risposta è composta 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"]
],
}
Leggi un singolo intervallo raggruppato per colonna
Il seguente esempio di codice di spreadsheets.values.get mostra come leggere i valori dall'intervallo Fogli1!A1:D3 e li restituisce nella risposta, ma raggruppati per colonna. Le righe e le colonne finali vuote
vengono omesse.
Il protocollo della richiesta viene mostrato qui.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS
La risposta è composta da un oggetto ValueRange che descrive i valori dell'intervallo. Il campo majorDimension indica che gli array sono elenchi di valori organizzati in 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"]
],
}
Leggi un singolo intervallo con opzioni di rendering
Il seguente esempio di codice di spreadsheets.values.get mostra come leggere i valori dall'intervallo Sheet1!A1:D5 e li restituisce nella risposta, ma utilizza le opzioni di rendering per gestire il modo in cui vengono restituite queste informazioni. L'impostazione
ValueRenderOption
di FORMULA indica che devono essere restituite le formule invece del
valore calcolato e 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 della richiesta viene mostrato qui.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5?
valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER
La risposta è composta 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)"]
],
}
Lettura di più intervalli
Il seguente esempio di codice di spreadsheets.values.batchGet mostra come leggere i valori degli intervalli Fogli1!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 della richiesta viene 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 al metodo è composta da un oggetto con l'ID del foglio di lavoro e un array di oggetti ValueRange corrispondenti a ciascun intervallo richiesto, elencati nell'ordine in cui sono stati richiesti. Il campo majorDimension indica che gli array sono elenchi di valori organizzati in 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 su più fogli
Il seguente esempio di codice di spreadsheets.values.batchGet mostra come leggere i valori degli intervalli nei fogli Fogli1!A1:D5, Prodotti!D1:D100 e Sales!E4:F6 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 della richiesta viene 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 al metodo è composta da un oggetto con l'ID del foglio di lavoro e un array di oggetti ValueRange corrispondenti a ciascun intervallo richiesto, elencati nell'ordine in cui sono stati richiesti. Il campo majorDimension indica che gli array sono elenchi di valori organizzati in 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": [
[...],
[...]
]
}
]
}