REST Resource: spreadsheets.values

Risorsa: ValueRange

Dati in un intervallo del foglio di lavoro.

Rappresentazione JSON
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Campi
range

string

L'intervallo coperto dai valori, in notazione A1. Per l'output, questo intervallo indica l'intero intervallo richiesto, anche se i valori escluderanno le righe e le colonne finali. Quando aggiungi valori, questo campo rappresenta l'intervallo in cui cercare una tabella, dopo il quale verranno aggiunti i valori.

majorDimension

enum (Dimension)

La dimensione principale dei valori.

Per l'output, se i dati del foglio di lavoro sono A1=1,B1=2,A2=3,B2=4, la richiesta di range=A1:B2,majorDimension=ROWS restituirà [[1,2],[3,4]], mentre la richiesta di range=A1:B2,majorDimension=COLUMNS restituirà [[1,3],[2,4]].

Per l'input, con range=A1:B2,majorDimension=ROWS, [[1,2],[3,4]] imposterà A1=1,B1=2,A2=3,B2=4. Con range=A1:B2,majorDimension=COLUMNS, allora [[1,2],[3,4]] imposterà A1=1,B1=3,A2=2,B2=4.

Durante la scrittura, se questo campo non è impostato, il valore predefinito è ROWS.

values[]

array (ListValue format)

I dati che sono stati letti o scritti. Si tratta di un array di matrici, la matrice esterna che rappresenta tutti i dati e ogni matrice interna che rappresenta una dimensione principale. Ogni elemento della matrice interna corrisponde a una cella.

Per l'output, non verranno incluse le righe e le colonne finali vuote.

Per l'input, i tipi di valori supportati sono: bool, string e double. I valori null verranno ignorati. Per impostare un valore vuoto per una cella, imposta il valore della stringa su una stringa vuota.

Metodi

append

Accoda i valori al foglio di lavoro.

batchClear

Cancella uno o più intervalli di valori da un foglio di lavoro.

batchClearByDataFilter

Cancella uno o più intervalli di valori da un foglio di lavoro.

batchGet

Restituisce uno o più intervalli di valori di un foglio di lavoro.

batchGetByDataFilter

Restituisce uno o più intervalli di valori corrispondenti ai filtri dati specificati.

batchUpdate

Imposta i valori in uno o più intervalli di un foglio di lavoro.

batchUpdateByDataFilter

Imposta i valori in uno o più intervalli di un foglio di lavoro.

clear

Cancella i valori da un foglio di lavoro.

get

Restituisce un intervallo di valori da un foglio di lavoro.

update

Imposta i valori in un intervallo di un foglio di lavoro.