Selain data nilai yang terdapat dalam selnya, spreadsheet mencakup banyak jenis data lainnya, seperti:
- Dimensi
- Format sel dan batasnya
- Rentang bernama
- Rentang dilindungi
- Format bersyarat
Ini adalah beberapa dari banyak jenis data yang mengontrol
tampilan dan operasi {i>spreadsheet<i}. Metode spreadsheets.batchUpdate
memungkinkan Anda
memperbarui detail spreadsheet ini. Perubahan dikelompokkan dalam batch sehingga
jika satu permintaan tidak berhasil, tidak satu pun perubahan lainnya (yang mungkin bergantung pada)
yang akan dituliskan.
Halaman ini menjelaskan dasar-dasar penggunaan
metode
spreadsheets.batchUpdate
. Jika perlu membaca dan menulis data nilai sel, Anda juga dapat menggunakan resource
spreadsheets.values
yang dijelaskan dalam Membaca & menulis nilai sel.
Kategori operasi
Operasi tertentu yang didukung oleh spreadsheets.batchUpdate
dapat dikelompokkan ke dalam kategori yang luas berikut:
Kategori | Deskripsi |
---|---|
Add (dan Duplicate) | Menambahkan objek baru (terkadang berdasarkan objek lama, seperti dalam Permintaan duplikat). |
Memperbarui (dan Menetapkan) | Memperbarui properti tertentu dari sebuah objek, biasanya membiarkan properti lama saja (sedangkan permintaan Set menimpa data sebelumnya). |
Hapus | Menghapus objek. |
Kategori-kategori ini digunakan di bagian berikutnya untuk menjelaskan perilaku operasi tertentu.
Operasi update batch
Metode spreadsheets.batchUpdate
bekerja dengan mengambil satu atau beberapa objek Request, yang masing-masing menentukan satu jenis permintaan untuk dilakukan. Ada
banyak jenis permintaan. Berikut adalah perincian jenis permintaan,
yang dikelompokkan ke dalam berbagai kategori.
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 permintaan "update" memerlukan mask kolom. Kolom ini merupakan daftar kolom yang dipisahkan koma yang berfungsi hanya untuk mengupdate kolom tertentu dalam objek tanpa mengubah kolom lainnya. Mask kolom *
diperlakukan seperti karakter pengganti dan merupakan singkatan untuk menentukan setiap kolom dalam pesan (yang berarti kolom dapat kembali ke status defaultnya jika Anda tidak menentukan nilainya dalam permintaan).
Untuk informasi selengkapnya tentang mask kolom, lihat Menggunakan mask
kolom.
Contoh berikut menggunakan
UpdateSpreadsheetPropertiesRequest
untuk memperbarui judul spreadsheet 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 {i>spreadsheet<i}, beberapa jenis permintaan mungkin menampilkan respons. Semua ini ditampilkan dalam array, dengan setiap respons menempati indeks yang sama dengan permintaan yang sesuai. Beberapa permintaan tidak memiliki respons dan untuk permintaan tersebut responsnya kosong.
Biasanya, permintaan "add" memiliki respons yang menampilkan informasi seperti ID 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 variabel
find
danreplacement
.