Grundlagen

Mit der Google Sheets API können Sie Werte aus Zellen, Bereichen, Gruppen von Bereichen und ganzen Tabellenblättern lesen. Die Beispiele auf dieser Seite veranschaulichen einige häufige Lesevorgänge mit der spreadsheets.values Ressource. Sie können Zellwerte auch mit der spreadsheets.get Methode lesen, aber in der Regel ist spreadsheets.values.get oder spreadsheets.values.batchGet einfacher.

Diese Beispiele werden in Form von HTTP-Anfragen dargestellt, um sprachneutral zu sein. Informationen zum Implementieren von Lesevorgängen in verschiedenen Sprachen mit den Google API-Clientbibliotheken finden Sie unter Zellwerte lesen und schreiben.

In diesen Beispielen gibt der Platzhalter SPREADSHEET_ID an, wo Sie die Tabellen-ID angeben müssen. Diese finden Sie in der Tabellen-URL. Die Bereiche, aus denen gelesen werden soll, werden in der Anfrage URL in der A1-Notation angegeben. Ein Beispiel für einen Bereich ist Tabelle1!A1:D5.

Quelldaten

Für diese Beispiele wird davon ausgegangen, dass die Tabelle, die gelesen wird, die folgenden Quelldaten im ersten Tabellenblatt („Tabelle1“) enthält. Die Strings in der ersten Zeile sind Labels für die einzelnen Spalten. Beispiele zum Lesen aus anderen Tabellenblättern in Ihrer Tabelle finden Sie unter A1-Notation.

A B C D
1 Element Kosten Auf Lager Versanddatum
2 Rad 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

Das folgende spreadsheets.values.get Codebeispiel zeigt, wie Sie die Werte aus dem Bereich Tabelle1!A1:D5 lesen und in der Antwort zurückgeben. Leere nachfolgende Zeilen und Spalten werden ausgelassen.

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 Bereichswerte beschreibt. Das majorDimension Feld 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 nach Spalten gruppiert lesen

Das folgende spreadsheets.values.get Codebeispiel zeigt, wie Sie die Werte aus dem Bereich Tabelle1!A1:D3 lesen und in der Antwort zurückgeben, aber nach Spalten gruppiert. Leere nachfolgende Zeilen und Spalten werden ausgelassen.

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 Bereichswerte beschreibt. Das majorDimension Feld 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 Rendering-Optionen lesen

Das folgende spreadsheets.values.get Codebeispiel zeigt, wie Sie die Werte aus dem Bereich Tabelle1!A1:D5 lesen und sie in der Antwort zurückgeben. Dabei werden jedoch Rendering-Optionen verwendet, um zu steuern, wie diese Informationen zurückgegeben werden. Die ValueRenderOption Einstellung von FORMULA gibt an, dass anstelle des berechneten Werts Formeln zurückgegeben werden sollen. Die DateTimeRenderOption Einstellung von SERIAL_NUMBER gibt an, dass Datumsangaben als Zahlen zurückgegeben werden sollen. Es sind auch andere Einstellungen möglich. Leere nachfolgende Zeilen und Spalten werden ausgelassen.

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 Bereichswerte beschreibt. Das majorDimension Feld 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

Das folgende spreadsheets.values.batchGet Codebeispiel zeigt, wie Sie Werte aus den Bereichen Tabelle1!B:B und Tabelle1!D:D lesen und in der Antwort zurückgeben. Die ValueRenderOption Einstellung von UNFORMATTED_VALUE gibt an, dass Werte berechnet, aber nicht in der Antwort formatiert werden. Leere nachfolgende Zeilen und Spalten werden ausgelassen.

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 entsprechen. Sie sind in der Reihenfolge aufgeführt, in der sie angefordert wurden. Das majorDimension Feld 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

Das folgende spreadsheets.values.batchGet Codebeispiel zeigt, wie Sie Werte aus den Bereichen Tabelle1!A1:D5, Produkte!D1:D100 und Umsätze!E4:F6 lesen und in der Antwort zurückgeben. Die ValueRenderOption Einstellung von UNFORMATTED_VALUE gibt an, dass Werte berechnet, aber nicht in der Antwort formatiert werden. Leere nachfolgende Zeilen und Spalten werden ausgelassen.

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 entsprechen. Sie sind in der Reihenfolge aufgeführt, in der sie angefordert wurden. Das majorDimension Feld 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": [
        [...],
        [...]
      ]
    }
  ]
}