Class PivotGroup

PivotGroup

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addManualGroupingRule(groupName, groupMembers)PivotGroupเพิ่มกฎการจัดกลุ่มด้วยตนเองสําหรับกลุ่ม Pivot นี้
areLabelsRepeated()Booleanแสดงผลว่าป้ายกำกับแสดงซ้ำหรือไม่
clearGroupingRule()PivotGroupนํากฎการจัดกลุ่มออกจากกลุ่ม Pivot นี้
clearSort()PivotGroupนำการจัดเรียงที่ใช้กับกลุ่มนี้ออก
getDateTimeGroupingRule()DateTimeGroupingRuleแสดงกฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot หรือ null หากไม่ได้ตั้งค่ากฎการจัดกลุ่มวันที่และเวลา
getDimension()Dimensionแสดงผลว่ารายการนี้เป็นกลุ่มแถวหรือกลุ่มคอลัมน์
getGroupLimit()PivotGroupLimitแสดงผลขีดจํากัดของกลุ่ม Pivot ในกลุ่ม Pivot
getIndex()Integerแสดงผลดัชนีของกลุ่ม Pivot นี้ในลําดับกลุ่มปัจจุบัน
getPivotTable()PivotTableแสดง PivotTable ของการจัดกลุ่มนี้
getSourceDataColumn()Integerแสดงผลจํานวนคอลัมน์ข้อมูลต้นทางที่กลุ่มนี้สรุป
getSourceDataSourceColumn()DataSourceColumnแสดงผลคอลัมน์แหล่งข้อมูลที่กลุ่ม 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()

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

รีเทิร์น

Booleantrue หากป้ายกำกับซ้ำกัน มิเช่นนั้นแสดงผล 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 — กฎการจัดกลุ่มวันที่และเวลา

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

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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 — ขีดจํากัดของกลุ่ม 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-ฐาน หากกลุ่มนี้สรุปข้อมูลต้นทางในคอลัมน์ "ก" ของสเปรดชีต วิธีการนี้จะแสดงผลเป็น 1

รีเทิร์น

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

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

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

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

getSourceDataSourceColumn()

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

รีเทิร์น

DataSourceColumn — คอลัมน์แหล่งข้อมูลของกลุ่ม 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 หากการเรียงลำดับเป็นแบบจากมากไปน้อย

รีเทิร์น

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

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

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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 ไว้ในที่เก็บข้อมูลเดียวกัน รวมถึงค่าทั้งหมดที่มากกว่า maxValue

พารามิเตอร์

ชื่อประเภทคำอธิบาย
minValueIntegerค่าต่ำสุดสำหรับรายการที่จะใส่ลงในที่เก็บข้อมูล ระบบจะรวมค่าที่น้อยกว่าค่านี้ไว้ในที่เก็บข้อมูลเดียว
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 นี้หรือไม่

รีเทิร์น

Booleantrue หากมีการแสดงค่าทั้งหมดสําหรับกลุ่ม Pivot นี้ มิเช่นนั้นระบบจะแสดงผล false

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

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

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