Selain data nilai yang terkandung di dalam sel-selnya, spreadsheet mencakup berbagai jenis lainnya besar, seperti:
- Dimensi
- Format dan batas sel
- Rentang bernama
- Rentang dilindungi
- Format bersyarat
Ini adalah beberapa jenis data yang mengontrol penampilan dan
operasi {i>spreadsheet<i}. Metode spreadsheets.batchUpdate
memungkinkan Anda
memperbarui detail {i>spreadsheet<i} tersebut. Perubahan dikelompokkan
dalam sebuah batch sehingga
jika satu permintaan gagal, tidak ada permintaan lainnya (kemungkinan dependen)
perubahan tersebut ditulis.
Halaman ini menjelaskan dasar-dasar penggunaan
spreadsheets.batchUpdate
. Jika Anda perlu membaca dan menulis data nilai sel, Anda juga dapat menggunakan
spreadsheets.values
yang dijelaskan dalam artikel Baca & menulis nilai sel.
Kategori operasi
Operasi tertentu yang didukung oleh spreadsheets.batchUpdate
dapat dikelompokkan
menjadi kategori yang luas berikut:
Kategori | Deskripsi |
---|---|
Add (dan Duplicate) | Menambahkan objek baru (terkadang berdasarkan objek lama, seperti pada Permintaan duplikat). |
Update (dan Set) | Memperbarui properti tertentu dari sebuah objek, biasanya membiarkan properti lama saja (sedangkan permintaan Set akan menimpa data sebelumnya). |
Hapus | Hapus objek. |
Kategori-kategori ini digunakan di bagian selanjutnya untuk menggambarkan perilaku operasi tertentu.
Operasi update batch
Metode spreadsheets.batchUpdate
berfungsi dengan mengambil satu atau beberapa
Minta
objek, masing-masing menetapkan satu jenis permintaan untuk dilakukan. Ada
berbagai jenis permintaan. Berikut ini adalah rincian
tentang jenis permintaan,
yang dikelompokkan ke dalam
kategori yang berbeda.
Ada juga beberapa permintaan tambahan yang meniru tindakan pengguna untuk memanipulasi data:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Batas
Untuk mempelajari lebih lanjut batas sel dan baris di Google Spreadsheet, lihat File yang dapat Anda simpan di Google Drive.
Mask kolom
Banyak sistem "update" memerlukan mask kolom. Tabel ini dipisahkan oleh koma
daftar kolom untuk memperbarui hanya kolom tertentu dalam objek sambil membiarkan
{i>field<i} lainnya tidak berubah. Mask kolom *
diperlakukan seperti
{i>wildcard <i}dan merupakan singkatan untuk menentukan setiap {i>field<i} dalam pesan (yang berarti
suatu {i>field<i} dapat dikembalikan ke keadaan {i>default<i} jika
Anda tidak menetapkan nilainya di
permintaan).
Untuk informasi selengkapnya tentang mask kolom, lihat Menggunakan kolom
mask.
Contoh berikut menggunakan
UpdateSpreadsheetPropertiesRequest
untuk memperbarui judul {i>spreadsheet<i} saja:
Permintaan:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
Isi permintaan:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
Ganti TITLE dengan judul baru spreadsheet.
Respons
Saat memperbarui spreadsheet, beberapa jenis permintaan mungkin menampilkan respons. Ini dikembalikan dalam himpunan (array), dengan masing-masing respons menempati indeks yang sama dengan permintaan terkait. Beberapa permintaan tidak memiliki respons, dan untuk yang kosong.
Biasanya, "tambahkan" permintaan memiliki respons yang menampilkan informasi seperti ID dari objek yang ditambahkan. Untuk daftar respons yang didukung, lihat Respons.
Contoh
Contoh kode berikut melakukan tindakan ini:
- Perbarui judul spreadsheet menggunakan variabel
title
. - Menemukan dan mengganti nilai sel dalam spreadsheet menggunakan
find
dan Variabelreplacement
.