Class PivotGroup

NhómPivot

Truy cập và sửa đổi các nhóm chi tiết trong bảng tổng hợp.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
addManualGroupingRule(groupName, groupMembers)PivotGroupThêm quy tắc nhóm thủ công cho nhóm tổng hợp này.
areLabelsRepeated()BooleanTrả về giá trị cho biết nhãn có được hiển thị dưới dạng lặp lại hay không.
clearGroupingRule()PivotGroupXoá mọi quy tắc nhóm khỏi nhóm tổng hợp này.
clearSort()PivotGroupXoá mọi cách sắp xếp áp dụng cho nhóm này.
getDateTimeGroupingRule()DateTimeGroupingRuleTrả 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ờ.
getDimension()DimensionTrả về kết quả cho biết đây là nhóm hàng hay cột.
getGroupLimit()PivotGroupLimitTrả về giới hạn nhóm tổng hợp trên nhóm tổng hợp.
getIndex()IntegerTrả về chỉ mục của nhóm tổng hợp này theo thứ tự nhóm hiện tại.
getPivotTable()PivotTableTrả về PivotTable mà nhóm này thuộc về.
getSourceDataColumn()IntegerTrả về số lượng cột dữ liệu nguồn mà nhóm này tóm tắt.
getSourceDataSourceColumn()DataSourceColumnTrả về cột nguồn dữ liệu mà nhóm tổng hợp theo phương diện hoạt động.
hideRepeatedLabels()PivotGroupẨn các nhãn trùng lặp cho nhóm này.
isSortAscending()BooleanTrả 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 là giảm dần.
moveToIndex(index)PivotGroupDi chuyển nhóm này đến vị trí đã chỉ định trong danh sách hiện tại của các nhóm hàng hoặc cột.
remove()voidXoá nhóm tổng hợp này khỏi bảng.
removeManualGroupingRule(groupName)PivotGroupXoá quy tắc nhóm thủ công bằng 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ờ trên nhóm 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 quy tắc nhóm biểu đồ cho nhóm tổng hợp này.
showRepeatedLabels()PivotGroupKhi có nhiều nhóm hàng hoặc cột, phương thức này sẽ hiển thị nhãn của nhóm này cho mỗi mục nhập của nhóm tiếp theo.
showTotals(showTotals)PivotGroupĐặt xem 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 là tăng dần.
sortBy(value, oppositeGroupValues)PivotGroupSắ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 là giảm dần.
totalsAreShown()BooleanTrả về liệu tổng giá trị hiện có 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.

Tham số

TênLoạiMô tả
groupNameStringTên của quy tắc nhóm này.
groupMembersObject[]Các giá trị có trong quy tắc nhóm này.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ề giá trị cho biết 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 nhãn lặp lại; nếu không thì trả về false.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 cách sắp xếp áp dụng cho nhóm này.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ờ.

Cầu thủ trả bóng

DateTimeGroupingRule – Quy tắc nhóm ngày giờ.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ề kết quả cho biết đây là nhóm hàng hay cột.

Cầu thủ trả bóng

Dimension – phương diện đại diện cho loại của nhóm này

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 không đặt giới hạn nhóm bảng tổng hợp.

Cầu thủ trả bóng

PivotGroupLimit – Giới hạn nhóm bảng tổng hợp.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 mà nhóm này thuộc về.

Cầu thủ trả bóng

PivotTable – bảng tổng hợp mà nhóm này thuộc về.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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, thì 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 theo phương diện hoạt động. 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 trùng lặp cho nhóm này. Nếu nhãn đã bị ẩn, thì phương thức này sẽ 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 trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 là giảm dần.

Cầu thủ trả bóng

Boolean – true nếu thứ tự sắp xếp là tăng dần.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 các nhóm hàng hoặc cột. Các chỉ mục này dựa trên 0. Ví dụ: nếu nhóm này cần được di chuyển đến vị trí đầu tiên, thì phương thức này sẽ được gọi bằng 0.

Tham số

TênLoạiMô tả
indexIntegerChỉ mục để chuyển nhóm này đến.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 bằng groupName đã chỉ định.

Tham số

TênLoạiMô tả
groupNameStringTên của quy tắc nhóm cần xoá.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ờ trên nhóm tổng hợp.

Để xoá quy tắc, hãy sử dụng clearGroupingRule().

Tham số

TênLoạiMô tả
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeLoại quy tắc cần đặt.

Cầu thủ trả bóng

PivotGroup – Nhóm trục, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

TênLoạiMô tả
nameStringTên hiển thị cần đặt.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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ợ cho DataSourcePivotTable.

Tham số

TênLoạiMô tả
countLimitIntegerGiớ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 trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đồ tổ chức các giá trị trong một 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. Tất cả giá trị dưới minValue được đặt vào một bộ chứa, cũng như tất cả giá trị lớn hơn maxValue.

Tham số

TênLoạiMô tả
minValueIntegerGiá trị tối thiểu để các mục được đặt vào bộ chứa. Các giá trị nhỏ hơn giá trị này sẽ được kết hợp thành một nhóm.
maxValueIntegerGiá trị tối đa cho các mục được đặt vào bộ chứa. Các giá trị lớn hơn giá trị này sẽ được kết hợp thành một nhóm.
intervalSizeInteger

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 cột, phương thức này sẽ hiển thị nhãn của nhóm này cho mỗi mục nhập của nhóm tiếp theo. Nếu nhãn đã lặp lại, thì phương thức này sẽ 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ẽ xuất hiện.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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)

Đặt xem có hiển thị tổng giá trị cho nhóm tổng hợp này trong bảng hay không.

Tham số

TênLoạiMô tả
showTotalsBooleanCó hiển thị tổng số hay không.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 là tăng dần.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.
const sheet = SpreadsheetApp.getActiveSheet();
const pivotTable = sheet.getPivotTables()[0];
const itemGroup = pivotTable.getRowGroups()[0];
const sumQuantityValue = pivotTable.getPivotValues()[0];
itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);

Tham số

TênLoạiMô tả
valuePivotValueGiá trị trục để sắp xếp theo.
oppositeGroupValuesObject[]Giá trị của một nhóm tổng hợp đối diện (nhóm cột nếu sắp xếp nhóm hàng hoặc nhóm hàng nếu sắp xếp nhóm cột) được dùng để sắp xếp. Thứ tự của các giá trị này xác định thứ tự ưu tiên khi có hai đội bằng điểm.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 là giảm dần.

Cầu thủ trả bóng

PivotGroup – nhóm trục để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ề liệu tổng giá trị hiện có 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, trả về false.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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