Class PivotGroup

PivotGroup

เข้าถึงและแก้ไขกลุ่มย่อยของตาราง Pivot

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addManualGroupingRule(groupName, groupMembers)PivotGroupเพิ่มกฎการจัดกลุ่มด้วยตนเองสำหรับกลุ่ม Pivot นี้
areLabelsRepeated()Booleanแสดงผลว่าป้ายกำกับแสดงเป็นแบบซ้ำหรือไม่
clearGroupingRule()PivotGroupนำกฎการจัดกลุ่มออกจากกลุ่ม Pivot นี้
clearSort()PivotGroupนำการจัดเรียงที่ใช้กับกลุ่มนี้ออก
getDateTimeGroupingRule()DateTimeGroupingRule|nullแสดงกฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot หรือ null หากไม่ได้ตั้งกฎการจัดกลุ่มวันที่และเวลา
getDimension()Dimensionแสดงผลว่านี่คือกลุ่มแถวหรือกลุ่มคอลัมน์
getGroupLimit()PivotGroupLimit|nullแสดงผลขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot
getIndex()Integerแสดงดัชนีของกลุ่ม Pivot นี้ในลำดับกลุ่มปัจจุบัน
getPivotTable()PivotTableแสดง PivotTable ที่การจัดกลุ่มนี้เป็นของ
getSourceDataColumn()Integerแสดงผลจำนวนคอลัมน์ข้อมูลต้นทางที่กลุ่มนี้สรุป
getSourceDataSourceColumn()DataSourceColumn|nullแสดงผลคอลัมน์แหล่งข้อมูลที่กลุ่ม Pivot ดำเนินการ
hideRepeatedLabels()PivotGroupซ่อนป้ายกำกับที่ซ้ำกันสำหรับการจัดกลุ่มนี้
isSortAscending()Booleanแสดง true หากการจัดเรียงเป็นจากน้อยไปมาก และแสดง false หากลำดับการจัดเรียงเป็นจากมากไปน้อย
moveToIndex(index)PivotGroupย้ายกลุ่มนี้ไปยังตำแหน่งที่ระบุในรายการกลุ่มแถวหรือคอลัมน์ปัจจุบัน
remove()voidนำกลุ่ม Pivot นี้ออกจากตาราง
removeManualGroupingRule(groupName)PivotGroupนำกฎการจัดกลุ่มที่กำหนดเองซึ่งมี groupName ที่ระบุออก
resetDisplayName()PivotGroupรีเซ็ตชื่อที่แสดงของกลุ่มนี้ในตาราง Pivot เป็นค่าเริ่มต้น
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupตั้งค่ากฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot
setDisplayName(name)PivotGroupกำหนดชื่อที่แสดงของกลุ่มนี้ในตาราง Pivot
setGroupLimit(countLimit)PivotGroupตั้งค่าขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupตั้งค่ากฎการจัดกลุ่มฮิสโตแกรมสำหรับกลุ่ม Pivot นี้
showRepeatedLabels()PivotGroupเมื่อมีการจัดกลุ่มแถวหรือคอลัมน์มากกว่า 1 รายการ วิธีนี้จะแสดงป้ายกำกับการจัดกลุ่มนี้ สำหรับแต่ละรายการของการจัดกลุ่มถัดไป
showTotals(showTotals)PivotGroupกำหนดว่าจะแสดงค่ารวมสำหรับกลุ่ม Pivot นี้ในตารางหรือไม่
sortAscending()PivotGroupตั้งค่าลำดับการจัดเรียงเป็นจากน้อยไปหามาก
sortBy(value, oppositeGroupValues)PivotGroupจัดเรียงกลุ่มนี้ตาม PivotValue ที่ระบุสำหรับค่าจาก oppositeGroupValues
sortDescending()PivotGroupตั้งค่าลำดับการจัดเรียงเป็นจากมากไปหาน้อย
totalsAreShown()Booleanแสดงผลว่าระบบแสดงค่ารวมสำหรับกลุ่ม Pivot นี้อยู่หรือไม่

เอกสารโดยละเอียด

addManualGroupingRule(groupName, groupMembers)

เพิ่มกฎการจัดกลุ่มด้วยตนเองสำหรับกลุ่ม Pivot นี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
groupNameStringชื่อของกฎการจัดกลุ่มนี้
groupMembersObject[]ค่าที่รวมอยู่ในกฎการจัดกลุ่มนี้

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

areLabelsRepeated()

