Google Sheets API memungkinkan Anda memperbarui format sel dan rentang dalam spreadsheet. Contoh di halaman ini mengilustrasikan cara beberapa operasi pemformatan umum dapat dilakukan dengan Sheets API. Anda dapat menemukan contoh pemformatan bersyarat lainnya di halaman petunjuk Pemformatan bersyarat.
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. Struktur respons untuk contoh ini dapat ditemukan di bagian
spreadsheets.batchUpdate.
Contoh ini ditampilkan dalam bentuk permintaan HTTP agar bersifat netral bahasa. Untuk mempelajari cara menerapkan update batch dalam berbagai bahasa menggunakan library klien Google API, lihat Memperbarui spreadsheet.
Dalam contoh ini, placeholder SPREADSHEET_ID dan SHEET_ID
menunjukkan tempat Anda akan memberikan ID tersebut. Anda dapat menemukan ID spreadsheet di URL spreadsheet. Anda bisa mendapatkan
ID sheet menggunakan
metode spreadsheets.get. Rentang ditentukan menggunakan notasi A1. Contoh
rentang adalah Sheet1!A1:D5.
Dalam video di atas, Anda akan mempelajari cara memformat sel spreadsheet dengan berbagai cara, termasuk: membuat baris yang dibekukan, menebalkan sel, menerapkan pemformatan mata uang, melakukan validasi sel, dan membatasi nilai sel.
Mengedit batas sel
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
UpdateBordersRequest
untuk memberi setiap sel dalam rentang A1:F10 batas atas dan bawah putus-putus berwarna biru. Kolom
innerHorizontal membuat batas horizontal di bagian dalam rentang.
Jika kolom dihilangkan, batas hanya akan ditambahkan ke bagian atas dan
bawah seluruh rentang.
Protokol permintaan ditampilkan di bawah.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateBorders": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 6
},
"top": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"bottom": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"innerHorizontal": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
}
}
]
}Memformat baris header
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
RepeatCellRequest
untuk memformat baris header di sheet. Permintaan pertama memperbarui warna teks, warna latar belakang, ukuran font teks, dan justifikasi teks serta membuat
teks tebal. Menghapus indeks kolom di kolom range akan menyebabkan seluruh baris diformat. Permintaan kedua menyesuaikan properti sheet sehingga
baris header dibekukan.
Protokol permintaan ditampilkan di bawah.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "repeatCell": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 1 }, "cell": { "userEnteredFormat": { "backgroundColor": { "red": 0.0, "green": 0.0, "blue": 0.0 }, "horizontalAlignment" : "CENTER", "textFormat": { "foregroundColor": { "red": 1.0, "green": 1.0, "blue": 1.0 }, "fontSize": 12, "bold": true } } }, "fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)" } }, { "updateSheetProperties": { "properties": { "sheetId": SHEET_ID, "gridProperties": { "frozenRowCount": 1 } }, "fields": "gridProperties.frozenRowCount" } } ] }
Gabungkan sel
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
MergeCellsRequest
untuk menggabungkan sel. Permintaan pertama menggabungkan rentang A1:B2 menjadi satu sel. Permintaan kedua menggabungkan kolom di A3:B6, sementara baris tetap terpisah.
Protokol permintaan ditampilkan di bawah.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 2,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_ALL"
}
},
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 2,
"endRowIndex": 6,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_COLUMNS"
}
},
]
}Menetapkan format desimal atau tanggal-waktu kustom untuk rentang
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
RepeatCellRequest
untuk memperbarui sel agar memiliki format tanggal dan waktu serta angka kustom. Permintaan pertama
memberi sel dalam rentang A1:A10 format tanggal waktu kustom hh:mm:ss am/pm,
ddd mmm dd yyyy. Contoh waktu dalam format ini adalah: "22.05.07, Minggu, 03 April
2016".
Permintaan kedua memberi sel di B1:B10 format angka kustom
#,##0.0000, yang menunjukkan bahwa angka harus dikelompokkan dengan pemisah
koma, bahwa harus ada 4 digit setelah desimal, dan bahwa semua kecuali
satu nol di awal harus dihapus. Misalnya, angka "3,14" dirender
sebagai "3,1400", sedangkan "12345,12345" dirender sebagai "12.345,1235".
Protokol permintaan ditampilkan di bawah.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{ "requests": [ { "repeatCell": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 0, "endColumnIndex": 1 }, "cell": { "userEnteredFormat": { "numberFormat": { "type": "DATE", "pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy" } } }, "fields": "userEnteredFormat.numberFormat" } }, { "repeatCell": { "range": { "sheetId": SHEET_ID, "startRowIndex": 0, "endRowIndex": 10, "startColumnIndex": 1, "endColumnIndex": 2 }, "cell": { "userEnteredFormat": { "numberFormat": { "type": "NUMBER", "pattern": "#,##0.0000" } } }, "fields": "userEnteredFormat.numberFormat" } } ] }