Truy cập và sửa đổi bảng tổng hợp nguồn dữ liệu hiện có. Để tạo bảng tổng hợp nguồn dữ liệu mới, hãy sử dụng Range.createDataSourcePivotTable(dataSource)
.
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 |
---|---|---|
addColumnGroup(columnName) | PivotGroup | Thêm một nhóm cột tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định. |
addFilter(columnName, filterCriteria) | PivotFilter | Thêm một bộ lọc mới dựa trên cột nguồn dữ liệu được chỉ định với tiêu chí lọc đã chỉ định. |
addPivotValue(columnName, summarizeFunction) | PivotValue | Thêm giá trị tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định bằng hàm tóm tắt đã chỉ định. |
addRowGroup(columnName) | PivotGroup | Thêm một nhóm hàng tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định. |
asPivotTable() | PivotTable | Trả về bảng tổng hợp nguồn dữ liệu dưới dạng đối tượng bảng tổng hợp thông thường. |
forceRefreshData() | DataSourcePivotTable | 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. |
getDataSource() | DataSource | Lấy nguồn dữ liệu liên kết với đối tượng. |
getStatus() | DataExecutionStatus | Lấy trạng thái thực thi dữ liệu của đối tượng. |
refreshData() | DataSourcePivotTable | Làm mới dữ liệu của đối tượng. |
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
addColumnGroup(columnName)
Thêm một nhóm cột tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên cột dựa trên dữ liệu của nhóm tổng hợp. |
Cầu thủ trả bóng
PivotGroup
– Nhóm tổng hợp mớ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
addFilter(columnName, filterCriteria)
Thêm một bộ lọc mới dựa trên cột nguồn dữ liệu được chỉ định với tiêu chí lọc đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên cột dữ liệu mà bộ lọc sẽ dựa vào. |
filterCriteria | FilterCriteria | Tiêu chí mà bộ lọc sử dụng. |
Cầu thủ trả bóng
PivotFilter
– Bộ lọc mớ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
addPivotValue(columnName, summarizeFunction)
Thêm giá trị tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định bằng hàm tóm tắt đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Dữ liệu nguồn cung cấp tên cột làm cơ sở cho giá trị tổng hợp. |
summarizeFunction | PivotTableSummarizeFunction | Hàm tóm tắt mà giá trị tổng hợp sử dụng. |
Cầu thủ trả bóng
PivotValue
– Giá trị tổng hợp mớ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
addRowGroup(columnName)
Thêm một nhóm hàng tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên cột dựa trên dữ liệu của nhóm tổng hợp. |
Cầu thủ trả bóng
PivotGroup
– Nhóm tổng hợp mớ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
asPivotTable()
Trả về bảng tổng hợp nguồn dữ liệu dưới dạng đối tượng bảng tổng hợp thông thường.
Cầu thủ trả bóng
PivotTable
– Bảng tổng hợ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
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
DataSourcePivotTable
– Đố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
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
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
DataSourcePivotTable
– Đố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
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