API Google Trang tính cho phép bạn cập nhật định dạng của các ô và dải ô trong bảng tính. Các ví dụ trên trang này minh hoạ mức độ phổ biến Bạn có thể thực hiện các thao tác định dạng bằng API Trang tính. Bạn có thể tìm thêm ví dụ về định dạng có điều kiện trong câu lệnh Định dạng có điều kiện trang công thức định dạng.
Khi cập nhật bảng tính, một số loại yêu cầu có thể trả về phản hồi.
Các kết quả này được trả về trong một mảng, với mỗi phản hồi chiếm cùng một chỉ mục
yêu cầu tương ứng. Một số yêu cầu không có phản hồi và đối với những yêu cầu
phản hồi trống. Bạn có thể xem cấu trúc phản hồi cho các ví dụ này trong
spreadsheets.batchUpdate.
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.
Trong video trên, bạn tìm hiểu cách định dạng ô trong bảng tính theo nhiều cách, bao gồm: tạo hàng cố định, in đậm ô, triển khai đơn vị tiền tệ định dạng, thực hiện xác thực ô và giới hạn giá trị của ô.
Chỉnh sửa đường viền ô
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
UpdateBordersRequest
để tạo đường viền trên và dưới màu xanh lam cho mỗi ô trong dải ô A1:F10 có nét đứt. Chiến lược phát hành đĩa đơn
Trường innerHorizontal tạo đường viền ngang ở phía bên trong dải ô.
Nếu bạn bỏ qua trường này, đường viền sẽ chỉ được thêm vào phần trên cùng và
cuối toàn bộ dải ô.
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": [
{
"updateBorders": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 6
},
"top": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"bottom": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"innerHorizontal": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
}
}
]
}
Định dạng hàng tiêu đề
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
RepeatCellRequest
để định dạng hàng tiêu đề trong trang tính. Yêu cầu đầu tiên cập nhật màu văn bản,
màu nền, cỡ chữ và phần giải thích của văn bản
in đậm văn bản. Việc bỏ qua các chỉ mục cột trong trường range sẽ khiến toàn bộ
hàng cần định dạng. Yêu cầu thứ hai điều chỉnh thuộc tính trang tính để
hàng tiêu đề bị cố đị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": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 1
},
"cell": {
"userEnteredFormat": {
"backgroundColor": {
"red": 0.0,
"green": 0.0,
"blue": 0.0
},
"horizontalAlignment" : "CENTER",
"textFormat": {
"foregroundColor": {
"red": 1.0,
"green": 1.0,
"blue": 1.0
},
"fontSize": 12,
"bold": true
}
}
},
"fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)"
}
},
{
"updateSheetProperties": {
"properties": {
"sheetId": SHEET_ID,
"gridProperties": {
"frozenRowCount": 1
}
},
"fields": "gridProperties.frozenRowCount"
}
}
]
}
Hợp nhất ô
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
MergeCellsRequest
để hợp nhất các ô. Yêu cầu đầu tiên hợp nhất dải ô A1:B2 thành một ô duy nhất. Chiến lược phát hành đĩa đơn
yêu cầu thứ hai sẽ hợp nhất các cột trong A3:B6, còn các hàng được tách riêng.
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": [
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 2,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_ALL"
}
},
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 2,
"endRowIndex": 6,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_COLUMNS"
}
},
]
}
Đặt định dạng ngày giờ hoặc định dạng thập phân tuỳ chỉnh cho một dải ô
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
RepeatCellRequest
cập nhật các ô để có định dạng ngày và số tuỳ chỉnh. Yêu cầu đầu tiên
cung cấp cho các ô trong dải ô A1:A10 định dạng ngày giờ tuỳ chỉnh hh:mm:ss am/pm,
ddd mmm dd yyyy. Ví dụ về ngày giờ ở định dạng này là: "02:05:07 CH, Chủ Nhật tháng 4
03 năm 2016".
Yêu cầu thứ hai cung cấp cho các ô trong B1:B10 định dạng số tuỳ chỉnh
#,##0.0000 cho biết cần nhóm các số bằng dấu phẩy
dấu phân cách, phải có 4 chữ số sau dấu thập phân và tất cả trừ
bạn nên bỏ một số 0 ở đầu. Ví dụ: số "3, 14" hiển thị
là "3.1400", trong khi "12345.12345" được hiển thị dưới dạng "12,345.1235".
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": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 1
},
"cell": {
"userEnteredFormat": {
"numberFormat": {
"type": "DATE",
"pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy"
}
}
},
"fields": "userEnteredFormat.numberFormat"
}
},
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 1,
"endColumnIndex": 2
},
"cell": {
"userEnteredFormat": {
"numberFormat": {
"type": "NUMBER",
"pattern": "#,##0.0000"
}
}
},
"fields": "userEnteredFormat.numberFormat"
}
}
]
}