Truy cập và sửa đổi biểu đồ nguồn dữ liệu hiện có.
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 BigQuery.
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
cancel | Data | 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. |
force | Data | 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. |
get | Data | Lấy nguồn dữ liệu mà đối tượng được liên kết. |
get | Data | Lấy trạng thái thực thi dữ liệu của đối tượng. |
refresh | Data | Làm mới dữ liệu của đối tượng. |
wait | Data | Đợ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
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
DataSourceChart – Đố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
DataSourceChart – Đố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
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
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
DataSourceChart – Đố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
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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
timeout | 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 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