Method: spreadsheets.values.get

Muestra un rango de valores de una hoja de cálculo. El llamador debe especificar el ID de la hoja de cálculo y un rango.

Solicitud HTTP

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

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.

range

string

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

Parámetros de consulta

Parámetros
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 en Hojas de cálculo 1 son A1=1,B1=2,A2=3,B2=4, la solicitud de range=Sheet1!A1:B2?majorDimension=ROWS muestra [[1,2],[3,4]], mientras que la solicitud de range=Sheet1!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 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

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ValueRange.

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.