L'API Fogli Google consente di leggere i valori di celle, intervalli, set 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 indipendenti dal linguaggio. Per scoprire come implementare le letture in diversi linguaggi utilizzando le librerie client dell'API di Google, consulta Lettura e scrittura dei valori delle celle.
In questi esempi, il segnaposto SPREADSHEET_ID indica dove forniresti l'ID del foglio di lavoro, che può essere rilevato dall'URL del foglio di lavoro. Gli intervalli di lettura 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 da leggere abbia i seguenti dati di origine nel primo foglio ("Foglio1"). Le stringhe nella prima riga sono etichette per le singole colonne. Per visualizzare esempi di come leggere da altri fogli nel tuo foglio di lavoro, vedi notazione A1.
| A | B | C | G | |
| 1 | Articolo | Costo | Disponibile | 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 spreadsheets.values.get mostra come leggere i valori dell'intervallo Sheet1!A1:D5 e li restituisce nella risposta. Le righe e le colonne finali vuote vengono omesse.
Il protocollo della richiesta è 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 spreadsheets.values.get mostra come leggere i valori dall'intervallo Sheet1!A1:D3 e li restituisce nella risposta, ma raggruppati per colonna. Le righe e le colonne finali vuote
vengono omesse.
Il protocollo della richiesta è 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 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"]
],
}
Leggi un singolo intervallo con le opzioni di rendering
Il seguente esempio di codice 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 la modalità di restituzione di queste informazioni. L'impostazione ValueRenderOption di FORMULA indica che è necessario restituire le formule al posto 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 è 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)"]
],
}
Leggi più intervalli
Il seguente esempio di codice per spreadsheets.values.batchGet mostra come leggere i valori dagli intervalli Sheet1!B:B e Sheet1!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 è 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 consiste in un oggetto con l'ID 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 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
}
]
}
Legge più intervalli su più fogli
Il seguente esempio di codice spreadsheets.values.batchGet mostra come leggere i valori dagli intervalli nei fogli Fogli1!A1:D5, Prodotti!D1:D100 e Vendite!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 è 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 consiste in un oggetto con l'ID 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 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": [
[...],
[...]
]
}
]
}