Google Sheets API memungkinkan Anda menambahkan, menghapus, serta memanipulasi baris dan kolom di sheet. Contoh di halaman ini menggambarkan bagaimana beberapa operasi baris dan kolom umum dapat dilakukan dengan Sheets API.
Contoh ini disajikan dalam bentuk permintaan HTTP agar tidak menggunakan bahasa. Untuk mempelajari cara mengimplementasikan update secara 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
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 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 pada tiga baris pertama. Ketinggian baris kemudian bertambah
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
}
}
},
],
}
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 sheet.
Jika true (benar), kolom inheritFromBefore akan memberi tahu Sheets API untuk memberikan
kolom atau baris baru properti yang sama dengan baris atau kolom sebelumnya dan jika
false, untuk mewarisi dari dimensi setelah kolom atau baris baru.
inheritFromBefore tidak dapat 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
}
},
],
}