Letture di base

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 erano 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 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": [
        [...],
        [...]
      ]
    }
  ]
}