Grundlagen

Mit der Google Sheets API können Sie Werte aus Zellen, Bereichen, und ganze Blätter. Die Beispiele auf dieser Seite veranschaulichen einige häufig verwendete Lesematerialien Operationen mit der spreadsheets.values . Sie können Zellenwerte auch mit der Methode spreadsheets.get-Methode, aber normalerweise spreadsheets.values.get oder spreadsheets.values.batchGet ist einfacher.

Diese Beispiele werden in Form von HTTP-Anfragen neutral sein. Um zu erfahren, wie Sie Lesevorgänge in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken finden Sie unter Lesen und Zelle schreiben Werte.

In diesen Beispielen gibt der Platzhalter SPREADSHEET_ID an, wo Sie die Tabellen-ID, die Sie in der Tabellen-URL finden. Die Bereiche, aus denen gelesen werden soll, in der Anfrage mithilfe der A1-Notation angegeben werden URL Ein Beispielbereich ist Sheet1!A1:D5.

Quelldaten

Für diese Beispiele wird angenommen, dass die gelesene Tabellenkalkulation aus der folgenden Quelle stammt im ersten Tabellenblatt („Sheet1“). Die Zeichenfolgen in der ersten Zeile sind Beschriftungen für auf die einzelnen Spalten. Um Beispiele für das Lesen aus anderen Tabellenblättern in siehe A1-Notation.

	A	B	C	D
1	Element	Kosten	Bestückt	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,50 $	7	20.03.2016

Einzelnen Bereich lesen

Die folgenden spreadsheets.values.get Das Codebeispiel zeigt, wie die Werte aus dem Bereich Sheet1!A1:D5 gelesen werden, und gibt Folgendes zurück: in der Antwort einfügen. Leere nachgestellte Zeilen und Spalten 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 , das die Bereichswerte beschreibt. Die 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 nach Spalte gruppierten Bereich lesen

Die folgenden spreadsheets.values.get Das Codebeispiel zeigt, wie die Werte aus dem Bereich Sheet1!A1:D3 gelesen werden, und gibt in der Antwort, aber nach Spalte gruppiert. Leere nachgestellte 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 , das die Bereichswerte beschreibt. Die 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

Die folgenden spreadsheets.values.get Das Codebeispiel zeigt, wie die Werte aus dem Bereich Sheet1!A1:D5 gelesen werden, und gibt Folgendes zurück: in der Antwort einfügen, aber mithilfe von Rendering-Optionen steuern, wie diese Informationen zurückgegeben. Die Einstellung ValueRenderOption der Wert FORMULA gibt an, dass Formeln anstelle der berechneten Wert und der DateTimeRenderOption Einstellung von SERIAL_NUMBER gibt an, dass Daten als Zahlen zurückgegeben werden sollen. Es sind auch andere Einstellungen möglich. Leere nachgestellte 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 , das die Bereichswerte beschreibt. Die 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

Die folgenden spreadsheets.values.batchGet Das Codebeispiel zeigt, wie Werte aus den Bereichen Sheet1!B:B und Sheet1!D:D gelesen werden und in der Antwort zurückgegeben. Die Einstellung ValueRenderOption der Wert UNFORMATTED_VALUE gibt an, dass die Werte berechnet, aber nicht formatiert werden. in der Antwort angeben. Leere nachgestellte Zeilen und Spalten 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 ein Array von ValueRange Objekte, die dem jeweiligen angeforderten Bereich entsprechen, in der Reihenfolge aufgelistet, in der sie angefordert. Die 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

Die folgenden spreadsheets.values.batchGet das Codebeispiel zeigt, wie Werte aus Bereichen in sheets1!A1:D5 gelesen werden, Products!D1:D100 und Sales!E4:F6 und gibt sie in der Antwort zurück. Die Einstellung ValueRenderOption der Wert UNFORMATTED_VALUE gibt an, dass die Werte berechnet, aber nicht formatiert werden. in der Antwort angeben. Leere nachgestellte Zeilen und Spalten 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 ein Array von ValueRange Objekte, die dem jeweiligen angeforderten Bereich entsprechen, in der Reihenfolge aufgelistet, in der sie angefordert. Die 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": [
        [...],
        [...]
      ]
    }
  ]
}