Method: spreadsheets.values.get
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/drivehttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/spreadsheetshttps://www.googleapis.com/auth/spreadsheets.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-09-05 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-09-05 (UTC)."],[[["This Google Sheets API endpoint retrieves a range of values from a specified spreadsheet and range using an HTTP GET request."],["Users need to provide the `spreadsheetId` and `range` as path parameters in the request URL."],["Optional query parameters allow customization of the output, including `majorDimension`, `valueRenderOption`, and `dateTimeRenderOption`."],["The response body, upon successful execution, will contain a `ValueRange` object with the requested data."],["Authorization is required using one of the specified OAuth scopes related to Google Drive or Google Sheets access."]]],["This describes retrieving data from a spreadsheet using a `GET` HTTP request. The request URL includes the `spreadsheetId` and `range` as path parameters. Optional query parameters, like `majorDimension`, `valueRenderOption`, and `dateTimeRenderOption`, allow customization of the returned data. The request body must be empty. The response contains the spreadsheet data in `ValueRange` format if the request is successful. Authentication requires specific OAuth scopes for access.\n"]]
