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

O intervalo que os valores abrangem, na notação A1. Para a saída, esse intervalo indica todo o intervalo solicitado, mesmo que os valores excluam as linhas e colunas finais. Ao anexar valores, esse campo representa o intervalo para pesquisar uma tabela, após a qual 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 retornará [[1,2],[3,4]], enquanto a solicitação de range=A1:B2,majorDimension=COLUMNS retornará [[1,3],[2,4]].

Para a entrada, com range=A1:B2,majorDimension=ROWS, [[1,2],[3,4]] vai definir A1=1,B1=2,A2=3,B2=4. Com range=A1:B2,majorDimension=COLUMNS, [[1,2],[3,4]] vai definir A1=1,B1=3,A2=2,B2=4.

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

values[]

array (ListValue format)

Os dados que foram lidos ou gravados. Essa é uma matriz de matrizes, em que 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.

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

Para entrada, os tipos de valor aceitos são: bool, string e double. Os valores nulos serão ignorados. Para definir uma célula como 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.