L'API Fogli Google ti consente di leggere i valori di celle, intervalli, insiemi di intervalli
e fogli interi. Gli esempi in questa pagina illustrano alcuni argomenti di lettura comuni
operazioni con
spreadsheets.values
risorsa. Puoi anche leggere i valori delle celle utilizzando
spreadsheets.get
, ma
di solito
spreadsheets.values.get
o
spreadsheets.values.batchGet
è più facile.
Questi esempi sono presentati sotto forma di richieste HTTP per neutri. Per scoprire come implementare le letture in diverse lingue utilizzando lo strumento Librerie client API, consulta Read & scrivi cella personalizzati.
In questi esempi, il segnaposto SPREADSHEET_ID indica dove fornire l'ID foglio di lavoro, che possono essere scoperte dall'URL del foglio di lavoro. Gli intervalli di lettura sono specificato utilizzando la notazione A1 nella richiesta URL. Un intervallo di esempio è Foglio1!A1:D5.
Dati di origine
Per questi esempi, supponiamo che il foglio di lavoro da leggere abbia la seguente 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 in del foglio di lavoro, vedi la notazione A1.
A | B | C | D | |
1 | Elemento | Costo | Disponibile | Data di spedizione |
2 | Ruota | 20,50 € | 4 | 1/03/2016 |
3 | Porta | 15 $ | 2 | 15/03/2016 |
4 | Motore | 100 $ | 1 | 20/03/2016 |
5 | Totali | 135,5 $ | 7 | 20/03/2016 |
Leggi un singolo intervallo
Le seguenti
spreadsheets.values.get
esempio di codice mostra come leggere i valori dall'intervallo Sheet1!A1:D5 e 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
ValueRange
che descrive i valori dell'intervallo. La
Campo majorDimension
indica che le matrici 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
Le seguenti
spreadsheets.values.get
esempio di codice mostra come leggere i valori dall'intervallo Sheet1!A1:D3 e restituisce
nella risposta, ma raggruppati per colonna. Le righe e le colonne finali vuote sono
omesso.
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
ValueRange
che descrive i valori dell'intervallo. La
Campo majorDimension
indica che le matrici 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
Le seguenti
spreadsheets.values.get
esempio di codice mostra come leggere i valori dall'intervallo Sheet1!A1:D5 e restituisce
nella risposta, ma usa le opzioni di rendering per gestire il modo in cui
viene restituito. La
Impostazione ValueRenderOption
di FORMULA
indica che è necessario restituire le formule al posto del
calcolato e i valori
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 sono
omesso.
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
ValueRange
che descrive i valori dell'intervallo. La
Campo majorDimension
indica che le matrici 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
Le seguenti
spreadsheets.values.batchGet
esempio di codice mostra come leggere i valori dagli intervalli Sheet1!B:B e Sheet1!D:D e
lo restituisce nella risposta. La
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 è composta da un oggetto con l'ID foglio di lavoro
e un array di
ValueRange
oggetti corrispondenti a ciascun intervallo richiesto, elencati nell'ordine in cui sono
richiesto. La
Campo majorDimension
indica che le matrici 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
Le seguenti
spreadsheets.values.batchGet
un esempio di codice mostra come leggere i valori da intervalli nei fogli Sheet1!A1:D5,
Products!D1:D100 e Sales!E4:F6 e le restituisce nella risposta. La
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 è composta da un oggetto con l'ID foglio di lavoro
e un array di
ValueRange
oggetti corrispondenti a ciascun intervallo richiesto, elencati nell'ordine in cui sono
richiesto. La
Campo majorDimension
indica che le matrici 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": [ [...], [...] ] } ] }