Method: spreadsheets.get

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

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

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

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

Bei großen Tabellen sollten Sie als Best Practice 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. 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 einschränken, 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 Tabelle, die angefordert werden soll.

Suchparameter

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

„True“, wenn Tabellen in den Bereichen mit unterschiedlichen Farben ausgeschlossen werden sollen. „False“, wenn nicht festgelegt.
commentsViewMode

enum (CommentsViewMode)

Der Ansichtsmodus für Kommentare, der auf die Tabelle angewendet werden soll. So können Sie die Tabelle mit oder ohne Kommentare aufrufen. Wenn keine angegeben ist, wird COMMENTS_VIEW_MODE_OMITTED verwendet.

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 Autorisierungsleitfaden.