API Google Trang tính cho phép bạn thao tác với dữ liệu trong bảng tính theo nhiều cách nhiều cách. Hầu hết các chức năng có sẵn cho người dùng làm việc với Giao diện người dùng Trang tính cũng có thể thực hiện với API Trang tính. Các ví dụ trên trang này minh hoạ cách bạn có thể đạt được một số thao tác phổ biến đối với bảng tính với 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.
Áp dụng quy tắc xác thực dữ liệu cho một dải ô
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
SetDataValidationRequest
để áp dụng quy tắc xác thực dữ liệu, trong đó "giá trị > 5", cho mọi ô trong dải ô A1:D10.
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": [
{
"setDataValidation": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"rule": {
"condition": {
"type": "NUMBER_GREATER",
"values": [
{
"userEnteredValue": "5"
}
]
},
"inputMessage": "Value must be > 5",
"strict": true
}
}
}
]
}
Sao chép và dán định dạng ô
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
CopyPasteRequest
Để sao chép định dạng chỉ trong dải ô A1:D10 và dán nó vào dải ô F1:I10
trong cùng một trang tính. Phương thức này sử dụng
Enum PasteType
bằng PASTE_FORMAT để chỉ dán định dạng và xác thực dữ liệu. Chiến lược phát hành đĩa đơn
các giá trị ban đầu trong A1:D10 vẫn không thay đổ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": [
{
"copyPaste": {
"source": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"destination": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 5,
"endColumnIndex": 9
},
"pasteType": "PASTE_FORMAT",
"pasteOrientation": "NORMAL"
}
}
]
}
Cắt và dán ô
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
CutPasteRequest.
Nó cắt phạm vi A1:D10 và sử dụng phương thức
Enum PasteType
bằng PASTE_NORMAL để dán các giá trị, công thức, định dạng và hợp nhất vào
Dải ô F1:I10 trong cùng một trang tính. Nội dung ô của dải ô nguồn ban đầu là
đã bị xó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": [
{
"cutPaste": {
"source": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"destination": {
"sheetId": SHEET_ID,
"rowIndex": 0,
"columnIndex": 5
},
"pasteType": "PASTE_NORMAL"
}
}
]
}
Lặp lại công thức trên một dải ô
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
RepeatCellRequest
để sao chép công thức =FLOOR(A1*PI()) vào dải ô B1:D10. Phạm vi của công thức
tự động tăng lên cho từng hàng và cột trong dải ô, bắt đầu bằng
ô phía trên bên trái. Ví dụ: ô B1 có công thức =FLOOR(A1*PI()), trong khi
ô D6 có công thức =FLOOR(C6*PI()).
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": 1,
"endColumnIndex": 4
},
"cell": {
"userEnteredValue": {
"formulaValue": "=FLOOR(A1*PI())"
}
},
"fields": "userEnteredValue"
}
}
]
}
Sắp xếp một dải ô bằng nhiều quy cách sắp xếp
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
SortRangeRequest
để sắp xếp dải ô A1:D10, trước tiên là theo cột B theo thứ tự tăng dần, sau đó theo cột C
theo thứ tự giảm dần, sau đó là theo cột D theo thứ tự giảm dần.
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": [
{
"sortRange": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"sortSpecs": [
{
"dimensionIndex": 1,
"sortOrder": "ASCENDING"
},
{
"dimensionIndex": 2,
"sortOrder": "DESCENDING"
},
{
"dimensionIndex": 3,
"sortOrder": "DESCENDING"
}
]
}
}
]
}