Method: spreadsheets.values.append

Fügt eine Tabelle an. Der Eingabebereich wird verwendet, um vorhandene Daten zu suchen und eine „Tabelle“ innerhalb dieses Bereichs zu finden. Die Werte werden an die nächste Tabellenzeile angehängt, beginnend mit der ersten Spalte der Tabelle. Weitere Informationen dazu, wie Tabellen erkannt und Daten angefügt werden, finden Sie im Leitfaden und im Beispielcode.

Der Anrufer muss die Tabellen-ID, den Bereich und einen valueInputOption angeben. valueInputOption steuert nur, wie die eingegebenen Daten in die Tabelle aufgenommen werden (spaltenweise oder zeilenweise). Sie wirkt sich nicht darauf aus, in welche Zelle die Daten geschrieben werden.

HTTP-Anfrage

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die ID der zu aktualisierenden Tabelle.

range

string

Die A1-Notation eines Bereichs, um nach einer logischen Datentabelle zu suchen. An die letzte Zeile der Tabelle werden Werte angehängt.

Abfrageparameter

Parameter
valueInputOption

enum (ValueInputOption)

Wie die Eingabedaten interpretiert werden sollen.

insertDataOption

enum (InsertDataOption)

Die Art der Eingabe der Eingabedaten.

includeValuesInResponse

boolean

Legt fest, ob die Updateantwort die Werte der angehängten Zellen enthalten soll. Standardmäßig enthalten die Antworten die aktualisierten Werte nicht.

responseValueRenderOption

enum (ValueRenderOption)

Legt fest, wie Werte in der Antwort gerendert werden. Die Standardoption für das Rendering ist FORMATTED_VALUE.

responseDateTimeRenderOption

enum (DateTimeRenderOption)

Legt fest, wie Datum, Uhrzeit und Dauer in der Antwort gerendert werden. Diese wird ignoriert, wenn responseValueRenderOption den Wert FORMATTED_VALUE hat. Die standardmäßige Rendering-Option „dateTime“ ist SERIAL_NUMBER.

Anfragetext

Der Anfragetext enthält eine Instanz von ValueRange.

Antworttext

Die Antwort beim Aktualisieren eines Wertebereichs in einer Tabelle.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
Felder
spreadsheetId

string

Die Tabelle, auf die die Aktualisierungen angewendet wurden.

tableRange

string

Der Bereich der Tabelle (in A1-Notation), in dem die Werte angehängt werden (bevor die Werte angehängt wurden). Leer, wenn keine Tabelle gefunden wurde.

updates

object (UpdateValuesResponse)

Informationen zu den angewendeten Aktualisierungen.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

InsertDataOption

Legt fest, wie vorhandene Daten bei der Eingabe neuer Daten geändert werden.

Enums
OVERWRITE Die neuen Daten überschreiben vorhandene Daten in den geschriebenen Bereichen. Hinweis: Wenn Sie Daten am Ende des Tabellenblatts hinzufügen, werden trotzdem neue Zeilen oder Spalten eingefügt, damit die Daten geschrieben werden können.
INSERT_ROWS Für die neuen Daten werden Zeilen eingefügt.