REST Resource: spreadsheets.values

Risorsa: ValueRange

Dati compresi 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, [[1,2],[3,4]] imposterà A1=1,B1=3,A2=2,B2=4.

In fase di scrittura, se questo campo non è impostato, il valore predefinito è ROWS.

values[]

array (ListValue format)

I dati che sono stati letti o che devono essere scritti. Si tratta di un array di array, in cui l'array esterno rappresenta tutti i dati e ogni array interno rappresenta una dimensione principale. Ogni elemento dell'array interno corrisponde a una cella.

Per l'output, non saranno 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 una cella su un valore vuoto, imposta il valore della stringa su una stringa vuota.

Metodi

append

Aggiunge valori a un 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 da 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.