Method: spreadsheets.get

Gibt das Arbeitsblatt unter der angegebenen ID zurück Der Aufrufer muss die Tabellen-ID angeben.

Standardmäßig werden Daten in Rastern nicht zurückgegeben. Sie haben zwei Möglichkeiten, Rasterdaten einzubinden:

  • Geben Sie eine Feldmaske mit den gewünschten Feldern über den URL-Parameter fields in HTTP an.

  • Legen Sie den URL-Parameter includeGridData auf „true“ fest. Wenn eine Feldmaske festgelegt ist, wird der Parameter includeGridData ignoriert

Rufen Sie bei großen Tabellenkalkulationen als Best Practice nur die gewünschten Tabellenkalkulationsfelder ab.

Wenn Sie nur Teilmengen der Tabellendaten abrufen möchten, verwenden Sie den URL-Parameter ranges. Bereiche werden in der A1-Notation angegeben. Sie können eine einzelne Zelle (z. B. A1) oder mehrere Zellen (z. B. A1:D5) definieren. Sie können auch Zellen aus anderen Tabellenblättern in derselben Tabelle abrufen (z. B. Sheet2!A1:C4) oder mehrere Bereiche gleichzeitig abrufen (z. B. ?ranges=A1:D5&ranges=Sheet2!A1:C4). Wenn Sie den Bereich begrenzen, werden nur die Teile der Tabelle zurückgegeben, die sich mit den angeforderten Bereichen überschneiden.

HTTP-Anfrage

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die anzufragende Tabelle.

Abfrageparameter

Parameter
ranges[]

string

Die Bereiche, die aus der Tabelle abgerufen werden sollen.
includeGridData

boolean

True, wenn Rasterdaten zurückgegeben werden sollen. Dieser Parameter wird ignoriert, wenn in der Anfrage eine Feldmaske festgelegt wurde.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Spreadsheet.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.