Selain data nilai yang terdapat dalam selnya, spreadsheet mencakup berbagai jenis data lainnya, seperti:
- Dimensi
- Format dan batas sel
- Rentang bernama
- Rentang dilindungi
- Format bersyarat
Data ini adalah beberapa 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 lainnya (yang mungkin bergantung pada) yang akan 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 beberapa kategori 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 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 banyak jenis permintaan. Berikut ini perincian tentang jenis permintaan,
yang dikelompokkan ke dalam beberapa kategori.
Ada juga beberapa permintaan tambahan yang meniru tindakan pengguna untuk memanipulasi data:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Batas
Untuk mempelajari batas sel dan baris di Google Spreadsheet lebih lanjut, lihat File yang dapat Anda simpan di Google Drive.
Mask kolom
Banyak permintaan "update" memerlukan mask kolom. Daftar ini adalah daftar kolom yang dipisahkan koma untuk memperbarui kolom tertentu saja dalam sebuah 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 default jika Anda tidak menentukan nilainya dalam
permintaan).
Untuk mengetahui 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 spreadsheet, beberapa jenis permintaan mungkin menampilkan respons. Keduanya ditampilkan dalam array, dengan setiap respons menempati indeks yang sama dengan permintaan terkait. 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 mengetahui 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
.