Truy cập và sửa đổi các nhóm phiên họp nhóm trên bảng tổng hợp.
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
addManualGroupingRule(groupName, groupMembers) | PivotGroup | Thêm quy tắc nhóm thủ công cho nhóm tổng hợp này. |
areLabelsRepeated() | Boolean | Trả về xem nhãn có được hiển thị dưới dạng lặp lại hay không. |
clearGroupingRule() | PivotGroup | Xoá mọi quy tắc nhóm khỏi nhóm tổng hợp này. |
clearSort() | PivotGroup | Xoá mọi chế độ sắp xếp được áp dụng cho nhóm này. |
getDateTimeGroupingRule() | DateTimeGroupingRule | Trả về quy tắc nhóm ngày-giờ trên nhóm tổng hợp hoặc null nếu bạn không đặt quy tắc nhóm ngày-giờ nào. |
getDimension() | Dimension | Trả về xem đây là nhóm hàng hay nhóm cột. |
getGroupLimit() | PivotGroupLimit | Trả về giới hạn nhóm tổng hợp trên nhóm tổng hợp. |
getIndex() | Integer | Trả về chỉ mục của nhóm tổng hợp này theo thứ tự nhóm hiện tại. |
getPivotTable() | PivotTable | Trả về PivotTable chứa nhóm này. |
getSourceDataColumn() | Integer | Trả về số lượng cột dữ liệu nguồn mà nhóm này tóm tắt. |
getSourceDataSourceColumn() | DataSourceColumn | Trả về cột nguồn dữ liệu mà nhóm tổng hợp hoạt động trên đó. |
hideRepeatedLabels() | PivotGroup | Ẩn các nhãn lặp lại cho nhóm này. |
isSortAscending() | Boolean | Trả về true nếu thứ tự sắp xếp là tăng dần, trả về false nếu thứ tự sắp xếp giảm dần. |
moveToIndex(index) | PivotGroup | Di chuyển nhóm này đến vị trí chỉ định trong danh sách hiện tại của nhóm hàng hoặc nhóm cột. |
remove() | void | Xoá nhóm tổng hợp này khỏi bảng. |
removeManualGroupingRule(groupName) | PivotGroup | Xoá quy tắc nhóm thủ công có groupName đã chỉ định. |
resetDisplayName() | PivotGroup | Đặt lại tên hiển thị của nhóm này trong bảng tổng hợp về giá trị mặc định. |
setDateTimeGroupingRule(dateTimeGroupingRuleType) | PivotGroup | Đặt quy tắc nhóm ngày-giờ cho nhóm bảng tổng hợp. |
setDisplayName(name) | PivotGroup | Đặt tên hiển thị của nhóm này trong bảng tổng hợp. |
setGroupLimit(countLimit) | PivotGroup | Đặt giới hạn nhóm tổng hợp cho nhóm tổng hợp. |
setHistogramGroupingRule(minValue, maxValue, intervalSize) | PivotGroup | Đặt quy tắc nhóm biểu đồ cho nhóm tổng hợp này. |
showRepeatedLabels() | PivotGroup | Khi có nhiều nhóm hàng hoặc nhóm cột, phương thức này sẽ hiển thị nhãn của nhóm này cho từng mục của nhóm tiếp theo. |
showTotals(showTotals) | PivotGroup | Thiết lập có hiển thị tổng giá trị cho nhóm tổng hợp này trong bảng hay không. |
sortAscending() | PivotGroup | Đặt thứ tự sắp xếp thành tăng dần. |
sortBy(value, oppositeGroupValues) | PivotGroup | Sắp xếp nhóm này theo PivotValue được chỉ định cho các giá trị từ oppositeGroupValues . |
sortDescending() | PivotGroup | Đặt thứ tự sắp xếp giảm dần. |
totalsAreShown() | Boolean | Trả về xem tổng giá trị có đang hiển thị cho nhóm tổng hợp này hay không. |
Tài liệu chi tiết
addManualGroupingRule(groupName, groupMembers)
Thêm quy tắc nhóm thủ công cho nhóm tổng hợp này.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
groupName | String | Tên của quy tắc nhóm này. |
groupMembers | Object[] | Các giá trị được đưa vào quy tắc nhóm này. |
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
areLabelsRepeated()
Trả về xem nhãn có được hiển thị dưới dạng lặp lại hay không.
Cầu thủ trả bóng
Boolean
– true
nếu các nhãn được lặp lại; nếu không sẽ trả về false
.
Ủ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
clearGroupingRule()
Xoá mọi quy tắc nhóm khỏi nhóm tổng hợp này.
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
clearSort()
Xoá mọi chế độ sắp xếp được áp dụng cho nhóm này.
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
getDateTimeGroupingRule()
Trả về quy tắc nhóm ngày-giờ trên nhóm tổng hợp hoặc null
nếu bạn không đặt quy tắc nhóm ngày-giờ nào.
Cầu thủ trả bóng
DateTimeGroupingRule
– Quy tắc nhóm ngày-giờ.
Ủ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
getDimension()
Trả về xem đây là nhóm hàng hay nhóm cột.
Cầu thủ trả bóng
Dimension
— phương diện đại diện cho loại nhóm nà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
getGroupLimit()
Trả về giới hạn nhóm tổng hợp trên nhóm tổng hợp. Trả về null
nếu bạn chưa đặt giới hạn nào cho nhóm tổng hợp.
Cầu thủ trả bóng
PivotGroupLimit
– Giới hạn nhóm 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
getIndex()
Trả về chỉ mục của nhóm tổng hợp này theo thứ tự nhóm hiện tại.
Cầu thủ trả bóng
Integer
— chỉ mục của nhóm 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
getPivotTable()
Trả về PivotTable
chứa nhóm này.
Cầu thủ trả bóng
PivotTable
– bảng tổng hợp chứa nhóm nà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
getSourceDataColumn()
Trả về số lượng cột dữ liệu nguồn mà nhóm này tóm tắt. Chỉ mục này dựa trên 1, nếu nhóm này tóm tắt dữ liệu nguồn trong cột "A" của bảng tính, phương thức này sẽ trả về 1
.
Cầu thủ trả bóng
Integer
— số cột dữ liệu nguồn
Ủ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
getSourceDataSourceColumn()
Trả về cột nguồn dữ liệu mà nhóm tổng hợp hoạt động trên đó. Trả về null
nếu bảng tổng hợp không phải là {DataSourcePivotTableApi}.
Cầu thủ trả bóng
DataSourceColumn
– Cột nguồn dữ liệu mà nhóm tổng hợp hoạt động.
Ủ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
hideRepeatedLabels()
Ẩn các nhãn lặp lại cho nhóm này. Nếu nhãn đã được ẩn thì điều này sẽ dẫn đến tình trạng không hoạt động. Nếu phương thức này được gọi trước khi có nhiều nhóm hàng hoặc cột, thì khi thêm một nhóm bổ sung, các nhãn lặp lại sẽ bị ẩn.
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
isSortAscending()
Trả về true
nếu thứ tự sắp xếp là tăng dần, trả về false
nếu thứ tự sắp xếp giảm dần.
Cầu thủ trả bóng
Boolean
— true
nếu thứ tự sắp xếp tăng dần.
Ủ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
moveToIndex(index)
Di chuyển nhóm này đến vị trí chỉ định trong danh sách hiện tại của nhóm hàng hoặc nhóm cột. Các chỉ số này dựa trên 0. Ví dụ: nếu cần chuyển nhóm này đến vị trí đầu tiên, phương thức này sẽ được gọi bằng 0
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
index | Integer | Chỉ mục để di chuyển nhóm này đến. |
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
remove()
Xoá nhóm tổng hợp này khỏi bảng.
Ủ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
removeManualGroupingRule(groupName)
Xoá quy tắc nhóm thủ công có groupName
đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
groupName | String | Tên của quy tắc nhóm cần xoá. |
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
resetDisplayName()
Đặt lại tên hiển thị của nhóm này trong bảng tổng hợp về giá trị mặc định.
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
setDateTimeGroupingRule(dateTimeGroupingRuleType)
Đặt quy tắc nhóm ngày-giờ cho nhóm bảng tổng hợp.
Để xoá quy tắc này, hãy dùng clearGroupingRule()
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
dateTimeGroupingRuleType | DateTimeGroupingRuleType | Loại quy tắc cần đặt. |
Cầu thủ trả bóng
PivotGroup
– Nhóm tổng hợp để tạo chuỗ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
setDisplayName(name)
Đặt tên hiển thị của nhóm này trong bảng tổng hợp.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | Tên hiển thị cần thiết lập. |
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
setGroupLimit(countLimit)
Đặt giới hạn nhóm tổng hợp cho nhóm tổng hợp. Thao tác này chỉ được hỗ trợ đối với DataSourcePivotTable
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
countLimit | Integer | Giới hạn số lượng hàng hoặc cột cần đặt. Phải dương. |
Cầu thủ trả bóng
PivotGroup
– Nhóm tổng hợp để tạo chuỗ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
setHistogramGroupingRule(minValue, maxValue, intervalSize)
Đặt quy tắc nhóm biểu đồ cho nhóm tổng hợp này. Quy tắc biểu đồ sắp xếp các giá trị trong cột dữ liệu nguồn thành các nhóm có kích thước không đổi. Tất cả giá trị từ minValue
đến maxValue
được đặt vào các nhóm có kích thước interval
. Mọi giá trị bên dưới minValue
đều được đặt vào một bộ chứa, cũng như mọi giá trị lớn hơn maxValue
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
minValue | Integer | Giá trị tối thiểu để đặt các mục vào các nhóm. Các giá trị thấp hơn giá trị này sẽ được kết hợp thành một nhóm duy nhất. |
maxValue | Integer | Giá trị tối đa của các mục được đặt vào các nhóm. Các giá trị lớn hơn giá trị này sẽ được kết hợp thành một nhóm duy nhất. |
intervalSize | Integer |
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
showRepeatedLabels()
Khi có nhiều nhóm hàng hoặc nhóm cột, phương thức này sẽ hiển thị nhãn của nhóm này cho từng mục của nhóm tiếp theo. Nếu các nhãn đã lặp lại thì điều này sẽ dẫn đến không hoạt động. Nếu phương thức này được gọi trước khi có nhiều nhóm hàng hoặc cột, thì khi thêm một nhóm bổ sung, các nhãn lặp lại sẽ hiển thị.
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
showTotals(showTotals)
Thiết lập có hiển thị tổng giá trị cho nhóm tổng hợp này trong bảng hay không.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
showTotals | Boolean | Liệu có hiển thị tổng số hay không. |
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
sortAscending()
Đặt thứ tự sắp xếp thành tăng dần.
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
sortBy(value, oppositeGroupValues)
Sắp xếp nhóm này theo PivotValue
được chỉ định cho các giá trị từ oppositeGroupValues
.
// Sorts the item group by the "SUM of Quantity" pivot value for the specified salespersons. var sheet = SpreadsheetApp.getActiveSheet(); var pivotTable = sheet.getPivotTables()[0]; var itemGroup = pivotTable.getRowGroups()[0]; var sumQuantityValue = pivotTable.getPivotValues()[0]; itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
value | PivotValue | Giá trị tổng hợp cần sắp xếp. |
oppositeGroupValues | Object[] | Các giá trị của một nhóm tổng hợp đối diện (một nhóm cột nếu sắp xếp một nhóm hàng, hoặc một nhóm hàng nếu sắp xếp một nhóm cột) được dùng để sắp xếp. Thứ tự của các giá trị này xác định mức độ ưu tiên để ngắt liên kết. |
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
sortDescending()
Đặt thứ tự sắp xếp giảm dần.
Cầu thủ trả bóng
PivotGroup
– nhóm tổng hợp để tạo chuỗ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
totalsAreShown()
Trả về xem tổng giá trị có đang hiển thị cho nhóm tổng hợp này hay không.
Cầu thủ trả bóng
Boolean
– true
nếu tổng giá trị được hiển thị cho nhóm tổng hợp này; nếu không sẽ trả về false
.
Ủ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