Google Trang tính API cho phép bạn tạo, sửa đổi và xoá các dải ô được đặt tên hoặc được bảo vệ. Các ví dụ trên trang này minh hoạ cách bạn có thể thực hiện một số thao tác phổ biến trên Trang tính bằng Sheets API.
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 một bản cập nhật hàng loạt bằng nhiều ngôn ngữ bằ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 các ví dụ này, phần giữ chỗ SPREADSHEET_ID và SHEET_ID cho biết vị trí mà 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 phương thức spreadsheets.get. Các dải ô được chỉ định bằng ký hiệu A1. Ví dụ về dải ô là Trang_tính1!A1:D5.
Ngoài ra, các phần giữ chỗ NAMED_RANGE_ID và PROTECTED_RANGE_ID cung cấp mã nhận dạng cho các dải ô được đặt tên và được bảo vệ. namedRangeId và protectedRangeId được dùng khi đưa ra yêu cầu cập nhật hoặc xoá các dải ô được liên kết. Mã nhận dạng này được trả về trong phản hồi cho một yêu cầu Sheets API tạo một dải ô được đặt tên hoặc được bảo vệ. Bạn có thể lấy mã nhận dạng của các dải ô hiện có bằng phương thức spreadsheets.get trong nội dung phản hồi Spreadsheet.
Thêm dải ô được đặt tên hoặc được bảo vệ
Mã mẫu spreadsheets.batchUpdate sau đây cho biết cách sử dụng 2 đối tượng yêu cầu. Lệnh đầu tiên sử dụng AddNamedRangeRequest để chỉ định tên "Counts" cho dải ô A1:E3. Lệnh thứ hai sử dụng AddProtectedRangeRequest để đính kèm một biện pháp bảo vệ ở cấp cảnh báo vào dải ô A4:E4. Mức bảo vệ này vẫn cho phép chỉnh sửa các ô trong dải ô, nhưng sẽ nhắc nhở bằng cảnh báo trước khi thực hiện thay đổi.
Các yêu cầu này trả về một AddNamedRangeResponse và một AddProtectedRangeResponse, chứa các mã nhận dạng và thuộc tính của phạm vi.
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": [
{
"addNamedRange": {
"namedRange": {
"name": "Counts",
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 3,
"startColumnIndex": 0,
"endColumnIndex": 5,
},
}
}
},
{
"addProtectedRange": {
"protectedRange": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 3,
"endRowIndex": 4,
"startColumnIndex": 0,
"endColumnIndex": 5,
},
"description": "Protecting total row",
"warningOnly": true
}
}
}
]
}Xoá dải ô được đặt tên hoặc được bảo vệ
Mã mẫu spreadsheets.batchUpdate sau đây cho biết cách sử dụng 2 đối tượng yêu cầu. Phương thức đầu tiên dùng DeleteNamedRangeRequest để xoá một dải ô có tên hiện có, bằng cách dùng NAMED_RANGE_ID từ một lệnh gọi API trước đó. Lệnh thứ hai sử dụng DeleteProtectedRangeRequest để xoá một phạm vi bảo vệ hiện có, bằng cách sử dụng PROTECTED_RANGE_ID từ một lệnh gọi API trước đó.
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": [
{
"deleteNamedRange": {
"namedRangeId": "NAMED_RANGE_ID",
}
},
{
"deleteProtectedRange": {
"protectedRangeId": PROTECTED_RANGE_ID,
}
}
]
}Cập nhật dải ô được đặt tên hoặc được bảo vệ
Mã mẫu spreadsheets.batchUpdate sau đây cho biết cách sử dụng 2 đối tượng yêu cầu. Lệnh đầu tiên sử dụng UpdateNamedRangeRequest để cập nhật tên của một dải ô được đặt tên hiện có thành "InitialCounts", bằng cách sử dụng NAMED_RANGE_ID từ một lệnh gọi API trước đó. Ví dụ thứ hai sử dụng UpdateProtectedRangeRequest để cập nhật một dải ô được bảo vệ hiện có để dải ô đó hiện bảo vệ cùng một dải ô có tên. Phương thức Editors chỉ cho phép những người dùng có trong danh sách chỉnh sửa các ô đó. Yêu cầu này sử dụng NAMED_RANGE_ID và PROTECTED_RANGE_ID từ các lệnh gọi API trước đó.
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": [ { "updateNamedRange": { "namedRange": { "namedRangeId":NAMED_RANGE_ID, "name": "InitialCounts", }, "fields": "name", } }, { "updateProtectedRange": { "protectedRange": { "protectedRangeId":PROTECTED_RANGE_ID, "namedRangeId":NAMED_RANGE_ID, "warningOnly": false, "editors": { "users": [ "charlie@example.com", "sasha@example.com" ] } }, "fields": "namedRangeId,warningOnly,editors" } } ] }