Method: spreadsheets.get

Gibt die Tabelle mit der angegebenen ID zurück. Der Aufrufer muss die Tabellen-ID angeben.

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

  • Geben Sie mit dem URL-Parameter fields in HTTP eine Feldmaske an, in der die gewünschten Felder aufgeführt sind.

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

Bei großen Tabellen sollten Sie nur die gewünschten Tabellenfelder abrufen.

Wenn Sie nur Teilmengen von Tabellendaten abrufen möchten, verwenden Sie den URL-Parameter ranges. Bereiche werden in A1-Notation angegeben. Sie können eine einzelne Zelle (z. B. A1) oder mehrere Zellen (z. B. A1:D5) definieren. Außerdem können Sie Zellen aus anderen Tabellen innerhalb 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 einschränken, werden nur die Bereiche 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 anzufordernde 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.
excludeTablesInBandedRanges

boolean

„Wahr“, wenn Tabellen aus den gruppierten Bereichen ausgeschlossen werden sollen. „False“, wenn nicht festgelegt.

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.