Method: spreadsheets.values.get

• HTTP-Anfrage
• Pfadparameter
• Anfrageparameter
• Anfragetext
• Antworttext
• Autorisierungsbereiche
• Testen!

Gibt einen Wertebereich aus einer Tabellenkalkulation zurück. Der Aufrufer muss die Tabellen-ID und einen Bereich angeben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId	string Die ID der Tabelle, aus der Daten abgerufen werden sollen.
range	string Die A1-Notation oder R1C1-Notation des Bereichs, aus dem Werte abgerufen werden sollen.

Abfrageparameter

Parameter
majorDimension	enum (Dimension) Die Hauptdimension, die in den Ergebnissen verwendet werden soll. Wenn die Tabellendaten in Sheet1 beispielsweise A1=1,B1=2,A2=3,B2=4 lauten, wird bei der Anforderung von range=Sheet1!A1:B2?majorDimension=ROWS der Wert [[1,2],[3,4]] zurückgegeben, während bei der Anfrage range=Sheet1!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 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

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ValueRange.

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.