Method: spreadsheets.values.get
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Gibt einen Wertebereich aus einer Tabelle 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 für die Ergebnisse verwendet werden soll. Wenn die Tabellendaten in Tabelle1 beispielsweise A1=1,B1=2,A2=3,B2=4 lauten, wird bei einer Anfrage für range=Sheet1!A1:B2?majorDimension=ROWS der Wert [[1,2],[3,4]] zurückgegeben, während bei einer Anfrage für range=Sheet1!A1:B2?majorDimension=COLUMNS der Wert [[1,3],[2,4]] zurückgegeben wird.
|
valueRenderOption |
enum (ValueRenderOption)
Gibt an, wie Werte in der Ausgabe dargestellt werden sollen. Die Standard-Rendering-Option ist FORMATTED_VALUE.
|
dateTimeRenderOption |
enum (DateTimeRenderOption)
Gibt an, wie Datum, Uhrzeit und Dauer in der Ausgabe dargestellt werden sollen. Dieser Wert wird ignoriert, wenn valueRenderOption FORMATTED_VALUE ist. Die Standardoption für die dateTime-Darstellung 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: 2025-03-22 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-03-22 (UTC)."],[],[],null,["# Method: spreadsheets.values.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns a range of values from a spreadsheet. The caller must specify the spreadsheet ID and a range.\n\n### HTTP request\n\n`GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `spreadsheetId` | `string` The ID of the spreadsheet to retrieve data from. |\n| `range` | `string` The [A1 notation or R1C1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the range to retrieve values from. |\n\n### Query parameters\n\n| Parameters ||\n|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `majorDimension` | `enum (`[Dimension](/workspace/sheets/api/reference/rest/v4/Dimension)`)` The major dimension that results should use. For example, if the spreadsheet data in Sheet1 is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=Sheet1!A1:B2?majorDimension=ROWS` returns `[[1,2],[3,4]]`, whereas requesting `range=Sheet1!A1:B2?majorDimension=COLUMNS` returns `[[1,3],[2,4]]`. |\n| `valueRenderOption` | `enum (`[ValueRenderOption](/workspace/sheets/api/reference/rest/v4/ValueRenderOption)`)` How values should be represented in the output. The default render option is [FORMATTED_VALUE](/workspace/sheets/api/reference/rest/v4/ValueRenderOption). |\n| `dateTimeRenderOption` | `enum (`[DateTimeRenderOption](/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption)`)` How dates, times, and durations should be represented in the output. This is ignored if [valueRenderOption](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get#body.QUERY_PARAMETERS.value_render_option) is [FORMATTED_VALUE](/workspace/sheets/api/reference/rest/v4/ValueRenderOption). The default dateTime render option is [SERIAL_NUMBER](/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ValueRange](/workspace/sheets/api/reference/rest/v4/spreadsheets.values#ValueRange).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `https://www.googleapis.com/auth/drive.readonly`\n- `https://www.googleapis.com/auth/drive.file`\n- `https://www.googleapis.com/auth/spreadsheets`\n- `https://www.googleapis.com/auth/spreadsheets.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
