- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- InsertDataOption
- Cobalah!
Menambahkan nilai ke spreadsheet. Rentang input digunakan untuk menelusuri data yang ada dan menemukan "tabel" dalam rentang itu. Nilai akan ditambahkan ke baris tabel berikutnya, dimulai dengan kolom pertama pada tabel. Lihat panduan dan kode contoh untuk mengetahui detail spesifik tentang cara tabel dideteksi dan data ditambahkan.
Pemanggil harus menentukan ID spreadsheet, rentang, dan valueInputOption
. valueInputOption
hanya mengontrol cara data input akan ditambahkan ke sheet (sesuai kolom atau baris), tidak memengaruhi sel mana data mulai ditulis.
Permintaan HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
spreadsheetId |
ID spreadsheet yang akan diperbarui. |
range |
Notasi A1 rentang untuk menelusuri tabel data logis. Nilai ditambahkan setelah baris terakhir tabel. |
Parameter kueri
Parameter | |
---|---|
valueInputOption |
Bagaimana data input harus ditafsirkan. |
insertDataOption |
Cara memasukkan data input. |
includeValuesInResponse |
Menentukan apakah respons update harus menyertakan nilai sel yang ditambahkan. Secara default, respons tidak menyertakan nilai yang diperbarui. |
responseValueRenderOption |
Menentukan bagaimana nilai dalam respons harus dirender. Opsi render default adalah |
responseDateTimeRenderOption |
Menentukan bagaimana tanggal, waktu, dan durasi respons seharusnya dirender. Pesan ini diabaikan jika |
Isi permintaan
Isi permintaan memuat instance ValueRange
.
Isi respons
Respons saat memperbarui rentang nilai dalam spreadsheet.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
Kolom | |
---|---|
spreadsheetId |
Spreadsheet tempat pembaruan diterapkan. |
tableRange |
Rentang (dalam notasi A1) tabel tempat nilai ditambahkan (sebelum nilai ditambahkan). Kosong jika tidak ada tabel yang ditemukan. |
updates |
Informasi tentang pembaruan yang diterapkan. |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Untuk informasi selengkapnya, lihat Panduan otorisasi.
InsertDataOption
Menentukan bagaimana data yang ada berubah ketika data baru dimasukkan.
Enum | |
---|---|
OVERWRITE |
Data baru akan menimpa data yang ada di area yang ditulis. (Catatan: menambahkan data ke akhir sheet masih akan menyisipkan baris atau kolom baru sehingga data bisa ditulis.) |
INSERT_ROWS |
Baris disisipkan untuk data baru. |