เข้าถึงและแก้ไขกลุ่มกลุ่มย่อยของตาราง 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 นี้
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
groupName | String | ชื่อของกฎการจัดกลุ่มนี้ |
groupMembers | Object[] | ค่าที่รวมอยู่ในกฎการจัดกลุ่มนี้ |
รีเทิร์น
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
— กฎการจัดกลุ่มวันที่และเวลา
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDimension()
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 หาก
กลุ่มนี้สรุปแหล่งข้อมูลในคอลัมน์ "A" ของสเปรดชีตที่เมธอดนี้แสดง 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
หากลำดับการจัดเรียงคือ
จากมากไปน้อย
รีเทิร์น
Boolean
— true
หากลำดับการจัดเรียงมาจากน้อยไปมาก
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveToIndex(index)
ย้ายกลุ่มนี้ไปยังตำแหน่งที่ระบุไว้ในรายการกลุ่มแถวหรือคอลัมน์ปัจจุบัน เหล่านี้
ดัชนีมีฐานเป็น 0 ตัวอย่างเช่น ถ้ากลุ่มนี้ควรถูกย้ายไปยังตำแหน่งแรก
ควรเรียกเมธอดด้วย 0
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
index | Integer | ดัชนีที่จะย้ายการจัดกลุ่มนี้ไป |
รีเทิร์น
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
ที่ระบุออก
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
groupName | String | ชื่อของกฎการจัดกลุ่มที่จะนำออก |
รีเทิร์น
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()
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
dateTimeGroupingRuleType | DateTimeGroupingRuleType | ประเภทของกฎที่จะตั้งค่า |
รีเทิร์น
PivotGroup
— กลุ่ม Pivot สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDisplayName(name)
ตั้งชื่อที่แสดงของกลุ่มนี้ในตาราง Pivot
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อที่แสดงที่จะตั้งค่า |
รีเทิร์น
PivotGroup
— กลุ่ม Pivot สำหรับการทำห่วงโซ่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setGroupLimit(countLimit)
กำหนดขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot การดำเนินการนี้ใช้ได้กับ DataSourcePivotTable
เท่านั้น
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
countLimit | Integer | จำนวนแถวหรือคอลัมน์ที่จะตั้งค่าสูงสุด ต้องเป็นค่าบวก |
รีเทิร์น
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
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
minValue | Integer | ค่าต่ำสุดสำหรับการวางรายการลงในที่เก็บข้อมูล ค่าน้อยกว่านี้ จะรวมกันเป็นที่เก็บข้อมูลเดียว |
maxValue | Integer | ค่าสูงสุดสำหรับรายการที่จะวางในที่เก็บข้อมูล ค่าที่มากกว่านี้ จะรวมกันเป็นที่เก็บข้อมูลเดียว |
intervalSize | Integer |
รีเทิร์น
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 นี้ในตารางหรือไม่
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
showTotals | Boolean | จะแสดงยอดรวมหรือไม่ |
รีเทิร์น
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. 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']);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
value | PivotValue | ค่า Pivot ที่ใช้จัดเรียง |
oppositeGroupValues | Object[] | ค่าของกลุ่ม 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