REST Resource: spreadsheets.values

Recurso: ValueRange

Dados em um intervalo da planilha.

Representação JSON
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Campos
range

string

Intervalo dos valores, em notação A1. Para saída, este intervalo indica todo o intervalo solicitado, mesmo que os valores excluam linhas e colunas à direita. Ao anexar valores, esse campo representa o intervalo a ser pesquisado por uma tabela. Depois disso, os valores serão anexados.

majorDimension

enum (Dimension)

A dimensão principal dos valores.

Para saída, se os dados da planilha forem: A1=1,B1=2,A2=3,B2=4, a solicitação de range=A1:B2,majorDimension=ROWS vai retornar [[1,2],[3,4]], e a solicitação de range=A1:B2,majorDimension=COLUMNS vai retornar [[1,3],[2,4]].

Para entrada, usar range=A1:B2,majorDimension=ROWS e [[1,2],[3,4]] definir A1=1,B1=2,A2=3,B2=4. Com range=A1:B2,majorDimension=COLUMNS, [[1,2],[3,4]] definirá A1=1,B1=3,A2=2,B2=4.

Ao escrever, se esse campo não for definido, o padrão será ROWS.

values[]

array (ListValue format)

Os dados que foram lidos ou gravados. Uma matriz de matrizes. A matriz externa representa todos os dados e cada matriz interna representa uma dimensão principal. Cada item na matriz interna corresponde a uma célula.

Na saída, linhas e colunas vazias à direita não serão incluídas.

Para entrada, os tipos de valor compatíveis são: bool, string e double. Valores nulos serão ignorados. Para definir uma célula com um valor vazio, defina o valor da string como uma string vazia.

Métodos

append

Anexa valores a uma planilha.

batchClear

Limpa um ou mais intervalos de valores de uma planilha.

batchClearByDataFilter

Limpa um ou mais intervalos de valores de uma planilha.

batchGet

Retorna um ou mais intervalos de valores de uma planilha.

batchGetByDataFilter

Retorna um ou mais intervalos de valores que correspondem aos filtros de dados especificados.

batchUpdate

Define valores em um ou mais intervalos de uma planilha.

batchUpdateByDataFilter

Define valores em um ou mais intervalos de uma planilha.

clear

Limpa os valores de uma planilha.

get

Retorna um intervalo de valores de uma planilha.

update

Define valores em um intervalo de uma planilha.