Truy cập và sửa đổi trang tính nguồn dữ liệu hiện có. Để tạo trang tính nguồn dữ liệu mới, hãy sử dụng Spreadsheet.insertDataSourceSheet(spec)
.
Chỉ sử dụng lớp này với dữ liệu được kết nối với cơ sở dữ liệu.
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
addFilter(columnName, filterCriteria) | DataSourceSheet | Thêm bộ lọc được áp dụng cho trang tính nguồn dữ liệu. |
asSheet() | Sheet | Trả về trang tính nguồn dữ liệu dưới dạng đối tượng trang tính thông thường. |
autoResizeColumn(columnName) | DataSourceSheet | Tự động đổi kích thước chiều rộng của cột được chỉ định. |
autoResizeColumns(columnNames) | DataSourceSheet | Tự động đổi kích thước chiều rộng của các cột được chỉ định. |
forceRefreshData() | DataSourceSheet | Làm mới dữ liệu của đối tượng này bất kể trạng thái hiện tại. |
getColumnWidth(columnName) | Integer | Trả về chiều rộng của cột được chỉ định. |
getDataSource() | DataSource | Lấy nguồn dữ liệu liên kết với đối tượng. |
getFilters() | DataSourceSheetFilter[] | Trả về tất cả bộ lọc được áp dụng cho trang tính nguồn dữ liệu. |
getSheetValues(columnName) | Object[] | Trả về tất cả giá trị của trang tính nguồn dữ liệu cho tên cột đã cung cấp. |
getSheetValues(columnName, startRow, numRows) | Object[] | Trả về tất cả giá trị của trang tính nguồn dữ liệu cho tên cột đã cung cấp từ hàng bắt đầu đã cho (dựa trên 1) và tối đa numRows đã cho. |
getSortSpecs() | SortSpec[] | Xem tất cả thông số sắp xếp trong trang tính nguồn dữ liệu. |
getStatus() | DataExecutionStatus | Lấy trạng thái thực thi dữ liệu của đối tượng. |
refreshData() | DataSourceSheet | Làm mới dữ liệu của đối tượng. |
removeFilters(columnName) | DataSourceSheet | Xoá tất cả bộ lọc được áp dụng cho cột trang tính nguồn dữ liệu. |
removeSortSpec(columnName) | DataSourceSheet | Xoá thông số sắp xếp trên một cột trong trang tính về nguồn dữ liệu. |
setColumnWidth(columnName, width) | DataSourceSheet | Đặt chiều rộng của cột được chỉ định. |
setColumnWidths(columnNames, width) | DataSourceSheet | Đặt chiều rộng của các cột được chỉ định. |
setSortSpec(columnName, ascending) | DataSourceSheet | Đặt thông số sắp xếp trên một cột trong trang tính nguồn dữ liệu. |
setSortSpec(columnName, sortOrder) | DataSourceSheet | Đặt thông số sắp xếp trên một cột trong trang tính nguồn dữ liệu. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Chờ cho đến khi thực thi hiện tại hoàn tất, hết thời gian chờ sau số giây đã cho. |
Tài liệu chi tiết
addFilter(columnName, filterCriteria)
Thêm bộ lọc được áp dụng cho trang tính nguồn dữ liệu.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên của cột để áp dụng bộ lọc này. |
filterCriteria | FilterCriteria | Tiêu chí lọc để áp dụng. |
Cầu thủ trả bóng
DataSourceSheet
– Trang tính nguồn dữ liệu để tạo chuỗi phương thức.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asSheet()
Trả về trang tính nguồn dữ liệu dưới dạng đối tượng trang tính thông thường.
Cầu thủ trả bóng
Sheet
– Trang tính thông thường.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnName)
Tự động đổi kích thước chiều rộng của cột được chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên cột. |
Cầu thủ trả bóng
DataSourceSheet
– Trang tính nguồn dữ liệu này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumns(columnNames)
Tự động đổi kích thước chiều rộng của các cột được chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnNames | String[] | Danh sách tên cột cần cập nhật. |
Cầu thủ trả bóng
DataSourceSheet
– Trang tính nguồn dữ liệu này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
Làm mới dữ liệu của đối tượng này bất kể trạng thái hiện tại. Hãy xem refreshData()
để biết thêm thông tin chi tiết.
Gửi một trường hợp ngoại lệ nếu loại nguồn dữ liệu chưa được bật. Sử dụng các phương thức SpreadsheetApp#enable...Execution()
để cho phép thực thi dữ liệu cho loại nguồn dữ liệu cụ thể.
Cầu thủ trả bóng
DataSourceSheet
– Đối tượng dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnWidth(columnName)
Trả về chiều rộng của cột được chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên cột. |
Cầu thủ trả bóng
Integer
– Chiều rộng của cột hoặc null
nếu cột sử dụng chiều rộng mặc định.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSource()
Lấy nguồn dữ liệu liên kết với đối tượng.
Cầu thủ trả bóng
DataSource
– Nguồn dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilters()
Trả về tất cả bộ lọc được áp dụng cho trang tính nguồn dữ liệu.
Cầu thủ trả bóng
DataSourceSheetFilter[]
– Mảng gồm tất cả các bộ lọc đã áp dụng cho trang tính nguồn dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(columnName)
Trả về tất cả giá trị của trang tính nguồn dữ liệu cho tên cột đã cung cấp.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên cột nguồn dữ liệu để tìm nạp giá trị. |
Cầu thủ trả bóng
Object[]
– Mảng giá trị một chiều.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(columnName, startRow, numRows)
Trả về tất cả giá trị của trang tính nguồn dữ liệu cho tên cột đã cung cấp từ hàng bắt đầu đã cho (dựa trên 1) và tối đa numRows
đã cho.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên cột nguồn dữ liệu để tìm nạp giá trị. |
startRow | Integer | Vị trí hàng để bắt đầu tìm nạp giá trị. |
numRows | Integer | Số hàng cần tìm nạp. |
Cầu thủ trả bóng
Object[]
– Mảng giá trị một chiều.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSortSpecs()
Xem tất cả thông số sắp xếp trong trang tính nguồn dữ liệu.
Cầu thủ trả bóng
SortSpec[]
– Danh sách các thông số sắp xếp.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
Lấy trạng thái thực thi dữ liệu của đối tượng.
Cầu thủ trả bóng
DataExecutionStatus
– Trạng thái thực thi dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
Làm mới dữ liệu của đối tượng.
Gửi một ngoại lệ nếu hiện ở trạng thái error
. Sử dụng DataSource#updateSpec()
để cập nhật thông số kỹ thuật. Phương thức này được ưu tiên hơn forceRefreshData()
để tránh các nội dung chỉnh sửa không mong muốn trên nguồn dữ liệu.
Gửi một trường hợp ngoại lệ nếu loại nguồn dữ liệu chưa được bật. Sử dụng các phương thức SpreadsheetApp#enable...Execution()
để cho phép thực thi dữ liệu cho loại nguồn dữ liệu cụ thể.
Cầu thủ trả bóng
DataSourceSheet
– Đối tượng dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeFilters(columnName)
Xoá tất cả bộ lọc được áp dụng cho cột trang tính nguồn dữ liệu.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên của cột cần xoá bộ lọc. |
Cầu thủ trả bóng
DataSourceSheet
– Trang tính nguồn dữ liệu để tạo chuỗi phương thức.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeSortSpec(columnName)
Xoá thông số sắp xếp trên một cột trong trang tính về nguồn dữ liệu.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên của cột. |
Cầu thủ trả bóng
DataSourceSheet
– Trang tính nguồn dữ liệu để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnName, width)
Đặt chiều rộng của cột được chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên cột. |
width | Integer | Chiều rộng mới của cột. |
Cầu thủ trả bóng
DataSourceSheet
– Trang tính nguồn dữ liệu này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(columnNames, width)
Đặt chiều rộng của các cột được chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnNames | String[] | Danh sách tên cột cần cập nhật. |
width | Integer | Chiều rộng mới cho các cột. |
Cầu thủ trả bóng
DataSourceSheet
– Trang tính nguồn dữ liệu này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSortSpec(columnName, ascending)
Đặt thông số sắp xếp trên một cột trong trang tính nguồn dữ liệu.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên của cột cần sắp xếp. |
ascending | Boolean | Nếu là true , hãy sắp xếp cột theo thứ tự tăng dần; nếu là false , hãy sắp xếp cột theo thứ tự giảm dần. |
Cầu thủ trả bóng
DataSourceSheet
– Trang tính nguồn dữ liệu để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSortSpec(columnName, sortOrder)
Đặt thông số sắp xếp trên một cột trong trang tính nguồn dữ liệu.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên của cột cần sắp xếp. |
sortOrder | SortOrder | Thứ tự sắp xếp. |
Cầu thủ trả bóng
DataSourceSheet
– Trang tính nguồn dữ liệu để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Chờ cho đến khi thực thi hiện tại hoàn tất, hết thời gian chờ sau số giây đã cho. Gửi một trường hợp ngoại lệ nếu quá trình thực thi không hoàn tất khi hết thời gian chờ, nhưng không huỷ quá trình thực thi dữ liệu.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
timeoutInSeconds | Integer | Thời gian chờ thực thi dữ liệu, tính bằng giây. Thời lượng tối đa là 300 giây. |
Cầu thủ trả bóng
DataExecutionStatus
– Trạng thái thực thi dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets