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 los 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 se debe usar en los resultados.

Por ejemplo, si los datos de la hoja de cálculo de la Hoja1 son A1=1,B1=2,A2=3,B2=4, la solicitud de range=Sheet1!A1:B2?majorDimension=ROWS mostrará [[1,2],[3,4]], mientras que la de range=Sheet1!A1:B2?majorDimension=COLUMNS mostrará [[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, las horas y las duraciones en el resultado Se ignora si valueRenderOption es FORMATTED_VALUE. La opción de renderización predeterminada 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.

Alcances 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.