Method: spreadsheets.values.batchGet

Restituisce uno o più intervalli di valori da un foglio di lavoro. Il chiamante deve specificare l'ID del foglio di lavoro e uno o più intervalli.

Richiesta HTTP

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
spreadsheetId

string

L'ID del foglio di lavoro da cui recuperare i dati.

Parametri di query

Parametri
ranges[]

string

La notazione A1 o R1C1 dell'intervallo da cui recuperare i valori.

majorDimension

enum (Dimension)

La dimensione principale che i risultati dovrebbero utilizzare.

Ad esempio, se i dati del foglio di lavoro sono A1=1,B1=2,A2=3,B2=4, la richiesta di ranges=["A1:B2"],majorDimension=ROWS restituisce [[1,2],[3,4]], mentre la richiesta di ranges=["A1:B2"],majorDimension=COLUMNS restituisce [[1,3],[2,4]].

valueRenderOption

enum (ValueRenderOption)

Modalità di rappresentazione dei valori nell'output. L'opzione di rendering predefinita è ValueRenderOption.FORMATTED_VALUE.

dateTimeRenderOption

enum (DateTimeRenderOption)

Il modo in cui date, ore e durate devono essere rappresentate nell'output. Questo valore viene ignorato se valueRenderOption è FORMATTED_VALUE. L'opzione di rendering predefinita per dateTime è SERIAL_NUMBER.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

La risposta quando si recuperano più intervalli di valori in un foglio di lavoro.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
Campi
spreadsheetId

string

L'ID del foglio di lavoro da cui sono stati recuperati i dati.

valueRanges[]

object (ValueRange)

I valori richiesti. L'ordine degli intervalli di valori è uguale all'ordine degli intervalli richiesti.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.