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 saída, esse intervalo indica todo o intervalo solicitado, mesmo que os valores excluam linhas e colunas no final. Ao anexar valores, este campo representa o intervalo para pesquisar uma tabela. Depois desse período, 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]], e a de range=A1:B2,majorDimension=COLUMNS retornará [[1,3],[2,4]].

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

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

values[]

array (ListValue format)

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

Para 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. Os 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

Acrescenta 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 os valores em um intervalo de uma planilha.