- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- InsertDataOption
- Testen!
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 |
Die ID der zu aktualisierenden Tabelle. |
range |
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 |
Wie die Eingabedaten interpretiert werden sollen. |
insertDataOption |
Wie die Eingabedaten eingefügt werden sollen. |
includeValuesInResponse |
Bestimmt, ob die Aktualisierungsantwort die Werte der angehängten Zellen enthalten soll. Standardmäßig enthalten Antworten nicht die aktualisierten Werte. |
responseValueRenderOption |
Legt fest, wie Werte in der Antwort gerendert werden. Die Standardoption für das Rendering ist |
responseDateTimeRenderOption |
Legt fest, wie Datum, Uhrzeit und Dauer in der Antwort gerendert werden. Dies wird ignoriert, wenn |
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 ( |
Felder | |
---|---|
spreadsheetId |
Tabelle, auf die die Aktualisierungen angewendet wurden |
tableRange |
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 |
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. |