แสดงผลว่าป้ายกำกับแสดงเป็นแบบซ้ำหรือไม่

รีเทิร์น

Boolean — true หากมีการทำซ้ำป้ายกำกับ มิฉะนั้นจะแสดงผล false

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clearGroupingRule()

นำกฎการจัดกลุ่มออกจากกลุ่ม Pivot นี้

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clearSort()

นำการจัดเรียงที่ใช้กับกลุ่มนี้ออก

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDateTimeGroupingRule()

แสดงกฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot หรือ null หากไม่ได้ตั้งกฎการจัดกลุ่มวันที่และเวลา

รีเทิร์น

DateTimeGroupingRule|null — กฎการจัดกลุ่มวันที่และเวลา

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDimension()

แสดงผลว่านี่คือกลุ่มแถวหรือกลุ่มคอลัมน์

รีเทิร์น

Dimension - มิติข้อมูลที่แสดงประเภทของกลุ่มนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getGroupLimit()

แสดงผลขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot แสดงผล null หากไม่ได้ตั้งขีดจำกัดกลุ่ม Pivot

รีเทิร์น

PivotGroupLimit|null - ขีดจำกัดกลุ่ม Pivot

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getIndex()

แสดงดัชนีของกลุ่ม Pivot นี้ในลำดับกลุ่มปัจจุบัน

รีเทิร์น

Integer - ดัชนีของกลุ่ม Pivot

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getPivotTable()

แสดง PivotTable ที่การจัดกลุ่มนี้เป็นของ

รีเทิร์น

PivotTable - ตาราง Pivot ที่กลุ่มนี้เป็นของ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSourceDataColumn()

แสดงผลจำนวนคอลัมน์ข้อมูลต้นทางที่กลุ่มนี้สรุป ดัชนีนี้เป็นแบบอิงตาม 1 หากกลุ่มนี้สรุปข้อมูลต้นฉบับในคอลัมน์ "A" ของสเปรดชีต เมธอดนี้จะแสดงผล 1

รีเทิร์น

Integer — หมายเลขคอลัมน์ข้อมูลต้นทาง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSourceDataSourceColumn()

แสดงผลคอลัมน์แหล่งข้อมูลที่กลุ่ม Pivot ดำเนินการ แสดงผล null หากตาราง Pivot ไม่ใช่ {DataSourcePivotTableApi}

รีเทิร์น

DataSourceColumn|null — คอลัมน์แหล่งข้อมูลที่กลุ่ม Pivot ดําเนินการ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

hideRepeatedLabels()

ซ่อนป้ายกำกับที่ซ้ำกันสำหรับการจัดกลุ่มนี้ หากซ่อนป้ายกำกับอยู่แล้ว การดำเนินการนี้จะไม่มีผล หากเรียกใช้เมธอดนี้ก่อนที่จะมีการจัดกลุ่มแถวหรือคอลัมน์หลายรายการ เมื่อมีการเพิ่มการจัดกลุ่มเพิ่มเติม ระบบจะซ่อนป้ายกำกับที่ซ้ำกัน

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isSortAscending()

แสดง true หากการจัดเรียงเป็นจากน้อยไปมาก และแสดง false หากลำดับการจัดเรียงเป็นจากมากไปน้อย

รีเทิร์น

Boolean — true หากลำดับการจัดเรียงเป็นจากน้อยไปมาก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

moveToIndex(index)

ย้ายกลุ่มนี้ไปยังตำแหน่งที่ระบุในรายการกลุ่มแถวหรือคอลัมน์ปัจจุบัน ดัชนีเหล่านี้ เป็นแบบ 0 เช่น หากควรกำหนดให้กลุ่มนี้ย้ายไปที่ตำแหน่งแรก คุณควรเรียกใช้เมธอดนี้ด้วย 0

พารามิเตอร์

ชื่อประเภทคำอธิบาย
indexIntegerดัชนีที่จะย้ายการจัดกลุ่มนี้ไป

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

remove()

นำกลุ่ม Pivot นี้ออกจากตาราง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeManualGroupingRule(groupName)

นำกฎการจัดกลุ่มที่กำหนดเองซึ่งมี groupName ที่ระบุออก

พารามิเตอร์

ชื่อประเภทคำอธิบาย
groupNameStringชื่อของกฎการจัดกลุ่มที่จะนำออก

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

resetDisplayName()

