REST Resource: spreadsheets.values

Ressource: ValueRange

Daten innerhalb eines Bereichs der Tabelle.

JSON-Darstellung 
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Felder
range

string

Der Bereich, den die Werte abdecken, in A1-Notation. Bei der Ausgabe gibt dieser Bereich den gesamten angeforderten Bereich an, auch wenn die Werte nachgestellte Zeilen und Spalten ausschließen. Beim Anhängen von Werten stellt dieses Feld den Suchbereich für eine Tabelle dar, nach dem Werte angehängt werden.
majorDimension

enum (Dimension)

Die Hauptdimension der Werte.

Wenn für die Ausgabe der Tabellendatenwert A1=1,B1=2,A2=3,B2=4 ist, wird beim Anfordern von range=A1:B2,majorDimension=ROWS der Wert [[1,2],[3,4]] zurückgegeben, während beim Anfordern von range=A1:B2,majorDimension=COLUMNS [[1,3],[2,4]] zurückgegeben wird.

Für die Eingabe wird mit range=A1:B2,majorDimension=ROWS [[1,2],[3,4]] A1=1,B1=2,A2=3,B2=4 festgelegt. Mit range=A1:B2,majorDimension=COLUMNS wird dann [[1,2],[3,4]] auf A1=1,B1=3,A2=2,B2=4 festgelegt.

Wenn dieses Feld beim Schreiben nicht festgelegt ist, wird standardmäßig ROWS verwendet.
values[]

array (ListValue format)

Die Daten, die gelesen wurden oder geschrieben werden sollen. Dies ist ein Array aus Arrays, wobei das äußere Array alle Daten und jedes innere Array eine Hauptdimension repräsentiert. Jedes Element im inneren Array entspricht einer Zelle.

Bei der Ausgabe werden leere nachgestellte Zeilen und Spalten nicht berücksichtigt.

Für die Eingabe werden folgende Werttypen unterstützt: bool, string und double. Nullwerte werden übersprungen. Wenn Sie für eine Zelle einen leeren Wert festlegen möchten, setzen Sie den Stringwert auf einen leeren String.

Methoden

append

 Hängt Werte an eine Tabelle an.

batchClear

 Löscht einen oder mehrere Wertebereiche aus einer Tabelle.

batchClearByDataFilter

 Löscht einen oder mehrere Wertebereiche aus einer Tabelle.

batchGet

 Gibt einen oder mehrere Wertebereiche aus einer Tabellenkalkulation zurück.

batchGetByDataFilter

 Gibt einen oder mehrere Wertebereiche zurück, die den angegebenen Datenfiltern entsprechen.

batchUpdate

 Legt Werte in einem oder mehreren Bereichen einer Tabelle fest.

batchUpdateByDataFilter

 Legt Werte in einem oder mehreren Bereichen einer Tabelle fest.

clear

 Löscht Werte aus einer Tabelle.

get

 Gibt einen Wertebereich aus einer Tabellenkalkulation zurück.

update

 Legt Werte in einem Bereich einer Tabelle fest.