Google Sheets API memungkinkan Anda menambahkan, menghapus, dan memanipulasi baris dan kolom dalam sheet. Contoh pada halaman ini mengilustrasikan bagaimana beberapa operasi baris dan kolom umum dapat dilakukan dengan Sheets API.
Contoh-contoh ini disajikan dalam bentuk permintaan HTTP dengan bahasa yang netral. Untuk mempelajari cara menerapkan 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 menggunakan
metode spreadsheets.get. Rentang ditentukan menggunakan notasi A1. Contoh
rentang 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 dari tiga baris pertama menjadi 40 piksel. Kolom dimension menentukan apakah operasi berlaku untuk 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"
}
}
]
}
Menambahkan 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 yang kedua menambahkan satu kolom kosong. Kolom dimension menentukan apakah operasi berlaku untuk 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 untuk 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 menghapus tinggi baris dari tiga baris pertama. Tinggi baris kemudian akan meningkat
secara dinamis berdasarkan konten 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 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
}
}
},
],
}
Menyisipkan 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 sheet.
Jika benar, kolom inheritFromBefore akan memberi tahu Sheets API untuk memberikan properti yang sama pada kolom atau baris baru seperti baris atau kolom sebelumnya, dan jika salah, akan mewarisi dari dimensi setelah kolom atau baris baru.
inheritFromBefore tidak boleh 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 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
}
},
],
}