รีเซ็ตชื่อที่แสดงของกลุ่มนี้ในตาราง Pivot เป็นค่าเริ่มต้น

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setDateTimeGroupingRule(dateTimeGroupingRuleType)

ตั้งค่ากฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot

หากต้องการนำกฎออก ให้ใช้ clearGroupingRule()

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeประเภทกฎที่จะตั้งค่า

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setDisplayName(name)

กำหนดชื่อที่แสดงของกลุ่มนี้ในตาราง Pivot

พารามิเตอร์

ชื่อประเภทคำอธิบาย
nameStringชื่อที่แสดงที่จะตั้งค่า

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setGroupLimit(countLimit)

ตั้งค่าขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot การดำเนินการนี้ใช้ได้กับ DataSourcePivotTable เท่านั้น

พารามิเตอร์

ชื่อประเภทคำอธิบาย
countLimitIntegerขีดจำกัดจำนวนแถวหรือคอลัมน์ที่จะตั้งค่า ต้องเป็นค่าบวก

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setHistogramGroupingRule(minValue, maxValue, intervalSize)

ตั้งค่ากฎการจัดกลุ่มฮิสโตแกรมสำหรับกลุ่ม Pivot นี้ กฎฮิสโทแกรมจะจัดระเบียบค่าในคอลัมน์ข้อมูลต้นทางเป็นกลุ่มที่มีขนาดคงที่ ค่าทั้งหมดตั้งแต่ minValue ถึง maxValue จะจัดกลุ่มขนาด interval ค่าทั้งหมดที่ต่ำกว่า minValue จะอยู่ใน Bucket เดียวกัน เช่นเดียวกับค่าทั้งหมดที่มากกว่า maxValue

พารามิเตอร์

ชื่อประเภทคำอธิบาย
minValueIntegerค่าต่ำสุดสำหรับรายการที่จะจัดกลุ่ม ระบบจะรวมค่าที่ต่ำกว่านี้ ไว้ใน Bucket เดียว
maxValueIntegerค่าสูงสุดสำหรับรายการที่จะจัดกลุ่ม ระบบจะรวมค่าที่มากกว่านี้ ไว้ในที่เก็บข้อมูลเดียว
intervalSizeInteger

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

showRepeatedLabels()

เมื่อมีการจัดกลุ่มแถวหรือคอลัมน์มากกว่า 1 รายการ วิธีนี้จะแสดงป้ายกำกับการจัดกลุ่มนี้ สำหรับแต่ละรายการของการจัดกลุ่มถัดไป หากมีการทำซ้ำป้ายกำกับอยู่แล้ว การดำเนินการนี้จะไม่มีผล หากมีการเรียกใช้วิธีนี้ก่อนที่จะมีการจัดกลุ่มแถวหรือคอลัมน์หลายรายการ เมื่อมีการเพิ่มการจัดกลุ่มเพิ่มเติม ระบบจะแสดงป้ายกำกับที่ซ้ำกัน

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

showTotals(showTotals)

กำหนดว่าจะแสดงค่ารวมสำหรับกลุ่ม Pivot นี้ในตารางหรือไม่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
showTotalsBooleanเลือกว่าจะแสดงผลรวมหรือไม่

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

sortAscending()

ตั้งค่าลำดับการจัดเรียงเป็นจากน้อยไปหามาก

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

sortBy(value, oppositeGroupValues)

จัดเรียงกลุ่มนี้ตาม PivotValue ที่ระบุสำหรับค่าจาก 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']);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuePivotValueค่า Pivot ที่จะใช้จัดเรียง
oppositeGroupValuesObject[]ค่าของกลุ่ม Pivot ตรงข้าม (กลุ่มคอลัมน์หากจัดเรียงกลุ่มแถว หรือกลุ่มแถวหากจัดเรียงกลุ่มคอลัมน์) ที่ใช้ในการจัดเรียง ลำดับของ ค่าเหล่านี้จะกำหนดลำดับความสำคัญสำหรับการตัดสินในกรณีที่เสมอกัน

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

sortDescending()

ตั้งค่าลำดับการจัดเรียงเป็นจากมากไปหาน้อย

รีเทิร์น

PivotGroup - กลุ่ม Pivot สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

totalsAreShown()

แสดงผลว่าระบบแสดงค่ารวมสำหรับกลุ่ม Pivot นี้อยู่หรือไม่

รีเทิร์น

Boolean — true หากแสดงค่ารวมสำหรับกลุ่ม Pivot นี้ มิฉะนั้นจะแสดงผล false

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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