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 Tabellen zurückgegeben. Sie haben zwei Möglichkeiten, Tabellendaten einzufügen:

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

  • 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 spezifischen Tabellenfelder abrufen, die Sie benötigen.

Verwenden Sie den URL-Parameter ranges, um nur Teilmengen von Tabellendaten abzurufen. 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 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 Tabellendaten 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 abwechselnden Farben ausgeschlossen werden sollen. „false“, wenn nicht festgelegt.
commentsViewMode

enum (CommentsViewMode)

Der Kommentaransichtsmodus, der auf die Tabelle angewendet werden soll. So können Sie die Tabelle mit oder ohne Kommentare ansehen. Wenn kein Modus 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.