Letture di base

L'API Google Sheets consente di leggere i valori di 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 spreadsheets.get metodo, ma in genere spreadsheets.values.get o spreadsheets.values.batchGet è più semplice.

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 i valori delle celle.

In questi esempi, il segnaposto SPREADSHEET_ID indica dove devi fornire l'ID del foglio di lavoro, che può essere scoperto dall'URL del foglio di lavoro. Gli intervalli da cui leggere sono specificati utilizzando la notazione A1 nell'URL della richiesta. Un intervallo di esempio è Sheet1!A1:D5.

Dati di origine

Per questi esempi, supponiamo che il foglio di lavoro letto contenga i seguenti dati di origine nel primo foglio ("Sheet1"). Le stringhe nella prima riga sono etichette per le singole colonne. Per visualizzare esempi di come leggere da altri fogli del foglio di lavoro, consulta Notazione A1.

Leggere un singolo intervallo

Il seguente spreadsheets.values.get esempio di codice mostra come leggere i valori dell'intervallo Sheet1!A1:D5 e restituire 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 è costituita da un ValueRange oggetto che descrive i valori dell'intervallo. Il majorDimension campo 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 Sheet1!A1:D3 e restituirli 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 è costituita da un ValueRange oggetto che descrive i valori dell'intervallo. Il majorDimension campo 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 Sheet1!A1:D5 e restituirli nella risposta, ma utilizza le opzioni di rendering per gestire la modalità di restituzione di queste informazioni. L' ValueRenderOptionimpostazione di FORMULA indica che le formule devono essere restituite anziché il valore calcolato, mentre l' DateTimeRenderOption impostazione 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 è costituita da un ValueRange oggetto che descrive i valori dell'intervallo. Il majorDimension campo 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 degli intervalli Sheet1!B:B e Sheet1!D:D e restituirli nella risposta. L' ValueRenderOption impostazione 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 è costituita da un oggetto con l'ID del foglio di lavoro e un array di ValueRange oggetti corrispondenti a ogni intervallo richiesto, elencati nell'ordine in cui sono stati richiesti. Il majorDimension campo 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 degli intervalli nei fogli Sheet1!A1:D5, Products!D1:D100 e Sales!E4:F6 e restituirli nella risposta. L' ValueRenderOption impostazione 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 è costituita da un oggetto con l'ID del foglio di lavoro e un array di ValueRange oggetti corrispondenti a ogni intervallo richiesto, elencati nell'ordine in cui sono stati richiesti. Il majorDimension campo 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": [
        [...],
        [...]
      ]
    }
  ]
}