Method: spreadsheets.values.batchGet

Gibt einen oder mehrere Wertebereiche aus einer Tabellenkalkulation zurück. Der Aufrufer muss die Tabellen-ID und mindestens einen Bereich angeben.

HTTP-Anfrage

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die ID der Tabelle, aus der Daten abgerufen werden sollen.

Abfrageparameter

Parameter
ranges[]

string

Die A1-Notation oder R1C1-Notation des Bereichs, aus dem Werte abgerufen werden sollen.
majorDimension

enum (Dimension)

Die Hauptdimension, die in den Ergebnissen verwendet werden soll.

Wenn die Tabellendaten beispielsweise A1=1,B1=2,A2=3,B2=4 sind, wird bei der Anforderung von ranges=["A1:B2"],majorDimension=ROWS der Wert [[1,2],[3,4]] zurückgegeben, während bei einer Anfrage von ranges=["A1:B2"],majorDimension=COLUMNS [[1,3],[2,4]] zurückgegeben wird.
valueRenderOption

enum (ValueRenderOption)

Wie Werte in der Ausgabe dargestellt werden sollen. Die Standardoption für das Rendering ist ValueRenderOption.FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

Gibt an, wie Datum, Uhrzeit und Dauer in der Ausgabe dargestellt werden sollen. Dies wird ignoriert, wenn valueRenderOption FORMATTED_VALUE ist. Die standardmäßige Renderingoption für dateTime ist SERIAL_NUMBER.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwort beim Abrufen mehrerer Wertebereiche in einer Tabelle.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
Felder
spreadsheetId

string

Die ID der Tabelle, aus der die Daten abgerufen wurden.
valueRanges[]

object (ValueRange)

Die angeforderten Werte. Die Reihenfolge der ValueRanges entspricht der Reihenfolge der angeforderten Bereiche.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.