Google Sheets API memungkinkan Anda menambahkan, menghapus, dan mengubah baris serta kolom dalam sheet. Contoh di halaman ini menggambarkan cara beberapa operasi baris dan kolom umum dapat dilakukan dengan Sheets API.
Contoh-contoh ini ditampilkan dalam bentuk permintaan HTTP dengan bahasa yang netral. Untuk mempelajari cara mengimplementasikan update batch dalam berbagai bahasa menggunakan library klien Google API, lihat Mengupdate 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 dengan menggunakan
metode spreadsheets.get. Rentang
ditentukan menggunakan notasi A1. Contoh
rentangnya adalah Sheet1!A1:D5.
Menyesuaikan lebar kolom atau tinggi baris
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
UpdateDimensionPropertiesRequest
untuk memperbarui properti lebar kolom A menjadi 160 piksel. Permintaan kedua memperbarui
properti tinggi baris untuk tiga baris pertama menjadi 40 piksel. Kolom dimension
menentukan apakah operasi berlaku pada kolom atau baris
sheet.
Protokol permintaan ditampilkan di bawah ini.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"properties": {
"pixelSize": 160
},
"fields": "pixelSize"
}
},
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"properties": {
"pixelSize": 40
},
"fields": "pixelSize"
}
}
]
}
Tambahkan baris atau kolom kosong
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
AppendDimensionRequest
untuk menambahkan baris dan kolom. Permintaan pertama menambahkan tiga baris kosong ke
akhir sheet, sedangkan permintaan kedua menambahkan satu kolom kosong. Kolom dimension
menentukan apakah operasi berlaku pada kolom atau baris
sheet.
Protokol permintaan ditampilkan di bawah ini.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"length": 3
}
},
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"length": 1
}
}
]
}
Mengubah ukuran kolom secara otomatis
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
AutoResizeDimensionsRequest
untuk mengubah ukuran kolom A:C, berdasarkan ukuran konten kolom. Kolom dimension
menunjukkan bahwa operasi berlaku pada kolom sheet.
Protokol permintaan ditampilkan di bawah ini.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Mengubah ukuran baris secara otomatis
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
AutoResizeDimensionsRequest
untuk mengosongkan tinggi baris dari tiga baris pertama. Ketinggian baris kemudian bertambah secara
dinamis berdasarkan isi sel di setiap baris. Kolom dimension
menunjukkan bahwa operasi berlaku untuk baris sheet.
Protokol permintaan ditampilkan di bawah ini.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Menghapus baris atau kolom
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
DeleteDimensionRequest
untuk menghapus tiga baris pertama dalam sheet. Permintaan kedua menghapus kolom B:D.
Kolom dimension menentukan apakah operasi berlaku untuk kolom atau baris pada sheet.
Protokol permintaan ditampilkan di bawah ini.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
},
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 1,
"endIndex": 4
}
}
},
],
}
Sisipkan baris atau kolom kosong
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
InsertDimensionRequest
untuk menyisipkan kolom atau baris pada indeks tertentu (seperti menambahkan baris kosong
di bagian atas sheet). Permintaan pertama menyisipkan dua kolom kosong di kolom C.
Permintaan kedua menyisipkan tiga baris kosong yang dimulai dari baris 1.
Kolom dimension menentukan apakah operasi berlaku untuk kolom atau baris pada sheet.
Jika true (benar), kolom inheritFromBefore akan memberi tahu Sheets API untuk memberi kolom atau baris baru properti yang sama dengan baris atau kolom sebelumnya, dan jika salah, untuk mewarisi dari dimensi setelah kolom atau baris baru.
inheritFromBefore tidak bisa bernilai benar jika menyisipkan baris di baris 1 atau kolom di
kolom A.
Protokol permintaan ditampilkan di bawah ini.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 2,
"endIndex": 4
},
"inheritFromBefore": true
}
},
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"inheritFromBefore": false
}
},
],
}
Memindahkan baris atau kolom
Contoh kode
spreadsheets.batchUpdate
berikut menunjukkan cara menggunakan
MoveDimensionRequest
untuk memindahkan kolom A ke posisi kolom D. Permintaan kedua memindahkan baris
5–10 ke posisi baris 20.
Kolom dimension menentukan apakah operasi berlaku untuk kolom atau baris pada sheet. Kolom destinationIndex menentukan tempat untuk memindahkan
data sumber menggunakan indeks awal berbasis nol.
Protokol permintaan ditampilkan di bawah ini.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"destinationIndex": 3
}
},
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 4,
"endIndex": 10
},
"destinationIndex": 19
}
},
],
}