Method: spreadsheets.values.batchGet

Muestra uno o más rangos de valores de una hoja de cálculo. El llamador debe especificar el ID de la hoja de cálculo y uno o más rangos.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
spreadsheetId

string

El ID de la hoja de cálculo de la que se recuperarán datos.

Parámetros de consulta

Parámetros
ranges[]

string

La notación A1 o notación R1C1 del rango del que se recuperarán los valores.
majorDimension

enum (Dimension)

Es la dimensión principal que deberían utilizar los resultados.

Por ejemplo, si los datos de la hoja de cálculo son A1=1,B1=2,A2=3,B2=4, la solicitud de ranges=["A1:B2"],majorDimension=ROWS muestra [[1,2],[3,4]], mientras que la solicitud de ranges=["A1:B2"],majorDimension=COLUMNS muestra [[1,3],[2,4]].
valueRenderOption

enum (ValueRenderOption)

Cómo se deben representar los valores en el resultado. La opción de renderización predeterminada es ValueRenderOption.FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

Cómo se deben representar las fechas, horas y duraciones en los resultados. Se ignora si valueRenderOption es FORMATTED_VALUE. La opción predeterminada de renderización de dateTime es SERIAL_NUMBER.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

La respuesta que se obtiene cuando se recuperan más de un rango de valores en una hoja de cálculo.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
Campos
spreadsheetId

string

El ID de la hoja de cálculo desde la que se recuperaron los datos.
valueRanges[]

object (ValueRange)

Los valores solicitados. El orden de los rangos de valores es el mismo que el de los rangos solicitados.

Permisos de autorización

Se necesita uno de los siguientes alcances de 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

Para obtener más información, consulta la Guía de autorización.