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