Google Sheets API memungkinkan Anda menambah, menghapus, dan memanipulasi baris dan kolom di spreadsheet. Contoh pada halaman ini menggambarkan bagaimana beberapa baris dan kolom umum dapat dijalankan dengan Sheets API.
Contoh ini disajikan dalam bentuk permintaan HTTP untuk memilih bahasa netral. Untuk mempelajari cara mengimplementasikan update secara batch dalam berbagai bahasa menggunakan library klien Google API, lihat Memperbarui di spreadsheet.
Dalam contoh ini, placeholder SPREADSHEET_ID
dan SHEET_ID
menunjukkan di mana Anda akan memberikan ID tersebut. Anda dapat menemukan spreadsheet
ID di URL spreadsheet. Anda bisa mendapatkan
sheet ID dengan menggunakan
Metode spreadsheets.get
. Tujuan
rentang ditentukan menggunakan notasi A1. Channel
contohnya adalah Sheet1!A1:D5.
Menyesuaikan lebar kolom atau tinggi baris
Hal berikut
spreadsheets.batchUpdate
contoh kode 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. dimension
menentukan apakah operasi berlaku untuk kolom atau baris dari
{i>sheet<i}.
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
Hal berikut
spreadsheets.batchUpdate
contoh kode menunjukkan cara menggunakan
AppendDimensionRequest
untuk menambahkan baris dan kolom. Permintaan pertama menambahkan tiga baris kosong ke
akhir {i>sheet<i}, sementara yang kedua menambahkan
satu kolom kosong. dimension
menentukan apakah operasi berlaku untuk kolom atau baris dari
{i>sheet<i}.
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
Hal berikut
spreadsheets.batchUpdate
contoh kode menunjukkan cara menggunakan
AutoResizeDimensionsRequest
untuk mengubah ukuran kolom A:C, berdasarkan ukuran konten kolom. dimension
menunjukkan bahwa operasi berlaku untuk kolom-kolom pada {i>sheet<i} tersebut.
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
Hal berikut
spreadsheets.batchUpdate
contoh kode menunjukkan cara menggunakan
AutoResizeDimensionsRequest
untuk membersihkan tinggi baris dari tiga baris pertama. Ketinggian baris kemudian bertambah
secara dinamis berdasarkan konten sel di setiap baris. dimension
menunjukkan bahwa operasi berlaku untuk baris-baris pada {i>sheet<i} tersebut.
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
Hal berikut
spreadsheets.batchUpdate
contoh kode menunjukkan cara menggunakan
DeleteDimensionRequest
untuk menghapus tiga baris
pertama dalam {i>sheet<i}. Permintaan kedua menghapus kolom B:D.
Kolom dimension
menentukan apakah operasi berlaku untuk kolom atau
baris pada
{i>sheet<i}.
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
Hal berikut
spreadsheets.batchUpdate
contoh kode 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
{i>sheet<i}.
Jika benar, kolom inheritFromBefore
akan memberi tahu Sheets API untuk memberi
kolom atau baris baru memiliki properti yang sama dengan baris atau kolom sebelumnya dan jika
false, untuk mewarisi dari dimensi setelah kolom atau baris baru.
inheritFromBefore
tidak boleh 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
Hal berikut
spreadsheets.batchUpdate
contoh kode menunjukkan cara menggunakan
MoveDimensionRequest
untuk memindahkan kolom A
ke posisi kolom D. Permintaan kedua memindahkan baris
5-10 pada posisi baris 20.
Kolom dimension
menentukan apakah operasi berlaku untuk kolom atau
baris pada
{i>sheet<i}. Kolom destinationIndex
menentukan tempat untuk memindahkan
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 } }, ], }