Method: spreadsheets.values.append

Hängt Werte an eine Tabelle an. Im Eingabebereich wird nach vorhandenen Daten gesucht und eine „Tabelle“ in diesem Bereich gefunden. Die Werte werden der nächsten Zeile der Tabelle angehängt, beginnend mit der ersten Spalte der Tabelle. Weitere Informationen dazu, wie Tabellen erkannt und Daten angehängt werden, finden Sie im Leitfaden und im Beispielcode.

Der Aufrufer muss die Tabellen-ID, den Bereich und eine valueInputOption angeben. Mit valueInputOption wird nur festgelegt, wie die Eingabedaten in die Tabelle eingefügt werden (spaltenweise oder zeilenweise). Es hat keinen Einfluss darauf, in welche Zelle die Daten zuerst 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 Tabelle, die aktualisiert werden soll.
range

string

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

Abfrageparameter

Parameter
valueInputOption

enum (ValueInputOption)

Wie die Eingabedaten interpretiert werden sollen.
insertDataOption

enum (InsertDataOption)

Wie die Eingabedaten eingefügt werden sollen.
includeValuesInResponse

boolean

Bestimmt, ob die Antwort auf die Aktualisierung die Werte der angehängten Zellen enthalten soll. Standardmäßig enthalten Antworten keine aktualisierten Werte.
responseValueRenderOption

enum (ValueRenderOption)

Bestimmt, wie Werte in der Antwort gerendert werden sollen. Die Standard-Rendering-Option ist FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Bestimmt, wie Datumsangaben, Uhrzeiten und Zeiträume in der Antwort dargestellt werden sollen. Dieser Wert wird ignoriert, wenn responseValueRenderOption FORMATTED_VALUE ist. Die Standardoption für die dateTime-Darstellung 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 Änderungen angewendet wurden.
tableRange

string

Der Bereich (in A1-Notation) der Tabelle, der Werte angehängt werden (vor dem Anhängen der Werte). Leer, wenn keine Tabelle gefunden wurde.
updates

object (UpdateValuesResponse)

Informationen zu den angewendeten Updates.

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

Bestimmt, wie vorhandene Daten geändert werden, wenn neue Daten eingegeben werden.

Enums
OVERWRITE Die neuen Daten überschreiben vorhandene Daten in den Bereichen, in die sie geschrieben werden. 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.