Selain data nilai yang terdapat dalam selnya, spreadsheet menyertakan banyak jenis data lainnya, seperti:
- Dimensi
- Format dan batas sel
- Rentang bernama
- Rentang yang dilindungi
- Format bersyarat
Berikut adalah beberapa dari banyak jenis data yang mengontrol tampilan dan
operasi spreadsheet. Metode spreadsheets.batchUpdate
memungkinkan Anda
memperbarui detail spreadsheet ini. Perubahan dikelompokkan dalam batch sehingga
jika satu permintaan tidak berhasil, tidak ada perubahan lain (yang berpotensi bergantung)
yang ditulis.
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 luas berikut:
Kategori | Deskripsi |
---|---|
Tambahkan (dan Duplikasikan) | Menambahkan objek baru (terkadang berdasarkan objek lama, seperti dalam permintaan Duplikat). |
Update (dan Setel) | Memperbarui properti tertentu dari objek, biasanya tanpa mengubah properti lama (sedangkan permintaan Set menimpa data sebelumnya). |
Hapus | Menghapus objek. |
Kategori ini digunakan di bagian berikutnya untuk menjelaskan perilaku operasi tertentu.
Operasi update batch
Metode spreadsheets.batchUpdate
berfungsi dengan mengambil satu atau beberapa objek Request, yang masing-masing menentukan satu jenis permintaan yang akan dilakukan. Ada
berbagai 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" yang memerlukan mask kolom. Ini adalah daftar kolom yang dipisahkan koma untuk hanya memperbarui 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 dikembalikan ke status default-nya jika Anda tidak menentukan nilai untuknya dalam
permintaan).
Untuk mengetahui informasi selengkapnya tentang mask kolom, lihat Menggunakan mask
kolom.
Contoh berikut menggunakan
UpdateSpreadsheetPropertiesRequest
untuk hanya memperbarui judul spreadsheet:
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. Respons 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 "tambahkan" memiliki respons yang menampilkan informasi seperti ID objek yang ditambahkan. Untuk mengetahui daftar respons yang didukung, lihat Respons.
Contoh
Contoh kode berikut melakukan tindakan ini:
- Memperbarui judul spreadsheet menggunakan variabel
title
. - Menemukan dan mengganti nilai sel di spreadsheet menggunakan variabel
find
danreplacement
.