Grundlagen

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 zu lesenden Bereiche 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 spreadsheets.values.get-Codebeispiel wird gezeigt, wie die Werte aus dem Bereich „Tabelle1!A1:D5“ gelesen und in der Antwort zurückgegeben werden. Dabei werden aber Renderingoptionen verwendet, um festzulegen, wie diese Informationen zurückgegeben werden. Die Einstellung ValueRenderOption für FORMULA gibt an, dass anstelle des berechneten Werts Formeln zurückgegeben werden sollen. Die Einstellung DateTimeRenderOption für 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": [
        [...],
        [...]
      ]
    }
  ]
}