Method: spreadsheets.values.append

Hängt Werte an eine Tabelle an. Der Eingabebereich wird verwendet, um nach vorhandenen Daten zu suchen und eine „Tabelle“ innerhalb dieses Bereichs zu finden. 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 einen valueInputOption angeben. Mit valueInputOption wird nur festgelegt, wie die Eingabedaten zum Tabellenblatt hinzugefügt werden (spalten- oder zeilenweise). 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 für die Suche nach einer logischen Datentabelle. Die 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 Aktualisierungsantwort die Werte der angehängten Zellen enthalten soll. Standardmäßig enthalten Antworten nicht die aktualisierten Werte.
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. Dies wird ignoriert, wenn responseValueRenderOption FORMATTED_VALUE ist. Die standardmäßige Renderingoption für dateTime ist SERIAL_NUMBER.

Anfragetext

Der Anfragetext enthält eine Instanz von ValueRange.

Antworttext

Die Antwort beim Aktualisieren eines Wertebereichs in einer Tabellenkalkulation.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

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

string

Tabelle, auf die die Aktualisierungen angewendet wurden
tableRange

string

Der Bereich (in A1-Notation) der Tabelle, 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 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 die vorhandenen Daten in den Bereichen, in denen 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.