Method: spreadsheets.values.append

Fügt Werte an eine Tabelle an. Der Eingabebereich wird verwendet, um nach vorhandenen Daten und einer „Tabelle“ zu suchen innerhalb dieses Bereichs. Die Werte werden an die nächste 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. Die valueInputOption steuert nur, wie die Eingabedaten dem Tabellenblatt (spalten- oder zeilenweise) hinzugefügt werden. Sie hat keinen Einfluss darauf, 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. Werte werden nach der letzten 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 Updateantwort die Werte der angehängten Zellen enthalten soll. Standardmäßig enthalten die Antworten nicht die aktualisierten Werte.
responseValueRenderOption

enum (ValueRenderOption)

Bestimmt, wie Werte in der Antwort gerendert werden sollen. Die Standardeinstellung für das Rendering ist FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Legt fest, wie Datum, Uhrzeit und Dauer in der Antwort gerendert werden sollen. Dies wird ignoriert, wenn responseValueRenderOption den Wert FORMATTED_VALUE hat. Die standardmäßige Renderingoption für „dateTime“ ist SERIAL_NUMBER.

Anfragetext

Der Anfragetext enthält eine Instanz von ValueRange.

Antworttext

Die Antwort, wenn ein Wertebereich in einer Tabelle aktualisiert wird.

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-Schreibweise), an den Werte angehängt werden (vor dem Anhängen der Werte). 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

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 weiterhin neue Zeilen oder Spalten eingefügt, sodass die Daten geschrieben werden können.)
INSERT_ROWS Für die neuen Daten werden Zeilen eingefügt.