API Google Trang tính cho phép bạn tạo, xoá, sao chép và xoá trang tính, cũng như kiểm soát các tài sản của chúng. 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 trong Trang 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.
Thêm trang tính
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
AddSheetRequest
để thêm trang tính vào bảng tính, đồng thời đặt tiêu đề, kích thước lưới và
màu tab.
Phản hồi bao gồm
AddSheetResponse!
Tệp này chứa một đối tượng có các thuộc tính của trang tính đã tạo (chẳng hạn như
SHEET_ID).
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": [
{
"addSheet": {
"properties": {
"title": "Deposits",
"gridProperties": {
"rowCount": 20,
"columnCount": 12
},
"tabColor": {
"red": 1.0,
"green": 0.3,
"blue": 0.4
}
}
}
}
]
}
Xóa tất cả giá trị một trang tính trong khi vẫn giữ nguyên định dạng
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
UpdateCellsRequest
để xóa tất cả các giá trị khỏi một trang tính mà vẫn giữ nguyên định dạng.
Chỉ định phương diện
Trường userEnteredValue
mà không có giá trị tương ứng được hiểu là một lệnh để xoá các giá trị
trong dải ô. Bạn cũng có thể sử dụng chế độ cài đặt này với các trường khác. Ví dụ:
thay đổi giá trị fields thành
userEnteredFormat lượt xoá
tất cả định dạng mà API Trang tính hỗ trợ
khỏi trang tính nhưng giữ nguyên giá trị củ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": [
{
"updateCells": {
"range": {
"sheetId": SHEET_ID
},
"fields": "userEnteredValue"
}
}
]
}
Sao chép trang tính từ bảng tính này sang bảng tính khác
Nội dung sau đây
spreadsheet.sheets.copyTo
mã mẫu cho biết cách sao chép một trang tính do SHEET_ID chỉ định
từ một bảng tính sang một bảng tính khác.
Biến TARGET_SPREADSHEET_ID trong nội dung yêu cầu chỉ định
bảng tính đích. Bản sao này giữ lại tất cả giá trị, định dạng, công thức và
các thuộc tính khác của văn bản gốc. Tiêu đề của trang tính được sao chép được đặt thành "Sao chép
trong [tiêu đề trang tính gốc]".
Phản hồi bao gồm
SheetProperties
đối tượng mô tả các thuộc tính của trang tính đã tạo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/sheets/SHEET_ID:copyTo
{
"destinationSpreadsheetId": "TARGET_SPREADSHEET_ID"
}
Xoá trang tính
Nội dung sau đây
spreadsheets.batchUpdate
mã mẫu cho biết cách sử dụng
DeleteSheetRequest
để xóa trang tính do SHEET_ID chỉ đị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": [
{
"deleteSheet": {
"sheetId": SHEET_ID
}
}
]
}
Đọc dữ liệu trang tính
Nội dung sau đây
Mã mẫu spreadsheets.get
cho biết cách lấy thông tin về thuộc tính trang tính
từ bảng tính, do SHEET_ID chỉ định
và SPREADSHEET_ID. Phương pháp này thường được dùng để xác định
siêu dữ liệu của các trang tính trong một bảng tính cụ thể, vì vậy các thao tác bổ sung có thể
nhắm mục tiêu các trang tính đó. Tham số truy vấn fields chỉ chỉ định thuộc tính trang tính
(trái ngược với dữ liệu giá trị ô hoặc dữ liệu liên quan đến
toàn bộ bảng tính).
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?&fields=sheets.properties
Phản hồi bao gồm
Spreadsheet
tài nguyên, trong đó có chứa
Sheet đối tượng có
SheetProperties
phần tử. Nếu một trường phản hồi nhất định được đặt thành giá trị mặc định, trường đó sẽ bị bỏ qua
khỏi câu trả lời.
{
"sheets": [
{
"properties": {
"sheetId": SHEET_ID,
"title": "Sheet1",
"index": 0,
"sheetType": "GRID",
"gridProperties": {
"rowCount": 100,
"columnCount": 20,
"frozenRowCount": 1
}
"tabColor": {
"blue": 1.0
}
},
...
],
}