Method: spreadsheets.get

Gibt die Tabelle unter der angegebenen ID zurück Der Anrufer muss die Tabellen-ID angeben.

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

  • Geben Sie mithilfe des URL-Parameters fields in HTTP eine Feldmaske an, in der die gewünschten Felder aufgeführt sind.

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

Bei großen Tabellen empfiehlt es sich, nur die gewünschten Tabellenfelder abzurufen.

Wenn Sie nur einen Teil 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) festlegen. Sie können auch Zellen aus anderen Tabellenblättern innerhalb derselben Tabelle (z. B. Sheet2!A1:C4) abrufen oder mehrere Bereiche gleichzeitig abrufen (z. B. ?ranges=A1:D5&ranges=Sheet2!A1:C4). Wenn Sie den Bereich beschränken, werden nur die Teile der Tabelle zurückgegeben, die die angeforderten Bereiche schneiden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die Tabelle, die angefordert werden soll.

Abfrageparameter

Parameter
ranges[]

string

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

boolean

Dieser Wert ist „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.