Truy cập và sửa đổi nguồn dữ liệu hiện có. Để tạo bảng nguồn dữ liệu có nguồn dữ liệu mới, hãy xem
DataSourceTable
.
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 |
---|---|---|
createCalculatedColumn(name, formula) | DataSourceColumn | Tạo một cột đã tính. |
createDataSourcePivotTableOnNewSheet() | DataSourcePivotTable | Tạo bảng tổng hợp về nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của trang tính mới. |
createDataSourceTableOnNewSheet() | DataSourceTable | Tạo bảng nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của trang tính mới. |
getCalculatedColumnByName(columnName) | DataSourceColumn | Trả về cột đã tính trong nguồn dữ liệu khớp với tên cột. |
getCalculatedColumns() | DataSourceColumn[] | Trả về tất cả cột đã tính trong nguồn dữ liệu. |
getColumns() | DataSourceColumn[] | Trả về tất cả cột trong nguồn dữ liệu. |
getDataSourceSheets() | DataSourceSheet[] | Trả về trang tính nguồn dữ liệu được liên kết với nguồn dữ liệu này. |
getSpec() | DataSourceSpec | Lấy thông số kỹ thuật của nguồn dữ liệu. |
refreshAllLinkedDataSourceObjects() | void | Làm mới tất cả đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu. |
updateSpec(spec) | DataSource | Cập nhật thông số nguồn dữ liệu và làm mới các đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu này bằng quy cách mới. |
updateSpec(spec, refreshAllLinkedObjects) | DataSource | Cập nhật quy cách nguồn dữ liệu và làm mới data
source sheets được liên kết bằng quy cách mới. |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Chờ cho đến khi tất cả lượt thực thi hiện tại của các đối tượng nguồn dữ liệu được liên kết hoàn tất, hết thời gian chờ sau số giây đã cho. |
Tài liệu chi tiết
createCalculatedColumn(name, formula)
Tạo một cột đã tính.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | Tên của cột đã tính. |
formula | String | Công thức của cột đã tính. |
Cầu thủ trả bóng
DataSourceColumn
– Cột mới được tạo.
Ủ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
createDataSourcePivotTableOnNewSheet()
Tạo bảng tổng hợp về nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của trang tính mới. Nhờ có tác dụng phụ này, trang tính mới sẽ trở thành trang tính đang hoạt động.
Cầu thủ trả bóng
DataSourcePivotTable
— Bảng tổng hợp nguồn dữ liệu mới tạo.
Ủ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
createDataSourceTableOnNewSheet()
Tạo bảng nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của trang tính mới. Nhờ hiệu ứng phụ, trang tính mới sẽ trở thành trang tính đang hoạt động.
Cầu thủ trả bóng
DataSourceTable
– Bảng nguồn dữ liệu mới tạo.
Ủ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
getCalculatedColumnByName(columnName)
Trả về cột đã tính trong nguồn dữ liệu khớp với tên cột.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên của cột đã tính cần lấy. |
Cầu thủ trả bóng
DataSourceColumn
– Cột đã tính khớp với tên cột hoặc null
nếu không có cột đã tính như vậy.
Ủ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
getCalculatedColumns()
Trả về tất cả cột đã tính trong nguồn dữ liệu.
Cầu thủ trả bóng
DataSourceColumn[]
– Một mảng gồm tất cả các cột đã tính trong 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
getColumns()
Trả về tất cả cột trong nguồn dữ liệu.
Cầu thủ trả bóng
DataSourceColumn[]
– Một mảng gồm tất cả DataSourceColumn
trong 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
getDataSourceSheets()
Trả về trang tính nguồn dữ liệu được liên kết với nguồn dữ liệu này.
Cầu thủ trả bóng
DataSourceSheet[]
– Một mảng các 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
getSpec()
Lấy thông số kỹ thuật của nguồn dữ liệu.
Cầu thủ trả bóng
DataSourceSpec
– Thông số kỹ thuật của 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
refreshAllLinkedDataSourceObjects()
Làm mới tất cả đối tượng nguồn dữ liệu được liên kết với 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ể.
Ủ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
updateSpec(spec)
Cập nhật thông số nguồn dữ liệu và làm mới các đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu này bằng quy cách mới.
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ác tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
spec | DataSourceSpec | Thông số nguồn dữ liệu để cập nhật. |
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
updateSpec(spec, refreshAllLinkedObjects)
Cập nhật quy cách nguồn dữ liệu và làm mới data
source sheets
được liên kết bằng quy cách mới.
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ác tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
spec | DataSourceSpec | Thông số nguồn dữ liệu để cập nhật. |
refreshAllLinkedObjects | Boolean | Nếu là true , hãy làm mới tất cả đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu này. |
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
waitForAllDataExecutionsCompletion(timeoutInSeconds)
Chờ cho đến khi tất cả lượt thực thi hiện tại của các đối tượng nguồn dữ liệu được liên kết hoàn tất, hết thời gian chờ sau số giây đã cho. Gửi 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.
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. |
Ủ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