Method: spreadsheets.values.append

Menambahkan nilai ke spreadsheet. Rentang input digunakan untuk menelusuri data yang ada dan menemukan "tabel" dalam rentang tersebut. Nilai akan ditambahkan ke baris tabel berikutnya, dimulai dengan kolom pertama tabel. Lihat panduan dan kode contoh untuk mengetahui detail spesifik tentang cara tabel terdeteksi dan data ditambahkan.

Pemanggil harus menentukan ID spreadsheet, rentang, dan valueInputOption. valueInputOption hanya mengontrol cara data input akan ditambahkan ke sheet (dari sisi 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

string

ID spreadsheet yang akan diperbarui.
range

string

Notasi A1 rentang untuk menelusuri tabel data yang logis. Nilai ditambahkan setelah baris terakhir tabel.

Parameter kueri

Parameter
valueInputOption

enum (ValueInputOption)

Cara data input harus ditafsirkan.
insertDataOption

enum (InsertDataOption)

Cara data input harus dimasukkan.
includeValuesInResponse

boolean

Menentukan apakah respons update harus menyertakan nilai sel yang ditambahkan. Secara default, respons tidak menyertakan nilai yang diperbarui.
responseValueRenderOption

enum (ValueRenderOption)

Menentukan bagaimana nilai dalam respons harus dirender. Opsi render default adalah FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Menentukan bagaimana tanggal, waktu, dan durasi dalam respons harus dirender. Ini diabaikan jika responseValueRenderOption adalah FORMATTED_VALUE. Opsi render dateTime default adalah SERIAL_NUMBER.

Isi permintaan

Isi permintaan memuat instance ValueRange.

Isi respons

Respons ketika memperbarui rentang nilai dalam spreadsheet.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
Kolom
spreadsheetId

string

Spreadsheet yang menerapkan pembaruan tersebut.
tableRange

string

Rentang (dalam notasi A1) pada tabel yang nilainya ditambahkan (sebelum nilai ditambahkan). Kosong jika tabel tidak ditemukan.
updates

object (UpdateValuesResponse)

Informasi tentang update yang telah 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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.

Opsi SisipkanData

Menentukan bagaimana data yang ada diubah saat data baru dimasukkan.

Enumerasi
OVERWRITE Data baru akan menimpa data yang sudah ada di area penulisannya. (Catatan: menambahkan data ke akhir sheet tetap akan menyisipkan baris atau kolom baru sehingga data dapat ditulis.)
INSERT_ROWS Baris disisipkan untuk data baru.