REST Resource: spreadsheets.values

Risorsa: ValueRange

I 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 escludono le righe e le colonne finali. Quando si aggiungono valori, questo campo rappresenta l'intervallo in cui cercare una tabella, dopodiché i valori verranno aggiunti.

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 restituisce [[1,3],[2,4]].

Per l'input, con range=A1:B2,majorDimension=ROWS e poi [[1,2],[3,4]] verrà impostato 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.

Se durante la scrittura non hai configurato questo campo, il valore predefinito è ROWS.

values[]

array (ListValue format)

I dati letti o da scrivere. Si tratta di una matrice, la matrice esterna che rappresenta tutti i dati e ciascuna matrice interna che rappresenta una dimensione principale. Ogni elemento nella matrice interna corrisponde a una cella.

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

Per l'input, i tipi di valori supportati sono: bool, stringa e doppio. 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 che corrispondono 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.