- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Option „Daten einfügen“
- Testen!
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 |
Die ID der zu aktualisierenden Tabelle. |
range |
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 |
Wie die Eingabedaten interpretiert werden sollen. |
insertDataOption |
Die Art der Eingabe der Eingabedaten. |
includeValuesInResponse |
Legt fest, ob die Updateantwort die Werte der angehängten Zellen enthalten soll. Standardmäßig enthalten die Antworten die aktualisierten Werte nicht. |
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. Diese wird ignoriert, wenn |
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 ( |
Felder | |
---|---|
spreadsheetId |
Die Tabelle, auf die die Aktualisierungen angewendet wurden. |
tableRange |
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 |
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. |