Trang này được dịch bởi Cloud Translation API.

Class DataSourceSheet

Truy cập và sửa đổi trang tính nguồn dữ liệu hiện có. Để tạo một 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	Loại 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 đã chỉ định.
`autoResizeColumns(columnNames)`	`DataSourceSheet`	Tự động đổi kích thước chiều rộng của các cột đã chỉ định.
`cancelDataRefresh()`	`DataSourceSheet`	Huỷ làm mới dữ liệu liên kết với đối tượng này nếu đối tượng đó đang chạy.
`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 mà đối tượng được liên kết.
`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ị cho trang tính nguồn dữ liệu theo tên cột đã cung cấp.
`getSheetValues(columnName, startRow, numRows)`	`Object[]`	Trả về tất cả giá trị cho trang tính nguồn dữ liệu cho tên cột đã cung cấp từ hàng bắt đầu đã cung cấp (dựa trên-1) cho đến `numRows` đã cung cấp.
`getSortSpecs()`	`SortSpec[]`	Lấy 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 nguồn dữ liệu.
`setColumnWidth(columnName, width)`	`DataSourceSheet`	Đặt chiều rộng của cột đã chỉ định.
`setColumnWidths(columnNames, width)`	`DataSourceSheet`	Đặt chiều rộng của các cột đã 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 quá trình thực thi hiện tại hoàn tất, hết thời gian chờ sau số giây đã cung cấp.

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.

Tham số

Tên	Loại	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 cần á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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã chỉ định.

Tham số

Tên	Loại	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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã chỉ định.

Tham số

Tên	Loại	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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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

`cancelDataRefresh()`

Huỷ làm mới dữ liệu liên kết với đối tượng này nếu đối tượng đó đang chạy.

Ví dụ này cho thấy cách huỷ làm mới công thức.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

Gửi một ngoại lệ nếu loại nguồn dữ liệu không đượ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 một 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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. Nếu bạn muốn huỷ quá trình làm mới đối tượng này đang chạy, hãy xem cancelDataRefresh().

Cầu thủ trả bóng

DataSourceSheet – Đối tượng dữ liệu.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

Tên	Loại	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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 mà đối tượng được liên kết.

Cầu thủ trả bóng

DataSource – Nguồn dữ liệu.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ả bộ lọc được áp dụng cho trang tính nguồn dữ liệu.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ị cho trang tính nguồn dữ liệu theo tên cột đã cung cấp.

Tham số

Tên	Loại	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ột mảng một chiều gồm các giá trị.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ị cho trang tính nguồn dữ liệu cho tên cột đã cung cấp từ hàng bắt đầu đã cung cấp (dựa trên-1) cho đến numRows đã cung cấp.

Tham số

Tên	Loại	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ột mảng một chiều gồm các giá trị.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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()`

Lấy 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 thông số kỹ thuật sắp xếp.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Trả về ngoại lệ nếu đang ở trạng thái error. Sử dụng DataSource#updateSpec() để cập nhật thông số kỹ thuật. Bạn nên sử dụng phương thức này thay vì forceRefreshData() để ngăn chặn các nội dung chỉnh sửa không mong muốn trên nguồn dữ liệu.

Cầu thủ trả bóng

DataSourceSheet – Đối tượng dữ liệu.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

Tên	Loại	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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 nguồn dữ liệu.

Tham số

Tên	Loại	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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã chỉ định.

Tham số

Tên	Loại	Mô tả
`columnName`	`String`	Tên cột.
`width`	`Integer`	Chiều rộng mới cho 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã chỉ định.

Tham số

Tên	Loại	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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

Tên	Loại	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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

Tên	Loại	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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 quá trình thực thi hiện tại hoàn tất, hết thời gian chờ sau số giây đã cung cấp. Gửi một ngoại lệ nếu quá trình thực thi chưa 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.

Tham số

Tên	Loại	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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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