Mit der Google Tabellen API können Sie Werte aus Zellen, Bereichen, Bereichsgruppen und ganzen Tabellen lesen. Die Beispiele auf dieser Seite veranschaulichen einige gängige Lesevorgänge mit der Ressource spreadsheets.values. Sie können Zellenwerte auch mit der Methode spreadsheets.get lesen. In der Regel ist es jedoch einfacher, spreadsheets.values.get oder spreadsheets.values.batchGet zu verwenden.
Diese Beispiele werden in Form von HTTP-Anfragen dargestellt, um sprachenunabhängig zu sein. Informationen zum Implementieren von Lesevorgängen in verschiedenen Sprachen mit den Google API-Clientbibliotheken finden Sie unter Zellenwerte lesen und schreiben.
In diesen Beispielen gibt der Platzhalter SPREADSHEET_ID an, wo Sie die Tabellen-ID angeben würden. Sie finden sie in der Tabellen-URL. Die Bereiche, aus denen gelesen werden soll, werden in der Anfrage-URL in A1-Notation angegeben. Ein Beispiel für einen Bereich ist Tabelle1!A1:D5.
Quelldaten
Für diese Beispiele nehmen wir an, dass die zu lesende Tabelle auf dem ersten Tabellenblatt („Tabelle1“) die folgenden Quelldaten enthält. Die Strings in der ersten Zeile sind Labels für die einzelnen Spalten. Beispiele zum Lesen von anderen Tabellen in Ihrer Tabelle finden Sie unter A1-Notation.
| A | B | C | D | |
| 1 | Element | Kosten | Auf Lager | Versanddatum |
| 2 | Wheel Riesenrad | 20,50 $ | 4 | 01.03.2016 |
| 3 | Tür | 15 $ | 2 | 15.03.2016 |
| 4 | Engine | 100 $ | 1 | 20.03.2016 |
| 5 | Gesamt | 135,5 $ | 7 | 20.03.2016 |
Einzelnen Bereich lesen
Im folgenden spreadsheets.values.get-Codebeispiel wird gezeigt, wie die Werte aus dem Bereich „Tabelle1!A1:D5“ gelesen und in der Antwort zurückgegeben werden. Leere Zeilen und Spalten am Ende werden weggelassen.
Das Anfrageprotokoll wird hier angezeigt.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5
Die Antwort besteht aus einem ValueRange-Objekt, das die Werte des Bereichs beschreibt. Das Feld majorDimension gibt an, dass die Arrays Listen von Werten sind, die nach Zeilen organisiert sind.
{
"range": "Sheet1!A1:D5",
"majorDimension": "ROWS",
"values": [
["Item", "Cost", "Stocked", "Ship Date"],
["Wheel", "$20.50", "4", "3/1/2016"],
["Door", "$15", "2", "3/15/2016"],
["Engine", "$100", "1", "30/20/2016"],
["Totals", "$135.5", "7", "3/20/2016"]
],
}
Einzelnen Bereich lesen, der nach Spalte gruppiert ist
Im folgenden spreadsheets.values.get-Codebeispiel wird gezeigt, wie die Werte aus dem Bereich „Tabelle1!A1:D3“ gelesen und in der Antwort zurückgegeben werden, aber nach Spalte gruppiert. Leere Zeilen und Spalten am Ende werden weggelassen.
Das Anfrageprotokoll wird hier angezeigt.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS
Die Antwort besteht aus einem ValueRange-Objekt, das die Werte des Bereichs beschreibt. Das Feld majorDimension gibt an, dass die Arrays Listen von Werten sind, die nach Spalten organisiert sind.
{
"range": "Sheet1!A1:D3",
"majorDimension": "COLUMNS",
"values": [
["Item", "Wheel", "Door"],
["Cost", "$20.50", "$15"],
["Stocked", "4", "2"],
["Ship Date", "3/1/2016", "3/15/2016"]
],
}
Einzelnen Bereich mit Renderingoptionen lesen
Im folgenden Codebeispiel spreadsheets.values.get wird gezeigt, wie die Werte aus dem Bereich „Tabelle1!A1:D5“ gelesen und in der Antwort zurückgegeben werden. Dabei werden aber Rendering-Optionen verwendet, um festzulegen, wie diese Informationen zurückgegeben werden. Die Einstellung ValueRenderOption von FORMULA gibt an, dass anstelle des berechneten Werts Formeln zurückgegeben werden sollen. Die Einstellung DateTimeRenderOption von SERIAL_NUMBER gibt an, dass Datumsangaben als Zahlen zurückgegeben werden sollen.
Andere Einstellungen sind ebenfalls möglich. Leere Zeilen und Spalten am Ende werden weggelassen.
Das Anfrageprotokoll wird hier angezeigt.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5?
valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER
Die Antwort besteht aus einem ValueRange-Objekt, das die Werte des Bereichs beschreibt. Das Feld majorDimension gibt an, dass die Arrays Listen von Werten sind, die nach Zeilen organisiert sind.
{
"range": "Sheet1!A1:D5",
"majorDimension": "ROWS",
"values": [
["Item", "Cost", "Stocked", "Ship Date"],
["Wheel", "$20.50", "4", "42430"],
["Door", "$15", "2", "42444"],
["Engine", "$100", "1", "42449"],
["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
],
}
Mehrere Bereiche lesen
Im folgenden spreadsheets.values.batchGet-Codebeispiel wird gezeigt, wie Werte aus den Bereichen „Tabelle1!B:B“ und „Tabelle1!D:D“ gelesen und in der Antwort zurückgegeben werden. Die ValueRenderOption-Einstellung von UNFORMATTED_VALUE gibt an, dass Werte berechnet, aber nicht in der Antwort formatiert werden. Leere Zeilen und Spalten am Ende werden weggelassen.
Das Anfrageprotokoll wird hier angezeigt.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet?
ranges=Sheet1!B:B&ranges=Sheet1!D:D&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
Die Antwort auf diesen Methodenaufruf besteht aus einem Objekt mit der Tabellen-ID und einem Array von ValueRange-Objekten, die jedem angeforderten Bereich in der Reihenfolge entsprechen, in der sie angefordert wurden. Das Feld majorDimension gibt an, dass die Arrays Listen von Werten sind, die nach Spalten organisiert sind. Beispiel:
{
"spreadsheetId": SPREADSHEET_ID,
"valueRanges": [
{
"range": "Sheet1!B1:B1000",
"majorDimension": "COLUMNS",
"values": [
["Cost",20.5,15,100,135.5]
]
},
{
"range": "Sheet1!D1:D1000",
"majorDimension": "COLUMNS",
"values": [
["Ship Date",42430,42444,42449,42449]
]s
}
]
}
Mehrere Bereiche in mehreren Tabellenblättern lesen
Im folgenden spreadsheets.values.batchGet-Codebeispiel wird gezeigt, wie Werte aus den Bereichen in den Tabellen „Tabelle1!A1:D5“, „Produkte!D1:D100“ und „Umsätze!E4:F6“ gelesen und in der Antwort zurückgegeben werden. Die ValueRenderOption-Einstellung von UNFORMATTED_VALUE gibt an, dass Werte berechnet, aber nicht in der Antwort formatiert werden. Leere Zeilen und Spalten am Ende werden weggelassen.
Das Anfrageprotokoll wird hier angezeigt.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet?
ranges=Sheet1!A1:D5&ranges=Products!D1:D100&ranges=Sales!E4:F6&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
Die Antwort auf diesen Methodenaufruf besteht aus einem Objekt mit der Tabellen-ID und einem Array von ValueRange-Objekten, die jedem angeforderten Bereich in der Reihenfolge entsprechen, in der sie angefordert wurden. Das Feld majorDimension gibt an, dass die Arrays Listen von Werten sind, die nach Spalten organisiert sind. Beispiel:
{
"spreadsheetId": SPREADSHEET_ID,
"valueRanges": [
{
"range": "Sheet1!A1:D5",
"majorDimension": "COLUMNS",
"values": [
[...],
[...]
]
},
{
"range": "Products!D1:D100",
"majorDimension": "COLUMNS",
"values": [
[...]
]
},
{
"range": "Sales!E4:F6",
"majorDimension": "COLUMNS",
"values": [
[...],
[...]
]
}
]
}