Truy cập và sửa đổi các nhóm họp nhóm trong bảng tổng hợp.
Phương thức
Phương thức | Loại 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 bảng tổng hợp này. |
areLabelsRepeated() | Boolean | Trả về việc nhãn có được hiển thị như lặp lại hay không. |
clearGroupingRule() | PivotGroup | Xoá mọi quy tắc nhóm khỏi nhóm bảng 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 bảng tổng hợp hoặc null nếu không có ngày giờ
đã đặt quy tắc nhóm. |
getDimension() | Dimension | Trả về cho biết đây là một nhóm hàng hay nhóm cột. |
getGroupLimit() | PivotGroupLimit | Trả về giới hạn nhóm bảng tổng hợp trên nhóm bảng tổng hợp đó. |
getIndex() | Integer | Trả về chỉ mục của nhóm bảng 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 bảng tổng hợp hoạt động. |
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 tăng dần, trả về false nếu thứ tự sắp xếp là
giảm dần. |
moveToIndex(index) | PivotGroup | Di chuyển nhóm này đến vị trí đã chỉ định trong danh sách các nhóm hàng hoặc cột hiện tại. |
remove() | void | Xoá nhóm bảng tổng hợp này khỏi bảng. |
removeManualGroupingRule(groupName) | PivotGroup | Xoá quy tắc nhóm thủ công với groupName được 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ờ trên 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 bảng tổng hợp trên nhóm bảng tổng hợp đó. |
setHistogramGroupingRule(minValue, maxValue, intervalSize) | PivotGroup | Đặt một quy tắc nhóm biểu đồ cho nhóm bảng tổng hợp này. |
showRepeatedLabels() | PivotGroup | Khi có nhiều nhóm hàng hoặc cột, phương pháp này sẽ hiển thị nhãn của nhóm này cho mỗi mục của nhóm tiếp theo. |
showTotals(showTotals) | PivotGroup | Đặt xem có hiển thị tổng giá trị cho nhóm bảng tổng hợp này trong bảng hay không. |
sortAscending() | PivotGroup | Đặt thứ tự sắp xếp là 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 theo thứ tự giảm dần. |
totalsAreShown() | Boolean | Trả về xem tổng giá trị có hiển thị cho nhóm bảng 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 bảng tổng hợp này.
Tham số
Tên | Loại | Mô tả |
---|---|---|
groupName | String | Tên của quy tắc nhóm này. |
groupMembers | Object[] | Các giá trị có trong 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 yêu cầu ủy 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ề việc nhãn có được hiển thị như lặp lại hay không.
Cầu thủ trả bóng
Boolean
– true
nếu nhãn bị 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 yêu cầu ủy 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 bảng 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 yêu cầu ủy 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 yêu cầu ủy 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 bảng tổng hợp hoặc null
nếu không có ngày giờ
đã đặt quy tắc nhóm.
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 yêu cầu ủy 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ề cho biết đây là một 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 yêu cầu ủy 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 bảng tổng hợp trên nhóm bảng tổng hợp đó. Trả về null
nếu không có giới hạn nhóm bảng tổng hợp
đã được đặt.
Cầu thủ trả bóng
PivotGroupLimit
— Giới hạn nhóm bảng tổng hợp.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 bảng 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 bảng tổng hợp
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 yêu cầu ủy 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ỉ số này được lấy từ thang điểm 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 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 yêu cầu ủy 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 bảng tổng hợp hoạt động. Trả về null
nếu bảng tổng hợp
bảng không phải là {DataSourcePivotTableApi}.
Cầu thủ trả bóng
DataSourceColumn
— Cột nguồn dữ liệu mà nhóm bảng tổng hợp sẽ hoạt động.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 đã bị ẩn, thì kết quả là 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 nhóm cột, khi có thêm thì 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 yêu cầu ủy 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 tăng dần, trả về false
nếu thứ tự sắp xếp là
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 yêu cầu ủy 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 các nhóm hàng hoặc cột hiện tại. Các
chỉ mục dựa trên giá trị 0. Ví dụ: nếu nhóm này được chuyển đến vị trí đầu tiên, thì
phải được gọi bằng 0
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
index | Integer | Chỉ mục để di chuyển nhóm này vào. |
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 yêu cầu ủy 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 bảng 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 yêu cầu ủy 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 với groupName
được chỉ định.
Tham số
Tên | Loại | 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 yêu cầu ủy 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 yêu cầu ủy 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ờ trên nhóm bảng tổng hợp.
Để xoá quy tắc này, hãy dùng clearGroupingRule()
.
Tham số
Tên | Loại | 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 yêu cầu ủy 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.
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên hiển thị 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 yêu cầu ủy 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 bảng tổng hợp trên nhóm bảng tổng hợp đó. Thao tác này chỉ được hỗ trợ đối với DataSourcePivotTable
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
countLimit | Integer | Giới hạn số lượng hàng hoặc cột cần đặt. Phải là số 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 yêu cầu ủy 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 một quy tắc nhóm biểu đồ cho nhóm bảng tổng hợp này. Quy tắc biểu đồ tổ chức các giá trị theo
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 kích thước interval
. Tất cả giá trị dưới minValue
được đặt vào một nhóm, cũng như tất cả các giá trị lớn hơn maxValue
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
minValue | Integer | Giá trị tối thiểu cho các mục được đặt vào các nhóm. Có giá trị thấp hơn mức này được kết hợp vào một nhóm duy nhất. |
maxValue | Integer | Giá trị tối đa cho các mục được đặt vào các nhóm. Giá trị lớn hơn giá trị này được kết hợp vào 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 yêu cầu ủy 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 cột, phương pháp này sẽ hiển thị nhãn của nhóm này cho mỗi mục của nhóm tiếp theo. Nếu 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 nhóm cột, thì khi một nhóm bổ sung được thêm vào, các nhãn lặp lại được 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 yêu cầu ủy 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)
Đặt xem có hiển thị tổng giá trị cho nhóm bảng tổng hợp này trong bảng hay không.
Tham số
Tên | Loại | 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 yêu cầu ủy 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 là 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 yêu cầu ủy 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']);
Tham số
Tên | Loại | Mô tả |
---|---|---|
value | PivotValue | Giá trị tổng hợp để sắp xếp. |
oppositeGroupValues | Object[] | Giá trị của một nhóm bảng tổng hợp đối diện (một nhóm cột nếu sắp xếp một nhóm nhóm hàng hoặc 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 cho việc 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 yêu cầu ủy 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 theo thứ tự 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 yêu cầu ủy 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ó hiển thị cho nhóm bảng 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 bảng tổng hợp này; nếu không thì trả về
false
.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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