REST Resource: spreadsheets.values

Recurso: ValueRange

Datos dentro de un rango de la hoja de cálculo.

Representación JSON
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Campos
range

string

Es el rango que abarcan los valores, en notación A1. Para la salida, este rango indica todo el rango solicitado, aunque los valores excluirán las filas y columnas finales. Cuando se agregan valores, este campo representa el rango para buscar una tabla, después del cual se agregan valores.

majorDimension

enum (Dimension)

Es la dimensión principal de los valores.

Para el resultado, si los datos de la hoja de cálculo son: A1=1,B1=2,A2=3,B2=4, la solicitud de range=A1:B2,majorDimension=ROWS mostrará [[1,2],[3,4]], mientras que la solicitud de range=A1:B2,majorDimension=COLUMNS mostrará [[1,3],[2,4]].

Para la entrada, con range=A1:B2,majorDimension=ROWS, [[1,2],[3,4]] establecerá A1=1,B1=2,A2=3,B2=4. Con range=A1:B2,majorDimension=COLUMNS, [[1,2],[3,4]] establecerá A1=1,B1=3,A2=2,B2=4.

Cuando se escribe, si este campo no está configurado, el valor predeterminado es ROWS.

values[]

array (ListValue format)

Los datos que se leyeron o se escribieron. Se trata de un array de arrays; el externo representa todos los datos y cada interno representa una dimensión principal. Cada elemento de la matriz interna corresponde a una celda.

En el resultado, no se incluirán filas y columnas finales vacías.

Para la entrada, los tipos de valores admitidos son: bool, string y double. Se omitirán los valores nulos. Para establecer un valor vacío en una celda, establece el valor de string en una string vacía.

Métodos

append

Agrega valores a una hoja de cálculo.

batchClear

Borra uno o más rangos de valores de una hoja de cálculo.

batchClearByDataFilter

Borra uno o más rangos de valores de una hoja de cálculo.

batchGet

Muestra uno o más rangos de valores de una hoja de cálculo.

batchGetByDataFilter

Muestra uno o más rangos de valores que coinciden con los filtros de datos especificados.

batchUpdate

Establece valores en uno o más rangos de una hoja de cálculo.

batchUpdateByDataFilter

Establece valores en uno o más rangos de una hoja de cálculo.

clear

Borra los valores de una hoja de cálculo.

get

Muestra un rango de valores de una hoja de cálculo.

update

Establece valores en un rango de una hoja de cálculo.