Class DataSourceSheet

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ứcKiểu dữ liệu trả vềMô tả ngắn
addFilter(columnName, filterCriteria)DataSourceSheetThêm một bộ lọc được áp dụng cho trang tính nguồn dữ liệu.
asSheet()SheetTrả về trang tính nguồn dữ liệu dưới dạng một đối tượng trang tính thông thường.
autoResizeColumn(columnName)DataSourceSheetTự động đổi kích thước chiều rộng của cột được chỉ định.
autoResizeColumns(columnNames)DataSourceSheetTự động đổi kích thước chiều rộng của các cột được chỉ định.
cancelDataRefresh()DataSourceSheetHuỷ quá trình làm mới dữ liệu liên kết với đối tượng này nếu quá trình đó đang chạy.
forceRefreshData()DataSourceSheetLà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|nullTrả về chiều rộng của cột được chỉ định.
getDataSource()DataSourceLấ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ả các giá trị cho trang tính nguồn dữ liệu theo tên cột được cung cấp.
getSheetValues(columnName, startRow, numRows)Object[]Trả về tất cả các giá trị cho trang tính nguồn dữ liệu cho tên cột được cung cấp từ hàng bắt đầu được cung cấp (dựa trên 1) và lên đến numRows được cung cấp.
getSortSpecs()SortSpec[]Lấy tất cả các thông số sắp xếp trong trang nguồn dữ liệu.
getStatus()DataExecutionStatusLấy trạng thái thực thi dữ liệu của đối tượng.
refreshData()DataSourceSheetLàm mới dữ liệu của đối tượng.
removeFilters(columnName)DataSourceSheetXoá tất cả bộ lọc được áp dụng cho cột trang tính nguồn dữ liệu.
removeSortSpec(columnName)DataSourceSheetXoá chỉ dẫn 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 đượ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 tiêu chí sắp xếp trên một cột trong trang tính nguồn dữ liệu.
setSortSpec(columnName, sortOrder)DataSourceSheetĐặt tiêu chí sắp xếp trên một cột trong trang tính nguồn dữ liệu.
waitForCompletion(timeoutInSeconds)DataExecutionStatusĐợi 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 một bộ lọc được áp dụng cho trang tính nguồn dữ liệu.

Thông số

TênLoạiMô tả
columnNameStringTên của cột để áp dụng bộ lọc này.
filterCriteriaFilterCriteriaTiêu chí lọc cần áp dụng.

Cầu thủ trả bóng

DataSourceSheet – Trang nguồn dữ liệu, để liên kết phương thức.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 một đố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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
columnNameStringTên cột.

Cầu thủ trả bóng

DataSourceSheet – Trang nguồn dữ liệu này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
columnNamesString[]Danh sách tên cột cần cập nhật.

Cầu thủ trả bóng

DataSourceSheet – Trang nguồn dữ liệu này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

cancelDataRefresh()

Huỷ quá trình làm mới dữ liệu liên kết với đối tượng này nếu quá trình đó đ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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 đang chạy của đối tượng này, hãy xem 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
columnNameStringTên cột.

Cầu thủ trả bóng

Integer|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ột mảng gồm tất cả cá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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSheetValues(columnName)

Trả về tất cả các giá trị cho trang tính nguồn dữ liệu theo tên cột được cung cấp.

Thông số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu để tìm nạp các giá trị.

Cầu thủ trả bóng

Object[] – Mảng giá trị một chiều.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSheetValues(columnName, startRow, numRows)

Trả về tất cả các giá trị cho trang tính nguồn dữ liệu cho tên cột được cung cấp từ hàng bắt đầu được cung cấp (dựa trên 1) và lên đến numRows được cung cấp.

Thông số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu để tìm nạp các giá trị.
startRowIntegerVị trí hàng để bắt đầu tìm nạp giá trị.
numRowsIntegerSố 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSortSpecs()

Lấy tất cả các thông số sắp xếp trong trang 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Khai báo một trường hợp ngoại lệ nếu hiện đang ở trạng thái error. Sử dụng DataSource#updateSpec() để cập nhật quy cách. Phương thức này được ưu tiên hơn 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.

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
columnNameStringTên của cột cần xoá bộ lọc.

Cầu thủ trả bóng

DataSourceSheet – Trang nguồn dữ liệu, để liên kết phương thức.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

removeSortSpec(columnName)

Xoá chỉ dẫn sắp xếp trên một cột trong trang tính nguồn dữ liệu.

Thông số

TênLoạiMô tả
columnNameStringTê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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
columnNameStringTên cột.
widthIntegerChiều rộng mới của cột.

Cầu thủ trả bóng

DataSourceSheet – Trang nguồn dữ liệu này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
columnNamesString[]Danh sách tên cột cần cập nhật.
widthIntegerChiều rộng mới cho các cột.

Cầu thủ trả bóng

DataSourceSheet – Trang nguồn dữ liệu này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setSortSpec(columnName, ascending)

Đặt tiêu chí sắp xếp trên một cột trong trang tính nguồn dữ liệu.

Thông số

TênLoạiMô tả
columnNameStringTên của cột cần sắp xếp.
ascendingBooleanNếu true, hãy sắp xếp cột theo thứ tự tăng dần; nếu 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setSortSpec(columnName, sortOrder)

Đặt tiêu chí sắp xếp trên một cột trong trang tính nguồn dữ liệu.

Thông số

TênLoạiMô tả
columnNameStringTên của cột cần sắp xếp.
sortOrderSortOrderThứ 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

waitForCompletion(timeoutInSeconds)

Đợi 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. Trả về một 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.

Thông số

TênLoạiMô tả
timeoutInSecondsIntegerThờ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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets