REST Resource: spreadsheets.values
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: ValueRange
Daten in einem Bereich der Tabelle
| JSON-Darstellung |
{
"range": string,
"majorDimension": enum (Dimension),
"values": [
array
]
} |
| Felder |
range |
string
Der Bereich, den die Werte abdecken, in A1-Notation. In der Ausgabe gibt dieser Bereich den gesamten angeforderten Bereich an, auch wenn die Werte abschließende Zeilen und Spalten ausschließen. Beim Anhängen von Werten stellt dieses Feld den Bereich dar, in dem nach einer Tabelle gesucht wird, der die Werte dann angefügt werden.
|
majorDimension |
enum (Dimension)
Die Hauptdimension der Werte. Wenn die Tabellendaten A1=1,B1=2,A2=3,B2=4 lauten, wird bei einer Anfrage für range=A1:B2,majorDimension=ROWS der Wert [[1,2],[3,4]] zurückgegeben. Bei einer Anfrage für range=A1:B2,majorDimension=COLUMNS wird dagegen [[1,3],[2,4]] zurückgegeben. Bei der Eingabe wird mit range=A1:B2,majorDimension=ROWS dann [[1,2],[3,4]] festgelegt, um A1=1,B1=2,A2=3,B2=4 zu setzen. Mit range=A1:B2,majorDimension=COLUMNS wird [[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 ZEILEN verwendet.
|
values[] |
array (ListValue format)
Die gelesenen oder zu schreibenden Daten. Dies ist ein Array von Arrays, wobei das äußere Array alle Daten und jedes innere Array eine Hauptdimension darstellt. Jedes Element im inneren Array entspricht einer Zelle. Leere Zeilen und Spalten am Ende werden in der Ausgabe nicht berücksichtigt. Für die Eingabe werden die Werttypen „bool“, „string“ und „double“ unterstützt. Nullwerte werden übersprungen. Wenn Sie eine Zelle auf einen leeren Wert setzen möchten, setzen Sie den Stringwert auf einen leeren String.
|
Methoden |
|
|
Hängt Werte an eine Tabelle an. |
|
|
Löscht einen oder mehrere Wertebereiche aus einer Tabelle. |
|
|
Löscht einen oder mehrere Wertebereiche aus einer Tabelle. |
|
|
Gibt einen oder mehrere Wertebereiche aus einer Tabelle zurück. |
|
|
Gibt einen oder mehrere Wertebereiche zurück, die mit den angegebenen Datenfiltern übereinstimmen. |
|
|
Legt Werte in einem oder mehreren Bereichen einer Tabelle fest. |
|
|
Legt Werte in einem oder mehreren Bereichen einer Tabelle fest. |
|
|
Löscht Werte aus einer Tabelle. |
|
|
Gibt einen Wertebereich aus einer Tabelle zurück. |
|
|
Legt Werte in einem Bereich einer Tabelle fest. |
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,["# REST Resource: spreadsheets.values\n\n- [Resource: ValueRange](#ValueRange)\n - [JSON representation](#ValueRange.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ValueRange\n--------------------\n\nData within a range of the spreadsheet.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"range\": string, \"majorDimension\": enum (/workspace/sheets/api/reference/rest/v4/Dimension), \"values\": [ array ] } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `range` | `string` The range the values cover, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). For output, this range indicates the entire requested range, even though the values will exclude trailing rows and columns. When appending values, this field represents the range to search for a table, after which values will be appended. |\n| `majorDimension` | `enum (`[Dimension](/workspace/sheets/api/reference/rest/v4/Dimension)`)` The major dimension of the values. For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` will return `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return `[[1,3],[2,4]]`. For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]` will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS` then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`. When writing, if this field is not set, it defaults to ROWS. |\n| `values[]` | `array (`[ListValue](https://protobuf.dev/reference/protobuf/google.protobuf/#list-value)` format)` The data that was read or to be written. This is an array of arrays, the outer array representing all the data and each inner array representing a major dimension. Each item in the inner array corresponds with one cell. For output, empty trailing rows and columns will not be included. For input, supported value types are: bool, string, and double. Null values will be skipped. To set a cell to an empty value, set the string value to an empty string. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|\n| ### [append](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/append) | Appends values to a spreadsheet. |\n| ### [batchClear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClear) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchClearByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClearByDataFilter) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchGet](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet) | Returns one or more ranges of values from a spreadsheet. |\n| ### [batchGetByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGetByDataFilter) | Returns one or more ranges of values that match the specified data filters. |\n| ### [batchUpdate](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate) | Sets values in one or more ranges of a spreadsheet. |\n| ### [batchUpdateByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdateByDataFilter) | Sets values in one or more ranges of a spreadsheet. |\n| ### [clear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/clear) | Clears values from a spreadsheet. |\n| ### [get](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) | Returns a range of values from a spreadsheet. |\n| ### [update](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update) | Sets values in a range of a spreadsheet. |"]]
