API Google Trang tính cho phép bạn thêm, xoá và thao tác với các hàng và cột trong trang tính. Các ví dụ trên trang này minh hoạ cách thực hiện một số thao tác phổ biến với hàng và cột bằng API Trang tính.
Các ví dụ này được trình bày dưới dạng yêu cầu HTTP để không phụ thuộc vào ngôn ngữ. Để tìm hiểu cách triển khai bản cập nhật theo lô bằng nhiều ngôn ngữ thông qua thư viện ứng dụng API Google, hãy xem bài viết Cập nhật bảng tính.
Trong các ví dụ này, trình giữ chỗ SPREADSHEET_ID và SHEET_ID
cho biết vị trí bạn sẽ cung cấp các mã nhận dạng đó. Bạn có thể tìm thấy mã nhận dạng
bảng tính trong URL của bảng tính. Bạn có thể lấy
mã nhận dạng trang tính bằng cách sử dụng
spreadsheets.get phương thức. Các
dải ô được chỉ định bằng ký hiệu A1. Ví dụ về dải ô là Trang tính1!A1:D5.
Điều chỉnh chiều rộng cột hoặc chiều cao hàng
Đoạn mã mẫu
spreadsheets.batchUpdate
sau đây cho biết cách sử dụng
UpdateDimensionPropertiesRequest
để cập nhật thuộc tính chiều rộng của cột A thành 160 pixel. Yêu cầu thứ hai cập nhật thuộc tính chiều cao hàng của 3 hàng đầu tiên thành 40 pixel. Trường dimension xác định liệu thao tác có áp dụng cho các cột hay hàng của một trang tính hay không.
Giao thức yêu cầu được trình bày bên dưới.
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"
}
}
]
}Nối thêm hàng hoặc cột trống
Đoạn mã mẫu sau đây
spreadsheets.batchUpdate
cho biết cách sử dụng
AppendDimensionRequest
để nối thêm hàng và cột. Yêu cầu đầu tiên nối thêm 3 hàng trống vào cuối một trang tính, trong khi yêu cầu thứ hai nối thêm một cột trống. Trường dimension xác định liệu thao tác có áp dụng cho các cột hay hàng của một trang tính hay không.
Giao thức yêu cầu được trình bày bên dưới.
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
}
}
]
}Tự động đổi kích thước cột
Đoạn mã mẫu sau đây
spreadsheets.batchUpdate
cho biết cách sử dụng
AutoResizeDimensionsRequest
để đổi kích thước cột A:C dựa trên kích thước nội dung cột. Trường dimension cho biết rằng thao tác này áp dụng cho các cột của trang tính.
Giao thức yêu cầu được trình bày bên dưới.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}Tự động đổi kích thước hàng
Đoạn mã mẫu sau đây
spreadsheets.batchUpdate
cho biết cách sử dụng
AutoResizeDimensionsRequest
để xoá chiều cao hàng của 3 hàng đầu tiên. Sau đó, chiều cao hàng sẽ tăng lên một cách linh hoạt dựa trên nội dung của các ô trong mỗi hàng. Trường dimension cho biết rằng thao tác này áp dụng cho các hàng của trang tính.
Giao thức yêu cầu được trình bày bên dưới.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}Xoá hàng hoặc cột
Đoạn mã mẫu sau đây
spreadsheets.batchUpdate
cho biết cách sử dụng
DeleteDimensionRequest
để xoá 3 hàng đầu tiên trong một trang tính. Yêu cầu thứ hai xoá các cột B:D.
Trường dimension xác định liệu thao tác có áp dụng cho các cột hay hàng của một trang tính hay không.
Giao thức yêu cầu được trình bày bên dưới.
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
}
}
},
],
}Chèn hàng hoặc cột trống
Đoạn mã mẫu sau đây
spreadsheets.batchUpdate
cho biết cách sử dụng
InsertDimensionRequest
để chèn cột hoặc hàng tại một chỉ mục cụ thể (chẳng hạn như thêm hàng trống
vào đầu trang tính). Yêu cầu đầu tiên chèn 2 cột trống vào cột C.
Yêu cầu thứ hai chèn 3 hàng trống bắt đầu từ hàng 1.
Trường dimension xác định liệu thao tác có áp dụng cho các cột hay hàng của một trang tính hay không.
Nếu đúng, trường inheritFromBefore sẽ yêu cầu API Trang tính cấp cho các cột hoặc hàng mới các thuộc tính giống như hàng hoặc cột trước đó và nếu sai, thì sẽ kế thừa từ các chiều sau các cột hoặc hàng mới.
inheritFromBefore không thể đúng nếu chèn một hàng vào hàng 1 hoặc một cột vào cột A.
Giao thức yêu cầu được trình bày bên dưới.
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
}
},
],
}Di chuyển hàng hoặc cột
Đoạn mã mẫu
spreadsheets.batchUpdate
sau đây cho biết cách sử dụng
MoveDimensionRequest
để di chuyển cột A đến vị trí cột D. Yêu cầu thứ hai di chuyển các hàng 5–10 đến vị trí hàng 20.
Trường dimension xác định liệu thao tác có áp dụng cho các cột hay hàng của một trang tính hay không. Trường destinationIndex xác định vị trí di chuyển dữ liệu nguồn bằng chỉ mục bắt đầu dựa trên 0.
Giao thức yêu cầu được trình bày bên dưới.
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
}
},
],
}