Class PivotGroup

NhómPivot

Truy cập và sửa đổi các nhóm phân tích của bảng tổng hợp.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addManualGroupingRule(groupName, groupMembers)PivotGroupThêm một quy tắc nhóm thủ công cho nhóm bảng tổng hợp này.
areLabelsRepeated()BooleanTrả về xem các nhãn có được hiển thị nhiều lần hay không.
clearGroupingRule()PivotGroupXoá mọi quy tắc nhóm khỏi nhóm bảng tổng hợp này.
clearSort()PivotGroupXoá mọi tiêu chí sắp xếp đã áp dụng cho nhóm này.
getDateTimeGroupingRule()DateTimeGroupingRule|nullTrả 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ó quy tắc nhóm ngày giờ nào được đặt.
getDimension()DimensionTrả về cho dù đây là một nhóm hàng hay nhóm cột.
getGroupLimit()PivotGroupLimit|nullTrả về giới hạn nhóm bảng tổng hợp của nhóm bảng tổng hợp.
getIndex()IntegerTrả 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()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()DataSourceColumn|nullTrả về cột nguồn dữ liệu mà nhóm tổng hợp 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 sắp xếp theo thứ tự tăng dần, trả về false nếu sắp xếp theo thứ tự giảm dần.
moveToIndex(index)PivotGroupDi chuyển nhóm này đến vị trí được 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 bảng tổng hợp này khỏi bảng.
removeManualGroupingRule(groupName)PivotGroupXoá quy tắc nhóm thủ công có 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 cho nhóm bảng tổng hợp.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupĐặt quy tắc nhóm biểu đồ cho nhóm bảng 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 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)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 thành giảm dần.
totalsAreShown()BooleanTrả về liệu tổng giá trị hiện có đượ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 một quy tắc nhóm thủ công cho nhóm bảng tổng hợp này.

Thông 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 xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

areLabelsRepeated()

Trả về xem các nhãn có được hiển thị nhiều lần hay không.

Cầu thủ trả bóng

Boolean – true nếu nhãn được 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearSort()

Xoá mọi tiêu chí sắp xếp đã áp dụng cho nhóm này.

Cầu thủ trả bóng

PivotGroup – nhóm xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ó quy tắc nhóm ngày giờ nào được đặt.

Cầu thủ trả bóng

DateTimeGroupingRule|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDimension()

Trả về cho dù đâ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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 của 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 nào được đặt.

Cầu thủ trả bóng

PivotGroupLimit|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ả về null nếu bảng tổng hợp không phải là {DataSourcePivotTableApi}.

Cầu thủ trả bóng

DataSourceColumn|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ì thao tác này sẽ không có hiệu lực. 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 một nhóm bổ sung được thêm vào, các nhãn lặp lại sẽ bị ẩn.

Cầu thủ trả bóng

PivotGroup – nhóm xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isSortAscending()

Trả về true nếu sắp xếp theo thứ tự tăng dần, trả về false nếu sắp xếp theo thứ tự 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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í được 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 phải được gọi bằng 0.

Thông số

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

Cầu thủ trả bóng

PivotGroup – nhóm xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 được chỉ định.

Thông 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 xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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, hãy dùng clearGroupingRule().

Thông số

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

Cầu thủ trả bóng

PivotGroup – Nhóm bảng tổng hợp, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

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

Cầu thủ trả bóng

PivotGroup – nhóm trụ để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cho nhóm bảng tổng hợp. Thao tác này chỉ được hỗ trợ cho DataSourcePivotTable.

Thông số

TênLoạiMô tả
countLimitIntegerGiớ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 xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 bảng tổng hợp này. Quy tắc biểu đồ tần suất sắp xếp 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 cố định. Tất cả các giá trị từ minValue đến maxValue đều được đặt vào các nhóm có kích thước interval. Tất cả các giá trị dưới minValue đều được đặt vào một nhóm, cũng như tất cả các giá trị lớn hơn maxValue.

Thông số

TênLoạiMô tả
minValueIntegerGiá trị tối thiểu để đặt các mục vào nhóm. Các giá trị nhỏ hơn giá trị này sẽ được kết hợp thành một nhóm duy nhất.
maxValueIntegerGiá trị tối đa của các mục cần được đặt vào các 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 duy nhất.
intervalSizeInteger

Cầu thủ trả bóng

PivotGroup – nhóm xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 các nhãn đã được lặp lại, thì thao tác này sẽ không có tác dụ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 một nhóm bổ sung được thêm vào, các nhãn lặp lại sẽ xuất hiện.

Cầu thủ trả bóng

PivotGroup – nhóm xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

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

Cầu thủ trả bóng

PivotGroup – nhóm xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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']);

Thông số

TênLoạiMô tả
valuePivotValueGiá trị trục để sắp xếp.
oppositeGroupValuesObject[]Giá trị của một nhóm xoay ngược (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 để phân định thắng thua.

Cầu thủ trả bóng

PivotGroup – nhóm xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

sortDescending()

Đặt thứ tự sắp xếp thành giảm dần.

Cầu thủ trả bóng

PivotGroup – nhóm xoay để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ó đượ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 các giá trị tổng được hiển thị cho nhóm bảng tổng hợp này; nếu không, hàm sẽ trả về false.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets