Class Range

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ช่วง

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
activate()Rangeตั้งค่าช่วงที่ระบุเป็น active range โดยใช้เซลล์ด้านบนซ้ายในช่วงเป็น current cell
activateAsCurrentCell()Rangeตั้งค่าเซลล์ที่ระบุเป็น current cell
addDeveloperMetadata(key)Rangeเพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์ที่ระบุในช่วง
addDeveloperMetadata(key, visibility)Rangeเพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์ที่ระบุและระดับการเข้าถึงให้กับช่วง
addDeveloperMetadata(key, value)Rangeเพิ่มข้อมูลเมตาของนักพัฒนาแอปซึ่งมีคีย์และค่าที่ระบุในช่วง
addDeveloperMetadata(key, value, visibility)Rangeเพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์ ค่า และระดับการมองเห็นที่ระบุ
applyColumnBanding()Bandingใช้ธีมแถบสีคอลัมน์เริ่มต้นกับช่วงดังกล่าว
applyColumnBanding(bandingTheme)Bandingใช้ธีมแถวคอลัมน์ที่ระบุกับช่วง
applyColumnBanding(bandingTheme, showHeader, showFooter)Bandingใช้ธีมแนวคอลัมน์ที่ระบุกับช่วงที่มีการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ
applyRowBanding()Bandingใช้ธีมแถวแถวเริ่มต้นกับช่วง
applyRowBanding(bandingTheme)Bandingใช้ธีมแถวแถวที่ระบุกับช่วง
applyRowBanding(bandingTheme, showHeader, showFooter)Bandingใช้ธีมแถวสีแถวที่ระบุไว้กับช่วงการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ
autoFill(destination, series)voidกรอกข้อมูล destinationRange ตามข้อมูลในช่วงนี้
autoFillToNeighbor(series)voidคํานวณช่วงที่จะเติมข้อมูลใหม่โดยอิงจากเซลล์ใกล้เคียง และจะป้อนช่วงนั้นด้วยค่าใหม่ตามข้อมูลที่อยู่ในช่วงนี้โดยอัตโนมัติ
breakApart()Rangeแยกเซลล์แบบหลายคอลัมน์ในช่วงออกเป็นเซลล์ที่ต้องการอีกครั้ง
canEdit()Booleanกําหนดว่าผู้ใช้มีสิทธิ์แก้ไขทุกเซลล์ในช่วงดังกล่าวหรือไม่
check()Rangeเปลี่ยนสถานะของช่องทําเครื่องหมายเป็น "เลือกไว้"
clear()Rangeล้างช่วงเนื้อหา รูปแบบ และกฎการตรวจสอบข้อมูล
clear(options)Rangeล้างช่วงของเนื้อหา รูปแบบ กฎการตรวจสอบข้อมูล และ/หรือความคิดเห็น ตามที่ระบุไว้ในตัวเลือกขั้นสูงที่ระบุไว้
clearContent()Rangeล้างเนื้อหาของช่วงโดยไม่ต้องเปลี่ยนแปลงการจัดรูปแบบ
clearDataValidations()Rangeล้างกฎการตรวจสอบข้อมูลในช่วง
clearFormat()Rangeล้างการจัดรูปแบบสําหรับช่วงนี้
clearNote()Rangeล้างโน้ตในเซลล์ที่ระบุ
collapseGroups()Rangeยุบกลุ่มทั้งหมดที่อยู่ในช่วง
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)voidคัดลอกการจัดรูปแบบของช่วงไปยังตําแหน่งที่ระบุ
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)voidคัดลอกการจัดรูปแบบของช่วงไปยังตําแหน่งที่ระบุ
copyTo(destination)voidคัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงอื่นของเซลล์
copyTo(destination, copyPasteType, transposed)voidคัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงอื่นของเซลล์
copyTo(destination, options)voidคัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงอื่นของเซลล์
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)voidคัดลอกเนื้อหาของช่วงไปยังตําแหน่งที่กําหนด
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)voidคัดลอกเนื้อหาของช่วงไปยังตําแหน่งที่กําหนด
createDataSourcePivotTable(dataSource)DataSourcePivotTableสร้างตาราง Pivot ของแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูล ซึ่งตรึงอยู่ที่เซลล์แรกในช่วงนี้
createDataSourceTable(dataSource)DataSourceTableสร้างตารางแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูล ซึ่งถูกตรึงที่เซลล์แรกในช่วงนี้
createDeveloperMetadataFinder()DeveloperMetadataFinderแสดงผล DeveloperMetadataFinderApi สําหรับการค้นหาข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ภายในขอบเขตของช่วงนี้
createFilter()Filterสร้างตัวกรองและนําไปใช้กับช่วงที่ระบุในชีต
createPivotTable(sourceData)PivotTableสร้างตาราง Pivot ที่ว่างเปล่าจาก sourceData ที่ระบุซึ่งตรึงอยู่กับเซลล์แรกในช่วงนี้
createTextFinder(findText)TextFinderสร้างเครื่องมือค้นหาข้อความสําหรับช่วงดังกล่าวซึ่งจะค้นหาและแทนที่ข้อความในช่วงนี้ได้
deleteCells(shiftDimension)voidลบช่วงเซลล์นี้
expandGroups()Rangeขยายกลุ่มที่ยุบซึ่งมีช่วงหรือปุ่มสลับการควบคุมที่ตัดกับช่วงนี้
getA1Notation()Stringส่งคืนคําอธิบายสตริงของช่วงในรูปแบบ A1
getBackground()Stringแสดงสีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง (เช่น '#ffffff')
getBackgroundObject()Colorแสดงสีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง
getBackgroundObjects()Color[][]แสดงสีพื้นหลังของเซลล์ในช่วง
getBackgrounds()String[][]แสดงสีพื้นหลังของเซลล์ในช่วง (เช่น '#ffffff')
getBandings()Banding[]แสดงแถบสีทั้งหมดที่ใช้กับเซลล์ในช่วงนี้
getCell(row, column)Rangeแสดงผลเซลล์ที่ต้องการในช่วง
getColumn()Integerแสดงผลตําแหน่งคอลัมน์เริ่มต้นของช่วงนี้
getDataRegion()Rangeแสดงผลสําเนาของช่วงที่ขยายใน Direction 4 หลัก เพื่อครอบคลุมเซลล์ทั้งหมดที่ติดกันซึ่งมีข้อมูลอยู่ในนั้น
getDataRegion(dimension)Rangeแสดงผลสําเนาของช่วงที่ขยาย Direction.UP และ Direction.DOWN หากมิติข้อมูลที่ระบุคือ Dimension.ROWS หรือ Direction.NEXT และ Direction.PREVIOUS หากมิติข้อมูลคือ Dimension.COLUMNS
getDataSourceFormula()DataSourceFormulaแสดงผล DataSourceFormula สําหรับเซลล์แรกในช่วง หรือ null หากเซลล์ไม่มีสูตรแหล่งข้อมูล
getDataSourceFormulas()DataSourceFormula[]แสดง DataSourceFormula ของเซลล์ในช่วงนั้น
getDataSourcePivotTables()DataSourcePivotTable[]รับตาราง Pivot ของแหล่งข้อมูลทั้งหมดที่ซ้อนกันกับช่วง
getDataSourceTables()DataSourceTable[]รับตารางแหล่งข้อมูลทั้งหมดซ้อนทับกับช่วง
getDataSourceUrl()Stringแสดงผล URL สําหรับข้อมูลในช่วงนี้ซึ่งสามารถใช้สร้างแผนภูมิและคําค้นหาได้
getDataTable()DataTableแสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น DataTable
getDataTable(firstRowIsHeader)DataTableแสดงผลข้อมูลภายในช่วงนี้เป็นตารางข้อมูล
getDataValidation()DataValidationแสดงกฎการตรวจสอบข้อมูลสําหรับเซลล์ด้านบนซ้ายในช่วง
getDataValidations()DataValidation[][]แสดงกฎการตรวจสอบข้อมูลสําหรับเซลล์ทั้งหมดในช่วง
getDeveloperMetadata()DeveloperMetadata[]รับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับช่วงนี้
getDisplayValue()Stringแสดงผลค่าที่แสดงของเซลล์ด้านบนซ้ายในช่วง
getDisplayValues()String[][]แสดงผลตารางกริดสี่เหลี่ยมผืนผ้าสําหรับช่วงนี้
getFilter()Filterแสดงตัวกรองในชีตที่เป็นของช่วงนี้ หรือ null หากไม่มีตัวกรองในแผ่นงาน
getFontColorObject()Colorแสดงสีแบบอักษรของเซลล์ที่มุมบนซ้ายของช่วง
getFontColorObjects()Color[][]แสดงสีแบบอักษรของเซลล์ในช่วง
getFontFamilies()String[][]แสดงชุดแบบอักษรของเซลล์ในช่วง
getFontFamily()Stringแสดงแบบอักษรของเซลล์ที่มุมบนซ้ายของช่วง
getFontLine()Stringรับรูปแบบของเส้นเซลล์ในมุมซ้ายบนของช่วง ('underline', 'line-through' หรือ 'none')
getFontLines()String[][]รับรูปแบบของเส้นในช่วงของเซลล์ ('underline', 'line-through' หรือ 'none')
getFontSize()Integerแสดงผลขนาดแบบอักษรในจุดของเซลล์ที่มุมบนซ้ายของช่วง
getFontSizes()Integer[][]แสดงขนาดแบบอักษรของเซลล์ในช่วง
getFontStyle()Stringแสดงรูปแบบแบบอักษร ('italic' หรือ 'normal') ของเซลล์ในมุมซ้ายบนของช่วง
getFontStyles()String[][]แสดงรูปแบบแบบอักษรของเซลล์ในช่วง
getFontWeight()Stringแสดงน้ําหนักแบบอักษร (ปกติ/ตัวหนา) ของเซลล์ที่มุมบนซ้ายของช่วง
getFontWeights()String[][]แสดงน้ําหนักแบบอักษรของเซลล์ในช่วง
getFormula()Stringแสดงผลสูตร (รูปแบบ A1) สําหรับเซลล์ซ้ายบนของช่วง หรือสตริงว่าง ถ้าเซลล์ว่างเปล่าหรือไม่มีสูตร
getFormulaR1C1()Stringแสดงผลสูตร (ค่า R1C1) สําหรับเซลล์ที่ระบุ หรือ null หากไม่มีค่า
getFormulas()String[][]แสดงผลสูตร (รูปแบบ A1) สําหรับเซลล์ในช่วง
getFormulasR1C1()String[][]แสดงผลสูตร (ค่า R1C1) สําหรับเซลล์ในช่วง
getGridId()Integerแสดงผลรหัสตารางกริดของชีตระดับบนสุดของช่วง ##39
getHeight()Integerแสดงผลความสูงของช่วง
getHorizontalAlignment()Stringแสดงการจัดข้อความแนวนอน (ซ้าย/กลาง/ขวา) ของเซลล์ในมุมซ้ายบนของช่วง
getHorizontalAlignments()String[][]แสดงการจัดข้อความแนวนอนของเซลล์ในช่วง
getLastColumn()Integerแสดงผลตําแหน่งคอลัมน์สิ้นสุด
getLastRow()Integerแสดงผลตําแหน่งแถวสุดท้าย
getMergedRanges()Range[]แสดงผลอาร์เรย์ของออบเจ็กต์ Range ที่แสดงเซลล์ที่ผสานที่อยู่ภายในช่วงปัจจุบันทั้งหมด หรือมีเซลล์อย่างน้อย 1 เซลล์ในช่วงปัจจุบัน
getNextDataCell(direction)Rangeเริ่มต้นจากเซลล์ในคอลัมน์แรกและแถวของช่วง จะแสดงผลเซลล์ถัดไปในทิศทางที่กําหนดซึ่งเป็นขอบของช่วงเซลล์ที่ต่อเนื่องซึ่งมีข้อมูลในเซลล์หรือเซลล์ที่ขอบของสเปรดชีตในทิศทางนั้น
getNote()Stringแสดงผลโน้ตที่เชื่อมโยงกับช่วงที่ระบุ
getNotes()String[][]แสดงผลบันทึกที่เชื่อมโยงกับเซลล์ในช่วง
getNumColumns()Integerแสดงผลจํานวนคอลัมน์ในช่วงนี้
getNumRows()Integerแสดงผลจํานวนแถวในช่วงนี้
getNumberFormat()Stringดูการจัดรูปแบบตัวเลขหรือวันที่ของเซลล์ด้านบนซ้ายของช่วงที่ระบุ
getNumberFormats()String[][]แสดงผลจํานวนตัวเลขหรือวันที่ของเซลล์ในช่วง
getRichTextValue()RichTextValueแสดงผลค่า Rich Text สําหรับเซลล์ซ้ายบนของช่วง หรือ null หากค่าในเซลล์ไม่ใช่ข้อความ
getRichTextValues()RichTextValue[][]แสดงผลค่า Rich Text สําหรับเซลล์ในช่วงนั้น
getRow()Integerแสดงผลตําแหน่งแถวสําหรับช่วงนี้
getRowIndex()Integerแสดงผลตําแหน่งแถวสําหรับช่วงนี้
getSheet()Sheetแสดงผลแผ่นงานที่เป็นของช่วงนี้
getTextDirection()TextDirectionแสดงทิศทางข้อความสําหรับเซลล์ซ้ายบนของช่วง
getTextDirections()TextDirection[][]แสดงทิศทางข้อความของเซลล์ในช่วง
getTextRotation()TextRotationแสดงผลการตั้งค่าการหมุนข้อความสําหรับเซลล์ซ้ายบนของช่วง
getTextRotations()TextRotation[][]แสดงการตั้งค่าการหมุนข้อความสําหรับเซลล์ในช่วงนั้น
getTextStyle()TextStyleแสดงผลรูปแบบข้อความสําหรับเซลล์ซ้ายบนของช่วง
getTextStyles()TextStyle[][]แสดงผลรูปแบบข้อความสําหรับเซลล์ในช่วง
getValue()Objectแสดงผลค่าของเซลล์ด้านบนซ้ายในช่วง
getValues()Object[][]แสดงผลตารางกริดสี่เหลี่ยมผืนผ้าสําหรับช่วงนี้
getVerticalAlignment()Stringแสดงการจัดข้อความแนวตั้ง (ด้านบน/ตรงกลาง/ด้านล่าง) ของเซลล์ที่มุมซ้ายบนของช่วง
getVerticalAlignments()String[][]แสดงการวางแนวในแนวตั้งของเซลล์ในช่วง
getWidth()Integerแสดงผลความกว้างของช่วงเป็นคอลัมน์
getWrap()Booleanแสดงผลว่าข้อความในเซลล์รวมหรือไม่
getWrapStrategies()WrapStrategy[][]แสดงผลกลยุทธ์การตัดข้อความสําหรับเซลล์ในช่วง
getWrapStrategy()WrapStrategyแสดงผลกลยุทธ์การตัดข้อความสําหรับเซลล์ด้านซ้ายบนของช่วง
getWraps()Boolean[][]แสดงผลว่าข้อความในเซลล์รวมหรือไม่
insertCells(shiftDimension)Rangeแทรกเซลล์ว่างลงในช่วงนี้
insertCheckboxes()Rangeแทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง กําหนดค่าด้วย true เพื่อทําเครื่องหมาย และ false เพื่อยกเลิกการเลือก
insertCheckboxes(checkedValue)Rangeแทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง กําหนดค่าด้วยค่าที่กําหนดเองสําหรับทําเครื่องหมาย และสตริงว่างสําหรับยกเลิกการเลือก
insertCheckboxes(checkedValue, uncheckedValue)Rangeแทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง กําหนดค่าด้วยค่าที่กําหนดเองสําหรับสถานะที่เลือกและไม่เลือก
isBlank()Booleanแสดงผล true หากช่วงว่างเปล่าทั้งหมด
isChecked()Booleanแสดงผลว่าเซลล์ทั้งหมดในช่วงดังกล่าวมีสถานะช่องทําเครื่องหมายเป็น 'ตรวจสอบแล้ว' หรือไม่
isEndColumnBounded()Booleanระบุว่าจุดสิ้นสุดของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่
isEndRowBounded()Booleanระบุว่าจุดสิ้นสุดของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่
isPartOfMerge()Booleanแสดงผล true หากเซลล์ในช่วงปัจจุบันทับซ้อนเซลล์ที่ผสาน
isStartColumnBounded()Booleanระบุว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่
isStartRowBounded()Booleanระบุว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่
merge()Rangeผสานเซลล์ในช่วงเข้าด้วยกันเป็นบล็อกเดียว
mergeAcross()Rangeผสานเซลล์ในช่วงที่อยู่ในคอลัมน์ต่างๆ ของช่วง
mergeVertically()Rangeผสานเซลล์ในช่วงเข้าด้วยกัน
moveTo(target)voidตัดและวาง (ทั้งรูปแบบและค่า) จากช่วงนี้ไปยังช่วงเป้าหมาย
offset(rowOffset, columnOffset)Rangeแสดงผลช่วงใหม่ที่จะชดเชยจากช่วงนี้ตามจํานวนแถวและคอลัมน์ที่ระบุ (ซึ่งอาจเป็นค่าลบได้)
offset(rowOffset, columnOffset, numRows)Rangeแสดงผลช่วงใหม่ซึ่งสัมพันธ์กับช่วงปัจจุบัน ตําแหน่งซ้ายบนจะถูกออฟเซ็ตจากช่วงปัจจุบันโดยแถวและคอลัมน์ที่ระบุ และมีความสูงที่ระบุในเซลล์
offset(rowOffset, columnOffset, numRows, numColumns)Rangeแสดงผลช่วงใหม่ซึ่งสัมพันธ์กับช่วงปัจจุบัน ตําแหน่งซ้ายบนจะถูกออฟเซ็ตจากช่วงปัจจุบันตามแถวและคอลัมน์ที่ระบุ รวมถึงความสูงและความกว้างที่กําหนดในเซลล์
protect()Protectionสร้างออบเจ็กต์ที่สามารถป้องกันการแก้ไขช่วง ยกเว้นผู้ใช้ที่มีสิทธิ์
randomize()Rangeสุ่มลําดับของแถวในช่วงที่กําหนด
removeCheckboxes()Rangeนําช่องทําเครื่องหมายทั้งหมดออกจากช่วง
removeDuplicates()Rangeนําแถวภายในช่วงนี้ที่มีค่าซึ่งซ้ํากับค่าในแถวก่อนหน้าออก
removeDuplicates(columnsToCompare)Rangeนําแถวภายในช่วงนี้ที่มีค่าในคอลัมน์ที่ระบุ ซึ่งซ้ํากับค่าในแถวก่อนหน้า
setBackground(color)Rangeตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วงในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')
setBackgroundObject(color)Rangeตั้งค่าสีพื้นหลังของทุกเซลล์ในช่วง
setBackgroundObjects(color)Rangeตั้งค่าตารางกริดของสี่เหลี่ยมผืนผ้าสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
setBackgroundRGB(red, green, blue)Rangeตั้งค่าพื้นหลังเป็นสีที่ระบุโดยใช้ค่า RGB (จํานวนเต็มระหว่าง 0 ถึง 255)
setBackgrounds(color)Rangeตั้งค่าตารางกริดของสี่เหลี่ยมผืนผ้าสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
setBorder(top, left, bottom, right, vertical, horizontal)Rangeตั้งค่าคุณสมบัติเส้นขอบ
setBorder(top, left, bottom, right, vertical, horizontal, color, style)Rangeตั้งค่าคุณสมบัติเส้นขอบด้วยสีและ/หรือสไตล์
setDataValidation(rule)Rangeตั้งกฎการตรวจสอบข้อมูล 1 กฎกับทุกเซลล์ในช่วงนั้น
setDataValidations(rules)Rangeตั้งค่ากฎการตรวจสอบข้อมูลสําหรับเซลล์ทั้งหมดในช่วง
setFontColor(color)Rangeตั้งค่าสีแบบอักษรในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')
setFontColorObject(color)Rangeตั้งค่าสีแบบอักษรของช่วงที่ระบุ
setFontColorObjects(colors)Rangeตั้งค่าตารางกริดของสีแบบอักษรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
setFontColors(colors)Rangeตั้งค่าตารางกริดของสีแบบอักษรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
setFontFamilies(fontFamilies)Rangeตั้งค่าตารางกริดรูปสี่เหลี่ยมผืนผ้าของชุดแบบอักษร (ต้องตรงกับขนาดของช่วงนี้)
setFontFamily(fontFamily)Rangeตั้งค่าชุดแบบอักษร เช่น "eCPM" หรือ "Hไม้"
setFontLine(fontLine)Rangeกําหนดรูปแบบเส้นแบบอักษรของช่วงที่ระบุ ('underline', 'line-through' หรือ 'none')
setFontLines(fontLines)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับรูปแบบเส้น (ต้องตรงกับขนาดของช่วงนี้)
setFontSize(size)Rangeกําหนดขนาดแบบอักษร โดยขนาดจะเป็นขนาดจุดที่จะใช้
setFontSizes(sizes)Rangeตั้งค่าตารางกริดของรูปสี่เหลี่ยมผืนผ้าขนาดตัวอักษร (ต้องตรงกับขนาดของช่วงนี้)
setFontStyle(fontStyle)Rangeตั้งค่ารูปแบบตัวอักษรสําหรับช่วงที่ระบุ ('italic' หรือ 'normal')
setFontStyles(fontStyles)Rangeตั้งค่าตารางกริดของรูปแบบตัวอักษรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
setFontWeight(fontWeight)Rangeตั้งค่าน้ําหนักของแบบอักษรให้อยู่ในช่วงที่กําหนด (ปกติ/ตัวหนา)
setFontWeights(fontWeights)Rangeตั้งค่าตารางกริดของแบบอักษรแบบสี่เหลี่ยมผืนผ้า (ต้องตรงกับมิติข้อมูลของช่วงนี้)
setFormula(formula)Rangeอัปเดตสูตรของช่วงนี้
setFormulaR1C1(formula)Rangeอัปเดตสูตรของช่วงนี้
setFormulas(formulas)Rangeตั้งค่าตารางกริดของสูตรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
setFormulasR1C1(formulas)Rangeตั้งค่าตารางกริดของสูตรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
setHorizontalAlignment(alignment)Rangeตั้งค่าการจัดข้อความแนวนอน (ซ้ายไปขวา) ของช่วงที่ระบุ (ซ้าย/กลาง/ขวา)
setHorizontalAlignments(alignments)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับการปรับแนวในแนวนอน
setNote(note)Rangeตั้งค่าโน้ตให้เป็นค่าที่ระบุ
setNotes(notes)Rangeตั้งค่าตารางกริดของสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
setNumberFormat(numberFormat)Rangeตั้งค่ารูปแบบตัวเลขหรือวันที่เป็นสตริงการจัดรูปแบบที่ระบุ
setNumberFormats(numberFormats)Rangeตั้งค่าตารางกริดของรูปแบบตัวเลขหรือวันที่ (ต้องตรงกับมิติข้อมูลของช่วงนี้)
setRichTextValue(value)Rangeตั้งค่า Rich Text สําหรับเซลล์ในช่วงนั้น
setRichTextValues(values)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าด้วยค่า Rich Text
setShowHyperlink(showHyperlink)Rangeตั้งค่าว่าช่วงดังกล่าวควรจะแสดงไฮเปอร์ลิงก์หรือไม่
setTextDirection(direction)Rangeตั้งค่าทิศทางข้อความของเซลล์ในช่วง
setTextDirections(directions)Rangeตั้งค่าตารางกริดรูปสี่เหลี่ยมผืนผ้าของเส้นทางข้อความ
setTextRotation(degrees)Rangeตั้งค่าการหมุนเวียนข้อความสําหรับเซลล์ในช่วงนั้น
setTextRotation(rotation)Rangeตั้งค่าการหมุนเวียนข้อความสําหรับเซลล์ในช่วงนั้น
setTextRotations(rotations)Rangeตั้งค่าตารางกริดแบบหมุนของข้อความแบบสี่เหลี่ยมผืนผ้า
setTextStyle(style)Rangeตั้งค่ารูปแบบข้อความสําหรับเซลล์ในช่วง
setTextStyles(styles)Rangeตั้งค่าตารางกริดของรูปแบบข้อความสี่เหลี่ยมผืนผ้า
setValue(value)Rangeตั้งค่าของช่วง
setValues(values)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าของค่า (ต้องตรงกับมิติข้อมูลของช่วงนี้)
setVerticalAlignment(alignment)Rangeตั้งค่าการวางแนวในแนวตั้ง (บนลงล่าง) สําหรับช่วงที่ระบุ (ด้านบน/ตรงกลาง/ด้านล่าง)
setVerticalAlignments(alignments)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าของการจัดข้อความแนวตั้ง (ต้องตรงกับขนาดของช่วงนี้)
setVerticalText(isVertical)Rangeตั้งค่าว่าจะให้ซ้อนข้อความสําหรับเซลล์ในช่วงหรือไม่
setWrap(isWrapEnabled)Rangeตั้งค่าการตัดเซลล์ของช่วงที่ระบุ
setWrapStrategies(strategies)Rangeตั้งค่าตารางกริดของกลยุทธ์การรวม
setWrapStrategy(strategy)Rangeตั้งค่ากลยุทธ์การตัดข้อความสําหรับเซลล์ในช่วง
setWraps(isWrapEnabled)Rangeตั้งค่านโยบายตารางกริดแบบสี่เหลี่ยมผืนผ้าของตารางกริด (ต้องตรงกับมิติข้อมูลของช่วงนี้)
shiftColumnGroupDepth(delta)Rangeเปลี่ยนความลึกในการจัดกลุ่มคอลัมน์ของช่วงตามจํานวนที่ระบุ
shiftRowGroupDepth(delta)Rangeเปลี่ยนความลึกในการจัดกลุ่มแถวของช่วงตามจํานวนที่ระบุ
sort(sortSpecObj)Rangeจัดเรียงเซลล์ในช่วงที่ระบุ ตามคอลัมน์ และลําดับที่ระบุ
splitTextToColumns()voidแยกคอลัมน์ข้อความเป็นหลายคอลัมน์โดยพิจารณาจากตัวคั่นที่ระบบตรวจพบโดยอัตโนมัติ
splitTextToColumns(delimiter)voidแยกคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยใช้สตริงที่ระบุเป็นตัวคั่นที่กําหนดเอง
splitTextToColumns(delimiter)voidแยกคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยพิจารณาจากตัวคั่นที่ระบุ
trimWhitespace()Rangeตัดช่องว่าง (เช่น การเว้นวรรค แท็บ หรือบรรทัดใหม่) ในแต่ละเซลล์ในช่วงนี้
uncheck()Rangeเปลี่ยนสถานะของช่องทําเครื่องหมายเป็น "ไม่เลือก"

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

activate()

ตั้งค่าช่วงที่ระบุเป็น active range โดยใช้เซลล์ด้านบนซ้ายในช่วงเป็น current cell

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:D10');
range.activate();

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D10
var activeRange = selection.getActiveRange();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ


activateAsCurrentCell()

ตั้งค่าเซลล์ที่ระบุเป็น current cell

หากเซลล์ที่ระบุอยู่ในช่วงที่มีอยู่ ช่วงดังกล่าวจะกลายเป็นช่วงที่มีการใช้งานกับเซลล์เป็นเซลล์ปัจจุบัน

หากเซลล์ที่ระบุไม่อยู่ในช่วงใดๆ ที่เลือก ระบบจะนําการเลือกที่มีอยู่ออก และเซลล์จะกลายเป็นเซลล์ปัจจุบันและช่วงที่ใช้งานอยู่

หมายเหตุ: Range ที่ระบุต้องประกอบด้วยเซลล์เดียว มิฉะนั้นจะแสดงข้อยกเว้น

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('B5');
range.activate();

var selection = sheet.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

addDeveloperMetadata(key)

เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์ที่ระบุในช่วง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
keyStringคีย์สําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

addDeveloperMetadata(key, visibility)

เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์ที่ระบุและระดับการเข้าถึงให้กับช่วง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
keyStringคีย์สําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่
visibilityDeveloperMetadataVisibilityระดับการเข้าถึงข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

addDeveloperMetadata(key, value)

เพิ่มข้อมูลเมตาของนักพัฒนาแอปซึ่งมีคีย์และค่าที่ระบุในช่วง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
keyStringคีย์สําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่
valueStringค่าสําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

addDeveloperMetadata(key, value, visibility)

เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์ ค่า และระดับการมองเห็นที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
keyStringคีย์สําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่
valueStringค่าสําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่
visibilityDeveloperMetadataVisibilityระดับการเข้าถึงข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

applyColumnBanding()

ใช้ธีมแถบสีคอลัมน์เริ่มต้นกับช่วงดังกล่าว โดยค่าเริ่มต้น แถบสีจะมีส่วนหัวและไม่มีสีส่วนท้าย

ไปกลับ

Banding — แถบสีใหม่

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

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

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

applyColumnBanding(bandingTheme)

ใช้ธีมแถวคอลัมน์ที่ระบุกับช่วง โดยค่าเริ่มต้น แถบสีจะมีส่วนหัว และไม่มีสีส่วนท้าย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bandingThemeBandingThemeธีมสีที่จะใช้กับคอลัมน์ในช่วง

ไปกลับ

Banding — แถบสีใหม่

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

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

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

applyColumnBanding(bandingTheme, showHeader, showFooter)

ใช้ธีมแนวคอลัมน์ที่ระบุกับช่วงที่มีการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bandingThemeBandingThemeธีมสีที่จะใช้กับคอลัมน์ในช่วง
showHeaderBooleanหากเป็น true ระบบจะใช้สีส่วนหัวของธีมในแถบสีในคอลัมน์แรก
showFooterBooleanหากเป็น true ระบบจะใช้สีส่วนท้ายของธีมที่ผูกอยู่กับคอลัมน์สุดท้าย

ไปกลับ

Banding — แถบสีใหม่

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

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

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

applyRowBanding()

ใช้ธีมแถวแถวเริ่มต้นกับช่วง โดยค่าเริ่มต้น แถบสีจะมีส่วนหัวและไม่มีสีส่วนท้าย

ไปกลับ

Banding — แถบสีใหม่

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

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

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

applyRowBanding(bandingTheme)

ใช้ธีมแถวแถวที่ระบุกับช่วง โดยค่าเริ่มต้น แถบสีจะมีส่วนหัวและไม่มีสีส่วนท้าย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bandingThemeBandingThemeธีมสีที่จะใช้กับแถวในช่วง

ไปกลับ

Banding — แถบสีใหม่

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

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

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

applyRowBanding(bandingTheme, showHeader, showFooter)

ใช้ธีมแถวสีแถวที่ระบุไว้กับช่วงการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
bandingThemeBandingThemeธีมสีที่จะใช้กับแถวในช่วง
showHeaderBooleanหากเป็น true ระบบจะใช้สีส่วนหัวของธีมในแถบสีในแถวแรก
showFooterBooleanหากเป็น true ระบบจะใช้สีส่วนท้ายของธีมแถบสีในแถวสุดท้าย

ไปกลับ

Banding — แถบสีใหม่

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

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

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

autoFill(destination, series)

กรอกข้อมูล destinationRange ตามข้อมูลในช่วงนี้ ค่าใหม่จะกําหนดโดยประเภท series ที่ระบุด้วย ช่วงปลายทางนี้ต้องมีช่วงดังกล่าวและขยายในทิศทางเดียวเท่านั้น ตัวอย่างต่อไปนี้เติมตัวเลข A1:A20 จํานวนหนึ่งเพิ่มเติมโดยอิงตามค่าปัจจุบันใน A1:A4

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var destination = sheet.getRange("A1:A20");

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
destinationRangeช่วงที่จะเติมค่าอัตโนมัติ ช่วงปลายทางควรมีช่วงนี้และขยายให้อยู่ในทิศทางเดียวเท่านั้น (ขึ้น ลง ซ้าย หรือขวา)
seriesAutoFillSeriesประเภทของชุดข้อมูล AutoFill ที่ควรใช้เพื่อคํานวณค่าใหม่ ผลกระทบของชุดข้อมูลนี้จะแตกต่างกันไปตามประเภทและจํานวนข้อมูลต้นทาง

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

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

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

autoFillToNeighbor(series)

คํานวณช่วงที่จะเติมข้อมูลใหม่โดยอิงจากเซลล์ใกล้เคียง และจะป้อนช่วงนั้นด้วยค่าใหม่ตามข้อมูลที่อยู่ในช่วงนี้โดยอัตโนมัติ ค่าใหม่เหล่านี้ยังกําหนดโดยประเภท series ที่ระบุด้วย

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

เช่น หาก A1:A20 ชุดตัวเลขที่เพิ่มขึ้นและมีการเรียกใช้ช่วง B1:B4 ที่มีช่วงของวันที่ ระบบจะแทรกค่าใหม่ลงใน B5:B20 เท่านั้น เมื่อใช้วิธีนี้ ค่าใหม่เหล่านี้ " Stick" ในเซลล์ที่มีค่าในคอลัมน์ A

var sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
var sourceRange = sheet.getRange("B1:B4");

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
seriesAutoFillSeriesประเภทของชุดข้อมูล AutoFill ที่ควรใช้เพื่อคํานวณค่าใหม่ ผลกระทบของชุดข้อมูลนี้จะแตกต่างกันไปตามประเภทและจํานวนข้อมูลต้นทาง

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

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

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

breakApart()

แยกเซลล์แบบหลายคอลัมน์ในช่วงออกเป็นเซลล์ที่ต้องการอีกครั้ง

การเรียกใช้ฟังก์ชันนี้ในช่วงจะเท่ากับการเลือกช่วงและคลิกรูปแบบ -> ผสาน -> ยกเลิกการผสาน

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

canEdit()

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

ไปกลับ

Booleantrue หากผู้ใช้มีสิทธิ์แก้ไขทุกเซลล์ในช่วง false ไม่เช่นนั้น

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

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

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

check()

เปลี่ยนสถานะช่องทําเครื่องหมายในช่วงเป็น "เลือกไว้" ละเว้นเซลล์ในช่วงที่ไม่ได้กําหนดค่าที่เลือกหรือไม่ได้เลือกไว้

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'checked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

clear()

ล้างช่วงเนื้อหา รูปแบบ และกฎการตรวจสอบข้อมูล

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clear();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

clear(options)

ล้างช่วงของเนื้อหา รูปแบบ กฎการตรวจสอบข้อมูล และ/หรือความคิดเห็น ตามที่ระบุไว้ในตัวเลือกขั้นสูงที่ระบุไว้ โดยค่าเริ่มต้น ระบบจะล้างข้อมูลทั้งหมด

// The code below clears range C2:G8 in the active sheet, but preserves the format,
// data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});

พารามิเตอร์

ชื่อประเภทคำอธิบาย
optionsObjectออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่แสดงด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อประเภทคำอธิบาย
commentsOnlyBooleanล้างเฉพาะความคิดเห็นหรือไม่
contentsOnlyBooleanล้างเฉพาะเนื้อหาหรือไม่
formatOnlyBooleanเลือกว่าจะล้างเฉพาะรูปแบบ โปรดทราบว่าการล้างรูปแบบจะล้างกฎการตรวจสอบข้อมูลด้วย
validationsOnlyBooleanล้างเฉพาะกฎการตรวจสอบข้อมูลหรือไม่
skipFilteredRowsBooleanหลีกเลี่ยงการล้างแถวที่กรองหรือไม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

clearContent()

ล้างเนื้อหาของช่วงโดยไม่ต้องเปลี่ยนแปลงการจัดรูปแบบ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearContent();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

clearDataValidations()

ล้างกฎการตรวจสอบข้อมูลในช่วง

// Clear the data validation rules for cells A1:B5.
var range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

clearFormat()

ล้างการจัดรูปแบบสําหรับช่วงนี้

การดําเนินการนี้จะล้างการจัดรูปแบบข้อความของเซลล์หรือเซลล์ในช่วง แต่ไม่รีเซ็ตกฎการจัดรูปแบบตัวเลขใดๆ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearFormat();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

clearNote()

ล้างโน้ตในเซลล์ที่ระบุ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearNote();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

collapseGroups()

ยุบกลุ่มทั้งหมดที่อยู่ในช่วง หากไม่มีกลุ่มใดอยู่ในช่วงนั้นเลย ระบบจะยุบกลุ่มที่ขยายลึกที่สุดที่อยู่ในช่วงนั้นไปบางส่วน

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are collapsed.
range.collapseGroups();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

copyFormatToRange(gridId, column, columnEnd, row, rowEnd)

คัดลอกการจัดรูปแบบของช่วงไปยังตําแหน่งที่ระบุ หากปลายทางมีขนาดใหญ่หรือเล็กกว่าช่วงต้นทาง ต้นทางจะซ้ํากันหรือถูกตัดออก โปรดทราบว่าวิธีนี้จะคัดลอกการจัดรูปแบบเท่านั้น

สําหรับคําอธิบายโดยละเอียดของพารามิเตอร์ gridId โปรดดู getGridId()

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
gridIdIntegerรหัสที่ไม่ซ้ํากันของชีตภายในสเปรดชีต โดยไม่คํานึงถึงตําแหน่ง
columnIntegerคอลัมน์แรกของช่วงเป้าหมาย
columnEndIntegerคอลัมน์สิ้นสุดของช่วงเป้าหมาย
rowIntegerแถวเริ่มต้นของช่วงเป้าหมาย
rowEndIntegerแถวสุดท้ายของช่วงเป้าหมาย

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

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

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

ดูเพิ่มเติม


copyFormatToRange(sheet, column, columnEnd, row, rowEnd)

คัดลอกการจัดรูปแบบของช่วงไปยังตําแหน่งที่ระบุ หากปลายทางมีขนาดใหญ่หรือเล็กกว่าช่วงต้นทาง ต้นทางจะซ้ํากันหรือถูกตัดออก โปรดทราบว่าวิธีนี้จะคัดลอกการจัดรูปแบบเท่านั้น

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
sheetSheetชีตเป้าหมาย
columnIntegerคอลัมน์แรกของช่วงเป้าหมาย
columnEndIntegerคอลัมน์สิ้นสุดของช่วงเป้าหมาย
rowIntegerแถวเริ่มต้นของช่วงเป้าหมาย
rowEndIntegerแถวสุดท้ายของช่วงเป้าหมาย

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

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

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

copyTo(destination)

คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงอื่นของเซลล์ ระบบจะคัดลอกทั้งค่าและการจัดรูปแบบ

// The code below copies the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

พารามิเตอร์

ชื่อประเภทคำอธิบาย
destinationRangeช่วงปลายทางที่จะคัดลอกไป เฉพาะตําแหน่งเซลล์ซ้ายบนเท่านั้นที่เกี่ยวข้อง

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

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

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

copyTo(destination, copyPasteType, transposed)

คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงอื่นของเซลล์

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES,
false);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
destinationRangeช่วงปลายทางที่จะคัดลอกไป เฉพาะตําแหน่งเซลล์ซ้ายบนเท่านั้นที่เกี่ยวข้อง
copyPasteTypeCopyPasteTypeประเภทที่กําหนดวิธีวางเนื้อหาของช่วงในปลายทาง
transposedBooleanควรวางช่วงในการวางแนวที่สลับตําแหน่งหรือไม่

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

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

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

copyTo(destination, options)

คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงอื่นของเซลล์ ตามค่าเริ่มต้น ระบบจะคัดลอกทั้งค่าและการจัดรูปแบบ แต่จะลบล้างโดยใช้อาร์กิวเมนต์ขั้นสูงได้

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});

พารามิเตอร์

ชื่อประเภทคำอธิบาย
destinationRangeช่วงปลายทางที่จะคัดลอกไป เฉพาะตําแหน่งเซลล์ซ้ายบนเท่านั้นที่เกี่ยวข้อง
optionsObjectออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่แสดงด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อประเภทคำอธิบาย
formatOnlyBooleanระบุว่าควรคัดลอกเฉพาะรูปแบบเท่านั้น
contentsOnlyBooleanระบุว่าควรคัดลอกเฉพาะเนื้อหา

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

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

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

copyValuesToRange(gridId, column, columnEnd, row, rowEnd)

คัดลอกเนื้อหาของช่วงไปยังตําแหน่งที่กําหนด หากปลายทางมีขนาดใหญ่หรือเล็กกว่าช่วงต้นทาง ต้นทางจะซ้ํากันหรือถูกตัดออก

สําหรับคําอธิบายโดยละเอียดของพารามิเตอร์ gridId โปรดดู getGridId()

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
gridIdIntegerรหัสที่ไม่ซ้ํากันของชีตภายในสเปรดชีต โดยไม่คํานึงถึงตําแหน่ง
columnIntegerคอลัมน์แรกของช่วงเป้าหมาย
columnEndIntegerคอลัมน์สิ้นสุดของช่วงเป้าหมาย
rowIntegerแถวเริ่มต้นของช่วงเป้าหมาย
rowEndIntegerแถวสุดท้ายของช่วงเป้าหมาย

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

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

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

ดูเพิ่มเติม


copyValuesToRange(sheet, column, columnEnd, row, rowEnd)

คัดลอกเนื้อหาของช่วงไปยังตําแหน่งที่กําหนด หากปลายทางมีขนาดใหญ่หรือเล็กกว่าช่วงต้นทาง ต้นทางจะซ้ํากันหรือถูกตัดออก

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
sheetSheetชีตเป้าหมาย
columnIntegerคอลัมน์แรกของช่วงเป้าหมาย
columnEndIntegerคอลัมน์สิ้นสุดของช่วงเป้าหมาย
rowIntegerแถวเริ่มต้นของช่วงเป้าหมาย
rowEndIntegerแถวสุดท้ายของช่วงเป้าหมาย

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

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

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

createDataSourcePivotTable(dataSource)

สร้างตาราง Pivot ของแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูล ซึ่งตรึงอยู่ที่เซลล์แรกในช่วงนี้

ตัวอย่างนี้แสดงวิธีสร้างและกําหนดค่าตาราง Pivot ของแหล่งข้อมูลใหม่

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM);
pivotTable.addFilter('dataColumnA',
                     SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataSourceDataSourceแหล่งข้อมูลที่ใช้สร้างตาราง Pivot

ไปกลับ

DataSourcePivotTable — ตาราง Pivot ของแหล่งข้อมูลที่เพิ่งสร้างใหม่

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

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

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

createDataSourceTable(dataSource)

สร้างตารางแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูล ซึ่งถูกตรึงที่เซลล์แรกในช่วงนี้

ตัวอย่างนี้แสดงวิธีสร้างและกําหนดค่าตารางแหล่งข้อมูลใหม่

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var dataSourceTable = anchorCell.createDataSourceTable(dataSource);
    .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
    .addSortSpec('dataColumnA', /* ascending= *\/ true)
    .addSortSpec('dataColumnB', /* ascending= *\/ false);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataSourceDataSourceแหล่งข้อมูลที่ใช้สร้างตาราง Pivot

ไปกลับ

DataSourceTable — ตารางแหล่งข้อมูลที่สร้างใหม่

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

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

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

createDeveloperMetadataFinder()

แสดงผล DeveloperMetadataFinderApi สําหรับการค้นหาข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ภายในขอบเขตของช่วงนี้ ข้อมูลเมตาจะอยู่ภายในขอบเขตของช่วงต่อเมื่ออยู่ในช่วงนั้นทั้งหมด เช่น ข้อมูลเมตาที่เชื่อมโยงกับแถว "3:3" ไม่ได้อยู่ในขอบเขตของช่วง "A1:D5" แต่อยู่ภายในขอบเขตของช่วง "1:5"

ไปกลับ

DeveloperMetadataFinder — เครื่องมือค้นหาข้อมูลเมตาของนักพัฒนาซอฟต์แวร์เพื่อค้นหาข้อมูลเมตาในขอบเขตของช่วงนี้


createFilter()

สร้างตัวกรองและนําไปใช้กับช่วงที่ระบุในชีต คุณไม่สามารถสร้างตัวกรองมากกว่า 1 รายการ ในชีตได้ ใช้ getFilter() หรือ Sheet.getFilter() เพื่อเข้าถึงและแก้ไขตัวกรองหลังจากที่สร้างตัวกรอง

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}
ใช้วิธีนี้เพื่อสร้างตัวกรองสําหรับ Grid ชีต ซึ่งเป็นประเภทชีตเริ่มต้น ชีตแบบแผ่นเป็นชีตที่ไม่ได้เชื่อมต่อกับฐานข้อมูล หากต้องการสร้างตัวกรองประเภทอื่นๆ โปรดดูสิ่งต่อไปนี้

ไปกลับ

Filter — ตัวกรองใหม่

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

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

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

createPivotTable(sourceData)

สร้างตาราง Pivot ที่ว่างเปล่าจาก sourceData ที่ระบุซึ่งตรึงอยู่กับเซลล์แรกในช่วงนี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
sourceDataRangeข้อมูลที่ใช้สร้างตาราง Pivot นี้

ไปกลับ

PivotTablePivotTable ที่สร้างขึ้นใหม่

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

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

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

createTextFinder(findText)

สร้างเครื่องมือค้นหาข้อความสําหรับช่วงดังกล่าวซึ่งจะค้นหาและแทนที่ข้อความในช่วงนี้ได้

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// Creates  a text finder for the range.
var textFinder = range.createTextFinder('dog');

// Returns the first occurrence of 'dog'.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = findOccurrence.replaceWith('cat');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
findTextStringข้อความที่จะค้นหา

ไปกลับ

TextFinderTextFinder ของช่วง


deleteCells(shiftDimension)

ลบช่วงเซลล์นี้ ข้อมูลที่มีอยู่ในชีตตามมิติข้อมูลที่ให้ไว้จะเปลี่ยนไปตามช่วงที่ถูกลบ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
shiftDimensionDimensionมิติข้อมูลที่ใช้ย้ายข้อมูลที่มีอยู่

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

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

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

expandGroups()

ขยายกลุ่มที่ยุบซึ่งมีช่วงหรือปุ่มสลับการควบคุมที่ตัดกับช่วงนี้ ตําแหน่งสลับการควบคุมคือดัชนีที่มีปุ่มสลับควบคุมปรากฏอยู่ ก่อนหรือหลังกลุ่มโดยตรง ทั้งนี้ขึ้นอยู่กับการตั้งค่า ถ้ามีกลุ่มมากกว่า 1 กลุ่มในสถานที่ตั้งเดียวกัน กลุ่มตื้นๆ จะขยายออก

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are expanded.
range.expandGroups();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

getA1Notation()

ส่งคืนคําอธิบายสตริงของช่วงในรูปแบบ A1

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

ไปกลับ

String — คําอธิบายสตริงของช่วงในรูปแบบ A1

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

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

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

getBackground()

แสดงสีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง (เช่น '#ffffff')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

ไปกลับ

String — รหัสสีของพื้นหลัง

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

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

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

getBackgroundObject()

แสดงสีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

ไปกลับ

Color — สีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง

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

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

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

getBackgroundObjects()

แสดงสีพื้นหลังของเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgroundObjects();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

ไปกลับ

Color[][] — อาร์เรย์ 2 มิติของสีพื้นหลัง

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

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

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

getBackgrounds()

แสดงสีพื้นหลังของเซลล์ในช่วง (เช่น '#ffffff')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgrounds();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์ 2 มิติของรหัสสีพื้นหลัง

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

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

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

getBandings()

แสดงแถบสีทั้งหมดที่ใช้กับเซลล์ในช่วงนี้

ไปกลับ

Banding[] — ทุกช่วงสีที่ใช้กับเซลล์ในช่วงนี้

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

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

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

getCell(row, column)

แสดงผลเซลล์ที่ต้องการในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rowIntegerแถวของเซลล์ที่เกี่ยวข้องกับช่วง
columnIntegerคอลัมน์ของเซลล์ที่สัมพันธ์กับช่วง

ไปกลับ

Range — ช่วงที่มีเซลล์เดียวที่พิกัดที่ระบุ

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

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

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

getColumn()

แสดงผลตําแหน่งคอลัมน์เริ่มต้นของช่วงนี้

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "2.0"
Logger.log(range.getColumn());

ไปกลับ

Integer — ช่วงเริ่มต้นของคอลัมน์ในสเปรดชีต

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

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

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

getDataRegion()

แสดงผลสําเนาของช่วงที่ขยายใน Direction 4 หลัก เพื่อครอบคลุมเซลล์ทั้งหมดที่ติดกันซึ่งมีข้อมูลอยู่ในนั้น หากช่วงดังกล่าวรายล้อมไปด้วยเซลล์ว่างที่ไม่รวมเซลล์เหล่านั้นในเส้นทแยงมุม ระบบจะแสดงผลช่วงดังกล่าวเอง ซึ่งคล้ายกับการเลือกช่วงและการพิมพ์ Ctrl+A ในเครื่องมือแก้ไข

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());

ไปกลับ

Range — ช่วงข้อมูลหรือช่วงของสเปรดชีตทั้งหมด

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

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

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

getDataRegion(dimension)

แสดงผลสําเนาของช่วงที่ขยาย Direction.UP และ Direction.DOWN หากมิติข้อมูลที่ระบุคือ Dimension.ROWS หรือ Direction.NEXT และ Direction.PREVIOUS หากมิติข้อมูลคือ Dimension.COLUMNS การขยายช่วงจะเป็นไปตามการตรวจหาข้อมูลถัดจากช่วงที่มีการจัดระเบียบเป็นตาราง ช่วงที่ขยายจะครอบคลุมเซลล์ทั้งหมดที่ติดกันซึ่งมีข้อมูลอยู่ในมิติข้อมูลที่ระบุ ซึ่งรวมถึงขอบเขตของตาราง หากช่วงต้นฉบับรายล้อมไปด้วยเซลล์ว่างตามมิติข้อมูลที่ระบุ ระบบจะแสดงผลช่วงดังกล่าวเอง วิธีนี้คล้ายกับการเลือกช่วงและพิมพ์ Ctrl+Space สําหรับคอลัมน์ หรือ Shift+Space สําหรับแถวในเครื่องมือแก้ไข

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "C2:C4"
Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation());
// Logs "B3:D3"
Logger.log(
    sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dimensionDimensionมิติข้อมูลที่จะขยายช่วง

ไปกลับ

Range — ช่วงข้อมูลหรือช่วงที่ครอบคลุมแต่ละคอลัมน์หรือแต่ละแถวโดยช่วงเดิม

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

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

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

getDataSourceFormula()

แสดงผล DataSourceFormula สําหรับเซลล์แรกในช่วง หรือ null หากเซลล์ไม่มีสูตรแหล่งข้อมูล

ไปกลับ

DataSourceFormulaDataSourceFormula สําหรับเซลล์

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

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

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

getDataSourceFormulas()

แสดง DataSourceFormula ของเซลล์ในช่วงนั้น

ไปกลับ

DataSourceFormula[] — อาร์เรย์ของ DataSourceFormula

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

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

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

getDataSourcePivotTables()

รับตาราง Pivot ของแหล่งข้อมูลทั้งหมดที่ซ้อนกันกับช่วง

ไปกลับ

DataSourcePivotTable[] — รายการตาราง Pivot ของแหล่งข้อมูล

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

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

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

getDataSourceTables()

รับตารางแหล่งข้อมูลทั้งหมดซ้อนทับกับช่วง

ไปกลับ

DataSourceTable[] — รายการตารางแหล่งข้อมูล

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

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

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

getDataSourceUrl()

แสดงผล URL สําหรับข้อมูลในช่วงนี้ซึ่งสามารถใช้สร้างแผนภูมิและคําค้นหาได้

Code.gs

function doGet() {
  var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c');
  var sheet = ss.getSheetByName('ContinentData');
  var range = sheet.getRange('A1:B8');

  var template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

piechat.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

ไปกลับ

String — URL ของช่วงนี้เป็นแหล่งข้อมูลที่ส่งต่อไปยัง API อื่นๆ ได้ เช่น แผนภูมิ

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

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

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

getDataTable()

แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น DataTable

ไปกลับ

DataTable — ข้อมูลเป็นตารางข้อมูล


getDataTable(firstRowIsHeader)

แสดงผลข้อมูลภายในช่วงนี้เป็นตารางข้อมูล

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B7");

// Calling this method with "true" sets the first line to be the title of the axes
var datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

พารามิเตอร์

ชื่อประเภทคำอธิบาย
firstRowIsHeaderBooleanถือว่าแถวแรกเป็นส่วนหัวหรือไม่

ไปกลับ

DataTable — ข้อมูลเป็นตารางข้อมูล

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

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

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

getDataValidation()

แสดงกฎการตรวจสอบข้อมูลสําหรับเซลล์ด้านบนซ้ายในช่วง หากยังไม่ได้ตั้งค่าการตรวจสอบข้อมูล ในเซลล์ เมธอดนี้จะแสดงผล null

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

ไปกลับ

DataValidation — กฎการตรวจสอบข้อมูลของเซลล์ซ้ายบนในช่วง

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

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

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

getDataValidations()

แสดงกฎการตรวจสอบข้อมูลสําหรับเซลล์ทั้งหมดในช่วง หากไม่ได้ตั้งค่าการตรวจสอบข้อมูลในเซลล์นี้ เมธอดนี้จะแสดง null สําหรับตําแหน่งเซลล์ในอาร์เรย์นั้น

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

ไปกลับ

DataValidation[][] — อาร์เรย์ 2 มิติของกฎการตรวจสอบข้อมูลที่เชื่อมโยงกับเซลล์ในช่วง

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

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

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

getDeveloperMetadata()

รับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับช่วงนี้

ไปกลับ

DeveloperMetadata[] — ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับช่วงนี้

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

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

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

getDisplayValue()

แสดงผลค่าที่แสดงของเซลล์ด้านบนซ้ายในช่วง ค่าคือ String ค่าที่แสดงจะพิจารณาการจัดรูปแบบการจัดรูปแบบวันที่ เวลา และสกุลเงิน รวมถึงรูปแบบที่ใช้โดยอัตโนมัติตามการตั้งค่าภาษาของสเปรดชีต เซลล์ว่างจะแสดงสตริงว่าง

ไปกลับ

String — ค่าที่แสดงในเซลล์นี้

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

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

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

getDisplayValues()

แสดงผลตารางกริดสี่เหลี่ยมผืนผ้าสําหรับช่วงนี้

แสดงผลอาร์เรย์สองมิติของค่าที่แสดง จัดทําดัชนีโดยแถว และตามด้วยคอลัมน์ ค่าเป็นออบเจ็กต์ String ค่าที่แสดงจะพิจารณาวันที่ เวลา และรูปแบบสกุลเงิน รวมถึงรูปแบบที่ใช้โดยอัตโนมัติตามการตั้งค่าภาษาของสเปรดชีต เซลล์ว่างจะแสดงด้วยสตริงว่างในอาร์เรย์ อย่าลืมว่าแม้ดัชนีช่วงเริ่มต้นที่ 1, 1 แต่อาร์เรย์ JavaScript จะได้รับการจัดทําดัชนีจาก [0][0]

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

ไปกลับ

String[][] — อาร์เรย์ค่า 2 มิติ

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

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

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

getFilter()

แสดงตัวกรองในชีตที่เป็นของช่วงนี้ หรือ null หากไม่มีตัวกรองในแผ่นงาน

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Gets the existing filter on the sheet that the given range belongs to.
let filter = range.getFilter();

ไปกลับ

Filter — ตัวกรอง

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

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

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

getFontColorObject()

แสดงสีแบบอักษรของเซลล์ที่มุมบนซ้ายของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

ไปกลับ

Color — สีแบบอักษรของเซลล์ด้านบนซ้ายในช่วง

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

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

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

getFontColorObjects()

แสดงสีแบบอักษรของเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColorObjects();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

ไปกลับ

Color[][] — อาร์เรย์ของสีแบบอักษรสองมิติที่เชื่อมโยงกับเซลล์ภายในช่วง

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

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

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

getFontFamilies()

แสดงชุดแบบอักษรของเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontFamilies();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์แบบอักษร 2 มิติที่เชื่อมโยงกับเซลล์ในช่วง

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

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

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

getFontFamily()

แสดงแบบอักษรของเซลล์ที่มุมบนซ้ายของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontFamily());

ไปกลับ

String — ชุดแบบอักษรของเซลล์

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

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

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

getFontLine()

รับรูปแบบของเส้นเซลล์ในมุมซ้ายบนของช่วง ('underline', 'line-through' หรือ 'none')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontLine());

ไปกลับ

String — บรรทัดแบบอักษร

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

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

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

getFontLines()

รับรูปแบบของเส้นในช่วงของเซลล์ ('underline', 'line-through' หรือ 'none')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontLines();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์แบบอักษร 2 มิติที่เชื่อมโยงกับเซลล์ในช่วง

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

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

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

getFontSize()

แสดงผลขนาดแบบอักษรในจุดของเซลล์ที่มุมบนซ้ายของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontSize());

ไปกลับ

Integer - ขนาดแบบอักษรในจุด

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

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

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

getFontSizes()

แสดงขนาดแบบอักษรของเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontSizes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

ไปกลับ

Integer[][] — ตัวอักษร 2 มิติขนาดตัวอักษรที่เชื่อมโยงกับเซลล์ในช่วงนั้น

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

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

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

getFontStyle()

แสดงรูปแบบแบบอักษร ('italic' หรือ 'normal') ของเซลล์ในมุมซ้ายบนของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontStyle());

ไปกลับ

String — รูปแบบแบบอักษรของข้อความในเซลล์

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

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

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

getFontStyles()

แสดงรูปแบบแบบอักษรของเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontStyles();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์ 2 มิติของรูปแบบข้อความที่เชื่อมโยงกับเซลล์ในช่วงนั้น

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

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

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

getFontWeight()

แสดงน้ําหนักแบบอักษร (ปกติ/ตัวหนา) ของเซลล์ที่มุมบนซ้ายของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontWeight());

ไปกลับ

String — น้ําหนักแบบอักษรของข้อความในเซลล์

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

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

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

getFontWeights()

แสดงน้ําหนักแบบอักษรของเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontWeights();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์ 2 มิติของน้ําหนักแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง

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

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

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

getFormula()

แสดงผลสูตร (รูปแบบ A1) สําหรับเซลล์ซ้ายบนของช่วง หรือสตริงว่าง ถ้าเซลล์ว่างเปล่าหรือไม่มีสูตร

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This assumes you have a function in B5 that sums up
// B2:B4
var range = sheet.getRange("B5");

// Logs the calculated value and the formula
Logger.log("Calculated value: %s Formula: %s",
           range.getValue(),
           range.getFormula());

ไปกลับ

String — สูตรสําหรับเซลล์

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

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

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

getFormulaR1C1()

แสดงผลสูตร (ค่า R1C1) สําหรับเซลล์ที่ระบุ หรือ null หากไม่มีค่า

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

ไปกลับ

String — สูตรในรูปแบบ R1C1

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

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

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

getFormulas()

แสดงผลสูตร (รูปแบบ A1) สําหรับเซลล์ในช่วง รายการในอาร์เรย์ 2D เป็นสตริงว่างสําหรับเซลล์ที่ไม่มีสูตร

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulas();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์ 2 มิติของสูตรในรูปแบบสตริง

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

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

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

getFormulasR1C1()

แสดงผลสูตร (ค่า R1C1) สําหรับเซลล์ในช่วง รายการในอาร์เรย์ 2 มิติ null สําหรับเซลล์ที่ไม่มีสูตร

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulasR1C1();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์ 2 มิติของสูตรในรูปแบบ R1C1

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

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

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

getGridId()

แสดงผลรหัสตารางกริดของชีตระดับบนสุดของช่วง ##39 รหัสคือค่า int แบบสุ่มที่ไม่เป็นลบแบบสุ่ม

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getGridId());

ไปกลับ

Integer — รหัสตารางกริดของชีตหลัก

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

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

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

getHeight()

แสดงผลความสูงของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// logs 3.0
Logger.log(range.getHeight());

ไปกลับ

Integer — ความสูงของช่วง

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

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

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

getHorizontalAlignment()

แสดงการจัดข้อความแนวนอน (ซ้าย/กลาง/ขวา) ของเซลล์ในมุมซ้ายบนของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getHorizontalAlignment());

ไปกลับ

String — การจัดข้อความแนวนอนในเซลล์

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

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

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

getHorizontalAlignments()

แสดงการจัดข้อความแนวนอนของเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getHorizontalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์ 2 มิติของการจัดเรียงข้อความในแนวนอนที่เชื่อมโยงกับเซลล์ในช่วง

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

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

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

getLastColumn()

แสดงผลตําแหน่งคอลัมน์สิ้นสุด

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastColumn());

ไปกลับ

Integer — ตําแหน่งคอลัมน์สิ้นสุดของสเปรดชีต

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

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

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

getLastRow()

แสดงผลตําแหน่งแถวสุดท้าย

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastRow());

ไปกลับ

Integer — ตําแหน่งแถวสิ้นสุดของสเปรดชีตในสเปรดชีต

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

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

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

getMergedRanges()

แสดงผลอาร์เรย์ของออบเจ็กต์ Range ที่แสดงเซลล์ที่ผสานที่อยู่ภายในช่วงปัจจุบันทั้งหมด หรือมีเซลล์อย่างน้อย 1 เซลล์ในช่วงปัจจุบัน

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

var mergedRanges = range.getMergedRanges();
for (var i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

ไปกลับ

Range[] — อาร์เรย์ของออบเจ็กต์ Range ซึ่งแสดงถึงเซลล์ที่ผสานซ้อนกันในช่วง


getNextDataCell(direction)

เริ่มต้นจากเซลล์ในคอลัมน์แรกและแถวของช่วง จะแสดงผลเซลล์ถัดไปในทิศทางที่กําหนดซึ่งเป็นขอบของช่วงเซลล์ที่ต่อเนื่องซึ่งมีข้อมูลในเซลล์หรือเซลล์ที่ขอบของสเปรดชีตในทิศทางนั้น ซึ่งเทียบเท่ากับการพิมพ์ Ctrl+[arrow key] ในเครื่องมือแก้ไข

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("C3:E5");
// Logs "C1"
Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
directionDirectionทิศทางที่จะค้นหาเซลล์ขอบถัดไปของเขตข้อมูล

ไปกลับ

Range — เซลล์เขตข้อมูลหรือเซลล์ที่ขอบของสเปรดชีต

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

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

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

getNote()

แสดงผลโน้ตที่เชื่อมโยงกับช่วงที่ระบุ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getNote());

ไปกลับ

String — โน้ตที่เกี่ยวข้องกับเซลล์ที่ระบุ

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

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

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

getNotes()

แสดงผลบันทึกที่เชื่อมโยงกับเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getNotes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์ 2 มิติของโน้ตที่เชื่อมโยงกับเซลล์ในช่วง

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

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

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

getNumColumns()

แสดงผลจํานวนคอลัมน์ในช่วงนี้

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumColumns());

ไปกลับ

Integer — จํานวนคอลัมน์ในช่วงนี้

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

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

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

getNumRows()

แสดงผลจํานวนแถวในช่วงนี้

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumRows());

ไปกลับ

Integer — จํานวนแถวในช่วงนี้

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

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

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

getNumberFormat()

ดูการจัดรูปแบบตัวเลขหรือวันที่ของเซลล์ด้านบนซ้ายของช่วงที่ระบุ ดูรูปแบบที่ส่งกลับได้ในเอกสารประกอบของ Sheets API

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

ไปกลับ

String — รูปแบบตัวเลขของเซลล์ด้านบนซ้ายของช่วง

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

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

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

getNumberFormats()

แสดงผลจํานวนตัวเลขหรือวันที่ของเซลล์ในช่วง ดูรูปแบบที่แสดงผลได้ในเอกสารประกอบของ Sheets API

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formats = range.getNumberFormats();
for (var i in formats) {
  for (var j in formats[i]) {
    Logger.log(formats[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์รูปแบบ 2 มิติ

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

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

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

getRichTextValue()

แสดงผลค่า Rich Text สําหรับเซลล์ซ้ายบนของช่วง หรือ null หากค่าในเซลล์ไม่ใช่ข้อความ

// Get the Rich Text value of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var richText = range.getRichTextValue();
Logger.log(richText);

ไปกลับ

RichTextValue — ค่า Rich Text ของเซลล์ซ้ายบนในช่วง หรือ null หากค่าของเซลล์ไม่ใช่ข้อความ

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

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

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

getRichTextValues()

แสดงผลค่า Rich Text สําหรับเซลล์ในช่วงนั้น

// Get the Rich Text values for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var values = range.getRichTextValues();

for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    Logger.log(values[i][j]);
  }
}

ไปกลับ

RichTextValue[][] — อาร์เรย์ 2 มิติของค่า Rich Text

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

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

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

getRow()

แสดงผลตําแหน่งแถวสําหรับช่วงนี้ เหมือนกับ getRowIndex()

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRow());

ไปกลับ

Integer — ตําแหน่งแถวของช่วง

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

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

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

getRowIndex()

แสดงผลตําแหน่งแถวสําหรับช่วงนี้ เหมือนกับ getRow()

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

ไปกลับ

Integer — ตําแหน่งแถวของช่วง

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

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

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

ดูเพิ่มเติม


getSheet()

แสดงผลแผ่นงานที่เป็นของช่วงนี้

ไปกลับ

Sheet — ชีตที่อยู่ภายใต้ช่วงนี้

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

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

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

getTextDirection()

แสดงทิศทางข้อความสําหรับเซลล์ซ้ายบนของช่วง แสดงผล null หากมีการระบุทิศทางของข้อความเซลล์ด้วยการตรวจจับอัตโนมัติ

// Get the text direction of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getTextDirection());

ไปกลับ

TextDirection — ทิศทางข้อความของเซลล์ซ้ายบนสุดในช่วง

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

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

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

getTextDirections()

แสดงทิศทางข้อความของเซลล์ในช่วง รายการในอาร์เรย์ 2 มิติคือ null สําหรับเซลล์ที่ใช้การตรวจจับอัตโนมัติ

// Get the text directions for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var directions = range.getTextDirections();

for (var i = 0; i < directions.length; i++) {
  for (var j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

ไปกลับ

TextDirection[][] — อาร์เรย์ของข้อความ 2 มิติของเส้นทางข้อความ

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

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

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

getTextRotation()

แสดงผลการตั้งค่าการหมุนข้อความสําหรับเซลล์ซ้ายบนของช่วง

// Log the text rotation settings for a cell.
var sheet = SpreadsheetApp.getActiveSheet();

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

ไปกลับ

TextRotation — การตั้งค่าการหมุนข้อความ

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

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

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

getTextRotations()

แสดงการตั้งค่าการหมุนข้อความสําหรับเซลล์ในช่วงนั้น

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

var results = range.getTextRotations();

for (var i in results) {
  for (var j in results[i]) {
    var rotation = results[i][j];
    Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation);
  }
}

ไปกลับ

TextRotation[][] — อาร์เรย์ 2 มิติของการหมุนข้อความที่เชื่อมโยงกับเซลล์ในช่วง

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

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

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

getTextStyle()

แสดงผลรูปแบบข้อความสําหรับเซลล์ซ้ายบนของช่วง

// Get the text style of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var style = range.getTextStyle();
Logger.log(style);

ไปกลับ

TextStyle — รูปแบบข้อความของเซลล์ซ้ายบนสุดในช่วง

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

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

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

getTextStyles()

แสดงผลรูปแบบข้อความสําหรับเซลล์ในช่วง

// Get the text styles for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var styles = range.getTextStyles();

for (var i = 0; i < styles.length; i++) {
  for (var j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

ไปกลับ

TextStyle[][] — รูปแบบข้อความ 2 มิติ

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

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

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

getValue()

แสดงผลค่าของเซลล์ด้านบนซ้ายในช่วง ค่าอาจเป็นประเภท Number, Boolean, Date หรือ String ขึ้นอยู่กับค่าของเซลล์ เซลล์ว่างจะแสดงผลสตริงที่ว่างเปล่า

ไปกลับ

Object — ค่าในเซลล์นี้

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

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

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

getValues()

แสดงผลตารางกริดสี่เหลี่ยมผืนผ้าสําหรับช่วงนี้

แสดงผลอาร์เรย์ค่า 2 มิติ โดยจัดทําดัชนีตามแถว ตามด้วยคอลัมน์ ค่าอาจเป็นประเภท Number, Boolean, Date หรือ String ขึ้นอยู่กับค่าของเซลล์ เซลล์ว่างจะแสดงด้วยสตริงว่างในอาร์เรย์ อย่าลืมว่าแม้ดัชนีช่วงเริ่มต้นที่ 1, 1 แต่อาร์เรย์ JavaScript จะได้รับการจัดทําดัชนีจาก [0][0]

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);
ในเว็บแอป ค่า Date จะไม่ใช่พารามิเตอร์ทางกฎหมาย getValues() จะไม่สามารถส่งคืนข้อมูลไปยังเว็บแอป หากช่วงดังกล่าวมีเซลล์ที่มีค่า Date ให้เปลี่ยนค่าทั้งหมดที่ได้จากชีตเป็น JavaScript ที่รองรับ เช่น Number, Boolean หรือ String แทน

ไปกลับ

Object[][] — อาร์เรย์ค่า 2 มิติ

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

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

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

getVerticalAlignment()

แสดงการจัดข้อความแนวตั้ง (ด้านบน/ตรงกลาง/ด้านล่าง) ของเซลล์ที่มุมซ้ายบนของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getVerticalAlignment());

ไปกลับ

String — การจัดข้อความแนวตั้งในเซลล์

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

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

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

getVerticalAlignments()

แสดงการวางแนวในแนวตั้งของเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

ไปกลับ

String[][] — อาร์เรย์ 2 มิติของการจัดข้อความแนวตั้งที่เชื่อมโยงกับเซลล์ในช่วง

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

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

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

getWidth()

แสดงผลความกว้างของช่วงเป็นคอลัมน์

ไปกลับ

Integer — จํานวนคอลัมน์ในช่วง

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

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

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

getWrap()

แสดงผลว่าข้อความในเซลล์รวมหรือไม่ หากต้องการกลยุทธ์การรวมที่ละเอียดยิ่งขึ้น ให้ใช้ getWrapStrategy()

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getWrap());

ไปกลับ

Boolean — ข้อความในเซลล์นี้รวมหรือไม่

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

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

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

getWrapStrategies()

แสดงผลกลยุทธ์การตัดข้อความสําหรับเซลล์ในช่วง

// Get the text wrapping strategies for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var strategies = range.getWrapStrategies();

for (var i = 0; i < strategies.length; i++) {
  for (var j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

ไปกลับ

WrapStrategy[][] — อาร์เรย์ 2 มิติของกลยุทธ์การตัดข้อความ

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

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

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

getWrapStrategy()

แสดงผลกลยุทธ์การตัดข้อความสําหรับเซลล์ด้านซ้ายบนของช่วง

// Get the text wrapping strategy of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getWrapStrategy());

ไปกลับ

WrapStrategy — กลยุทธ์การตัดข้อความในเซลล์ซ้ายบนในช่วง

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

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

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

getWraps()

แสดงผลว่าข้อความในเซลล์รวมหรือไม่ หากต้องการกลยุทธ์การรวมที่ละเอียดยิ่งขึ้น ให้ใช้ getWrapStrategies()

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    var isWrapped = results[i][j];
    if (isWrapped) {
       Logger.log("Cell [%s, %s] has wrapped text", i, j);
    }
  }
}

ไปกลับ

Boolean[][] — อาร์เรย์ 2 มิติของการจัดข้อความแนวตั้งที่เชื่อมโยงกับเซลล์ในช่วง

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

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

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

insertCells(shiftDimension)

แทรกเซลล์ว่างลงในช่วงนี้ เซลล์ใหม่จะเก็บการจัดรูปแบบที่มีอยู่ในเซลล์ที่มีช่วงนี้ไว้ก่อนหน้านี้ ข้อมูลที่มีอยู่ในชีตตามมิติข้อมูลที่ให้ไว้จะหลุดออกจากช่วงที่แทรกไว้

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
shiftDimensionDimensionมิติข้อมูลที่ใช้ย้ายข้อมูลที่มีอยู่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

insertCheckboxes()

แทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง กําหนดค่าด้วย true เพื่อทําเครื่องหมาย และ false เพื่อยกเลิกการเลือก ตั้งค่าของเซลล์ทั้งหมดในช่วงเป็น false

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'.
range.insertCheckboxes();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

insertCheckboxes(checkedValue)

แทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง กําหนดค่าด้วยค่าที่กําหนดเองสําหรับทําเครื่องหมาย และสตริงว่างสําหรับยกเลิกการเลือก ตั้งค่าของแต่ละเซลล์ในช่วงเป็นสตริงว่าง

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
checkedValueObjectค่าที่เลือกสําหรับการตรวจสอบข้อมูลช่องทําเครื่องหมาย

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

insertCheckboxes(checkedValue, uncheckedValue)

แทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง กําหนดค่าด้วยค่าที่กําหนดเองสําหรับสถานะที่เลือกและไม่เลือก ตั้งค่าของแต่ละเซลล์ในช่วงเป็นค่าที่ไม่ได้เลือกไว้

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
checkedValueObjectค่าที่เลือกสําหรับการตรวจสอบข้อมูลช่องทําเครื่องหมาย
uncheckedValueObjectค่าที่ไม่ได้เลือกไว้สําหรับการตรวจสอบข้อมูลช่องทําเครื่องหมาย

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

isBlank()

แสดงผล true หากช่วงว่างเปล่าทั้งหมด

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.isBlank());

ไปกลับ

Booleantrue หากไม่มีข้อมูลค่าในช่วงนี้ false

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

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

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

isChecked()

แสดงผลว่าเซลล์ทั้งหมดในช่วงดังกล่าวมีสถานะช่องทําเครื่องหมายเป็น 'ตรวจสอบแล้ว' หรือไม่ แสดงผล null หากตรวจเลือกเซลล์บางเซลล์และยกเลิกการเลือกเซลล์อื่นๆ หรือหากบางเซลล์ไม่มีการตรวจสอบข้อมูลช่องทําเครื่องหมาย

var range = SpreadsheetApp.getActive().getRange('A1:A3');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:A3.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
var isRange1Checked = range1.isChecked();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked value.
var isRange2Checked = range2.isChecked();

var range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox value.
var isRange3Checked = range3.isChecked();

ไปกลับ

Booleantrue หากไม่มีการเลือกเซลล์ทั้งหมดในช่วงนี้ false ถ้ามีการเลือกเซลล์ทั้งหมดในช่วงนั้นไว้ หรือ null ถ้าเซลล์ใดเซลล์หนึ่งไม่มีการเลือกหรือไม่มีการตรวจสอบข้อมูลในช่องทําเครื่องหมาย

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

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

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

isEndColumnBounded()

ระบุว่าจุดสิ้นสุดของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ เช่น สําหรับช่วง A1:B10 หรือ B:B ที่ผูกกับคอลัมน์ที่ช่วงท้าย เมธอดนี้จะแสดง true สําหรับช่วง 3:7 หรือ A1:5 ที่เชื่อมโยงกับเฉพาะแถวใดแถวหนึ่งเมื่อสิ้นสุดวิธีการนี้จะแสดงผล false

ไปกลับ

Booleantrue ถ้าจุดสิ้นสุดของช่วงถูกเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่ง; false หากไม่ใช่

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

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

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

isEndRowBounded()

ระบุว่าจุดสิ้นสุดของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ เช่น สําหรับช่วง A1:B10 หรือ 3:7 ที่ผูกกับแถวที่จุดสิ้นสุดของช่วง เมธอดนี้จะแสดง true สําหรับช่วง B:B หรือ A1:C ที่ผูกกับคอลัมน์ใดคอลัมน์หนึ่งที่จุดสิ้นสุดของช่วงเท่านั้น วิธีนี้จะแสดงผล false

ไปกลับ

Booleantrue หากจุดสิ้นสุดของช่วงเชื่อมโยงกับแถวใดแถวหนึ่ง false ไม่เช่นนั้นจะเป็นเช่นนั้น

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

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

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

isPartOfMerge()

แสดงผล true หากเซลล์ในช่วงปัจจุบันทับซ้อนเซลล์ที่ผสาน

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

// True if any of the cells in A1:B3 is included in a merge.
var isPartOfMerge = range.isPartOfMerge();

ไปกลับ

Boolean - true หากช่วงทับซ้อนกับเซลล์ที่ผสานกัน มิฉะนั้นจะแสดงผล false


isStartColumnBounded()

ระบุว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ เช่น สําหรับช่วง A1:B10 หรือ B:B ที่ผูกกับคอลัมน์ที่จุดเริ่มต้นของช่วง เมธอดนี้จะแสดง true สําหรับช่วง 3:7 ซึ่งผูกกับแถวที่จุดเริ่มต้นของช่วงเท่านั้น วิธีนี้จะแสดงผล false

ไปกลับ

Booleantrue หากจุดเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่ง false มิฉะนั้นให้เป็นอย่างอื่น

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

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

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

isStartRowBounded()

ระบุว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ ตัวอย่างเช่น สําหรับช่วง A1:B10 หรือ 3:7 ที่ผูกกับแถวที่จุดเริ่มต้นของช่วง เมธอดนี้จะแสดง true สําหรับช่วง B:B ซึ่งผูกกับคอลัมน์ใดคอลัมน์หนึ่งที่จุดเริ่มต้นของช่วง เมธอดนี้จะแสดง false

ไปกลับ

Booleantrue หากจุดเริ่มต้นของช่วงเชื่อมโยงกับแถวใดแถวหนึ่ง false มิฉะนั้นให้เป็นเช่นนั้น

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

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

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

merge()

ผสานเซลล์ในช่วงเข้าด้วยกันเป็นบล็อกเดียว

var sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

mergeAcross()

ผสานเซลล์ในช่วงที่อยู่ในคอลัมน์ต่างๆ ของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

mergeVertically()

ผสานเซลล์ในช่วงเข้าด้วยกัน

var sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

moveTo(target)

ตัดและวาง (ทั้งรูปแบบและค่า) จากช่วงนี้ไปยังช่วงเป้าหมาย

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

พารามิเตอร์

ชื่อประเภทคำอธิบาย
targetRangeช่วงเป้าหมายที่จะคัดลอกช่วงนี้ไป มีเฉพาะตําแหน่งเซลล์ซ้ายบนเท่านั้นที่เกี่ยวข้อง

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

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

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

offset(rowOffset, columnOffset)

แสดงผลช่วงใหม่ที่จะชดเชยจากช่วงนี้ตามจํานวนแถวและคอลัมน์ที่ระบุ (ซึ่งอาจเป็นค่าลบได้) ช่วงใหม่มีขนาดเดียวกับช่วงเดิม

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rowOffsetIntegerจํานวนแถวจากเซลล์ด้านบนซ้ายของช่วง ' ค่าลบ แสดงถึงแถวจากเซลล์ด้านบนซ้ายของช่วง
columnOffsetIntegerจํานวนคอลัมน์จากเซลล์ซ้ายบนของช่วง ' ค่าลบ แสดงคอลัมน์จากเซลล์ซ้ายบนของช่วง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ


offset(rowOffset, columnOffset, numRows)

แสดงผลช่วงใหม่ซึ่งสัมพันธ์กับช่วงปัจจุบัน ตําแหน่งซ้ายบนจะถูกออฟเซ็ตจากช่วงปัจจุบันโดยแถวและคอลัมน์ที่ระบุ และมีความสูงที่ระบุในเซลล์

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:B3
var newRange = cell.offset(1, 1, 2);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rowOffsetIntegerจํานวนแถวจากเซลล์ด้านบนซ้ายของช่วง ' ค่าลบ แสดงถึงแถวจากเซลล์ด้านบนซ้ายของช่วง
columnOffsetIntegerจํานวนคอลัมน์จากเซลล์ซ้ายบนของช่วง ' ค่าลบ แสดงคอลัมน์จากเซลล์ซ้ายบนของช่วง
numRowsIntegerความสูงในแถวของช่วงใหม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ


offset(rowOffset, columnOffset, numRows, numColumns)

แสดงผลช่วงใหม่ซึ่งสัมพันธ์กับช่วงปัจจุบัน ตําแหน่งซ้ายบนจะถูกออฟเซ็ตจากช่วงปัจจุบันตามแถวและคอลัมน์ที่ระบุ รวมถึงความสูงและความกว้างที่กําหนดในเซลล์

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:C3
var newRange = cell.offset(1, 1, 2, 2);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rowOffsetIntegerจํานวนแถวจากเซลล์ด้านบนซ้ายของช่วง ' ค่าลบ แสดงถึงแถวจากเซลล์ด้านบนซ้ายของช่วง
columnOffsetIntegerจํานวนคอลัมน์จากเซลล์ซ้ายบนของช่วง ' ค่าลบ แสดงคอลัมน์จากเซลล์ซ้ายบนของช่วง
numRowsIntegerความสูงในแถวของช่วงใหม่
numColumnsIntegerความกว้างในคอลัมน์ของช่วงใหม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ


protect()

สร้างออบเจ็กต์ที่สามารถป้องกันการแก้ไขช่วง ยกเว้นผู้ใช้ที่มีสิทธิ์ จนกว่าสคริปต์จะเปลี่ยนรายการเครื่องมือแก้ไขของช่วง (โดยการเรียกใช้ Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) หรือการตั้งค่าใหม่สําหรับ Protection.setDomainEdit(editable)) สิทธิ์จะสะท้อนรายการสเปรดชีตนั้นเอง ซึ่งหมายความว่าช่วงจะไม่ได้รับการปกป้อง หากช่วงที่ได้รับการป้องกันอยู่แล้ว เมธอดนี้จะสร้างช่วงที่มีการป้องกันใหม่ซึ่งจะทับซ้อนกับช่วงที่มีอยู่ ถ้าเซลล์ได้รับการป้องกันโดยช่วงที่ได้รับการป้องกันหลายช่วง และมีช่วงหนึ่งที่ป้องกันผู้ใช้บางรายแก้ไขเซลล์ ผู้ใช้รายนั้นจะไม่ได้รับอนุญาตให้แก้ไขเซลล์

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

ไปกลับ

Protection — ออบเจ็กต์ที่แสดงการตั้งค่าการป้องกัน

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

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

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

randomize()

สุ่มลําดับของแถวในช่วงที่กําหนด

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Randomizes the range
range.randomize();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

removeCheckboxes()

นําช่องทําเครื่องหมายทั้งหมดออกจากช่วง ล้างการตรวจสอบข้อมูลของแต่ละเซลล์และล้างค่าด้วย หากเซลล์มีค่าที่เลือกหรือไม่เลือก

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

removeDuplicates()

นําแถวภายในช่วงนี้ที่มีค่าซึ่งซ้ํากับค่าในแถวก่อนหน้าออก แถวที่มีค่าเหมือนกันแต่มีตัวอักษรพิมพ์เล็กพิมพ์ใหญ่ การจัดรูปแบบ หรือสูตรต่างกันจะถือว่าเป็นรายการที่ซ้ํากัน วิธีนี้จะลบแถวที่ซ้ํากันซึ่งถูกซ่อนจากมุมมองด้วย (เช่น เพราะตัวกรอง) ระบบจะไม่นําเนื้อหาออกนอกช่วงนี้

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove duplicate rows in the range.
range.removeDuplicates();

ไปกลับ

Range — ช่วงที่ได้หลังจากนํารายการซ้ําออกแล้ว ระบบจะลดขนาดของช่วงลง 1 แถวสําหรับทุกแถวที่นําออก

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

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

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

removeDuplicates(columnsToCompare)

นําแถวภายในช่วงนี้ที่มีค่าในคอลัมน์ที่ระบุ ซึ่งซ้ํากับค่าในแถวก่อนหน้า แถวที่มีค่าเหมือนกันแต่มีตัวอักษรพิมพ์เล็กพิมพ์ใหญ่ การจัดรูปแบบ หรือสูตรต่างกันจะถือว่าเป็นรายการที่ซ้ํากัน วิธีนี้จะลบแถวที่ซ้ํากันซึ่งถูกซ่อนจากมุมมองด้วย (เช่น เพราะตัวกรอง) ระบบจะไม่นําเนื้อหาออกนอกช่วงนี้

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2,4]);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnsToCompareInteger[]คอลัมน์ที่จะวิเคราะห์เพื่อหาค่าที่ซ้ํากัน หากไม่ระบุคอลัมน์ ระบบจะวิเคราะห์คอลัมน์ทั้งหมดเพื่อหารายการที่ซ้ํากัน

ไปกลับ

Range — ช่วงที่ได้หลังจากนํารายการซ้ําออกแล้ว ระบบจะลดขนาดของช่วงลง 1 แถวสําหรับทุกแถวที่นําออก

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

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

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

setBackground(color)

ตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วงในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
range.setBackground("red");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringรหัสสีในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') ส่วนค่า null จะรีเซ็ตสี

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setBackgroundObject(color)

ตั้งค่าสีพื้นหลังของทุกเซลล์ในช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorสีพื้นหลังที่จะตั้งค่า ค่า null จะรีเซ็ตสีพื้นหลัง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setBackgroundObjects(color)

ตั้งค่าตารางกริดของสี่เหลี่ยมผืนผ้าสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColor[][]อาร์เรย์สี 2 มิติ ค่า null จะรีเซ็ตสี

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setBackgroundRGB(red, green, blue)

ตั้งค่าพื้นหลังเป็นสีที่ระบุโดยใช้ค่า RGB (จํานวนเต็มระหว่าง 0 ถึง 255)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
redIntegerค่าสีแดงในรูปแบบ RGB
greenIntegerค่าสีเขียวในรูปแบบ RGB
blueIntegerค่าสีน้ําเงินในรูปแบบ RGB

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setBackgrounds(color)

ตั้งค่าตารางกริดของสี่เหลี่ยมผืนผ้าสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) สีจะอยู่ในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorString[][]อาร์เรย์ของสีสองมิติในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') ค่า null จะรีเซ็ตสี

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setBorder(top, left, bottom, right, vertical, horizontal)

ตั้งค่าคุณสมบัติเส้นขอบ ค่าที่ใช้ได้คือ true (เปิด), false (ปิด) และ null (ไม่มีการเปลี่ยนแปลง)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
topBooleantrue สําหรับเส้นขอบ false ไม่มีค่า null แบบไม่มีการเปลี่ยนแปลง
leftBooleantrue สําหรับเส้นขอบ false ไม่มีค่า null แบบไม่มีการเปลี่ยนแปลง
bottomBooleantrue สําหรับเส้นขอบ false ไม่มีค่า null แบบไม่มีการเปลี่ยนแปลง
rightBooleantrue สําหรับเส้นขอบ false ไม่มีค่า null แบบไม่มีการเปลี่ยนแปลง
verticalBooleantrue สําหรับเส้นขอบแนวตั้งภายใน false สําหรับไม่มี null สําหรับไม่มีการเปลี่ยนแปลง
horizontalBooleantrue สําหรับเส้นขอบแนวนอนภายใน false หากไม่มี null จะไม่มีการเปลี่ยนแปลง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

ตั้งค่าคุณสมบัติเส้นขอบด้วยสีและ/หรือสไตล์ ค่าที่ใช้ได้คือ true (เปิด), false (ปิด) และ null (ไม่มีการเปลี่ยนแปลง) สําหรับสี ให้ใช้ "สี" ในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
topBooleantrue สําหรับเส้นขอบ false ไม่มีค่า null แบบไม่มีการเปลี่ยนแปลง
leftBooleantrue สําหรับเส้นขอบ false ไม่มีค่า null แบบไม่มีการเปลี่ยนแปลง
bottomBooleantrue สําหรับเส้นขอบ false ไม่มีค่า null แบบไม่มีการเปลี่ยนแปลง
rightBooleantrue สําหรับเส้นขอบ false ไม่มีค่า null แบบไม่มีการเปลี่ยนแปลง
verticalBooleantrue สําหรับเส้นขอบแนวตั้งภายใน false สําหรับไม่มี null สําหรับไม่มีการเปลี่ยนแปลง
horizontalBooleantrue สําหรับเส้นขอบแนวนอนภายใน false หากไม่มี null จะไม่มีการเปลี่ยนแปลง
colorStringสีในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') null สําหรับสีเริ่มต้น (สีดํา)
styleBorderStyleลักษณะเส้นขอบ null สําหรับรูปแบบเริ่มต้น (สีทึบ)

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setDataValidation(rule)

ตั้งกฎการตรวจสอบข้อมูล 1 กฎกับทุกเซลล์ในช่วงนั้น

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
ruleDataValidationกฎการตรวจสอบข้อมูลที่ตั้งไว้ หรือ null เพื่อนําการตรวจสอบข้อมูลออก

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setDataValidations(rules)

ตั้งค่ากฎการตรวจสอบข้อมูลสําหรับเซลล์ทั้งหมดในช่วง เมธอดนี้ใช้การตรวจสอบข้อมูลแบบ 2 มิติ จัดทําดัชนีโดยแถว และตามด้วยคอลัมน์ มิติข้อมูลอาร์เรย์ต้องสอดคล้องกับ มิติข้อมูลของช่วง

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rulesDataValidation[][]อาร์เรย์ 2 มิติของกฎการตรวจสอบข้อมูลที่ต้องกําหนด ค่า null จะนําการตรวจสอบข้อมูลออก

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontColor(color)

ตั้งค่าสีแบบอักษรในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontColor("red");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีแบบอักษรในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') ค่า null จะรีเซ็ตสี

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontColorObject(color)

ตั้งค่าสีแบบอักษรของช่วงที่ระบุ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorสีแบบอักษรที่ต้องการตั้งค่า ค่า null จะรีเซ็ตสี

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontColorObjects(colors)

ตั้งค่าตารางกริดของสีแบบอักษรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorsColor[][]อาร์เรย์ของสีสองมิติ ค่า null จะรีเซ็ตสีแบบอักษร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontColors(colors)

ตั้งค่าตารางกริดของสีแบบอักษรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) สีจะอยู่ในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorsObject[][]อาร์เรย์ของสีสองมิติในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') ค่า null จะรีเซ็ตสี

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontFamilies(fontFamilies)

ตั้งค่าตารางกริดรูปสี่เหลี่ยมผืนผ้าของชุดแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) ตัวอย่างชุดแบบอักษรคือ "eCPM" หรือ "Hไม้"

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontFamiliesObject[][]อาร์เรย์แบบอักษร 2 มิติ ค่า null จะรีเซ็ตชุดแบบอักษร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontFamily(fontFamily)

ตั้งค่าชุดแบบอักษร เช่น "eCPM" หรือ "Hไม้"

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontFamilyStringชุดแบบอักษรที่จะตั้งค่า ค่า null จะรีเซ็ตชุดแบบอักษร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontLine(fontLine)

กําหนดรูปแบบเส้นแบบอักษรของช่วงที่ระบุ ('underline', 'line-through' หรือ 'none')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontLineStringรูปแบบของแบบอักษรคือ 'underline', 'line-through' หรือ 'none' ค่า null จะรีเซ็ตรูปแบบแบบอักษร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontLines(fontLines)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับรูปแบบเส้น (ต้องตรงกับขนาดของช่วงนี้)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontLinesObject[][]อาร์เรย์สองมิติของรูปแบบเส้นแบบอักษร ('underline', 'line-through' หรือ 'none') ค่า null รีเซ็ตรูปแบบบรรทัดแบบอักษร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontSize(size)

กําหนดขนาดแบบอักษร โดยขนาดจะเป็นขนาดจุดที่จะใช้

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontSize(20);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
sizeIntegerขนาดแบบอักษรในจุด

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontSizes(sizes)

ตั้งค่าตารางกริดของรูปสี่เหลี่ยมผืนผ้าขนาดตัวอักษร (ต้องตรงกับขนาดของช่วงนี้) ขนาดเป็นจุด

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
sizesObject[][]อาร์เรย์ขนาด 2 มิติ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontStyle(fontStyle)

ตั้งค่ารูปแบบตัวอักษรสําหรับช่วงที่ระบุ ('italic' หรือ 'normal')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontStyleStringรูปแบบอักษรคือ 'italic' หรือ 'normal' ค่า null จะรีเซ็ตรูปแบบตัวอักษร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontStyles(fontStyles)

ตั้งค่าตารางกริดของรูปแบบตัวอักษรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontStylesObject[][]อาร์เรย์ตัวอักษร 2 มิติในรูปแบบ 'italic' หรือ 'normal' ค่า null จะรีเซ็ตรูปแบบตัวอักษร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontWeight(fontWeight)

ตั้งค่าน้ําหนักของแบบอักษรให้อยู่ในช่วงที่กําหนด (ปกติ/ตัวหนา)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontWeightStringน้ําหนักแบบอักษร 'bold' หรือ 'normal' ค่า null จะรีเซ็ตน้ําหนักของแบบอักษร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFontWeights(fontWeights)

ตั้งค่าตารางกริดของแบบอักษรแบบสี่เหลี่ยมผืนผ้า (ต้องตรงกับมิติข้อมูลของช่วงนี้) ตัวอย่างน้ําหนักของแบบอักษรคือ "bold"

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontWeightsObject[][]อาร์เรย์ของขนาดตัวอักษรสองมิติ ไม่ว่าจะเป็น 'bold' หรือ 'normal' ส่วนค่า null จะรีเซ็ตน้ําหนักของแบบอักษร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFormula(formula)

อัปเดตสูตรของช่วงนี้ สูตรที่ระบุต้องมีสัญลักษณ์ A1

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formulaStringสตริงแทนสูตรที่จะตั้งค่าสําหรับเซลล์

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFormulaR1C1(formula)

อัปเดตสูตรของช่วงนี้ สูตรที่ระบุต้องอยู่ในรูปแบบ R1C1

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formulaStringสูตรสตริง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFormulas(formulas)

ตั้งค่าตารางกริดของสูตรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) สูตรที่ระบุต้องอยู่ในเครื่องหมาย A1 เมธอดนี้ใช้สูตรสูตรแบบ 2 มิติ จัดทําดัชนีโดยแถว และตามด้วยคอลัมน์ มิติข้อมูลอาร์เรย์ต้องสอดคล้องกับมิติข้อมูลของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formulasString[][]อาร์เรย์สตริง 2 มิติของสูตร

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setFormulasR1C1(formulas)

ตั้งค่าตารางกริดของสูตรสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) สูตรที่ระบุต้องอยู่ในรูปแบบ R1C1

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formulasString[][]อาร์เรย์ของมิติข้อมูล 2 มิติในรูปแบบ R1C1

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setHorizontalAlignment(alignment)

ตั้งค่าการจัดข้อความแนวนอน (ซ้ายไปขวา) ของช่วงที่ระบุ (ซ้าย/กลาง/ขวา)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
alignmentStringการจัดข้อความ ไม่ว่าจะเป็น 'left', 'center' หรือ 'normal' ค่า null จะรีเซ็ตการตรวจสอบความสอดคล้อง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setHorizontalAlignments(alignments)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าของการจัดชิดแนวนอน ดู setHorizontalAlignment(alignment)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
alignmentsObject[][]อาร์เรย์ของมิติข้อมูล 2 มิติ ไม่ว่าจะเป็น 'left', 'center' หรือ 'normal' ค่า null จะรีเซ็ตการตรวจสอบความสอดคล้อง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

ดูเพิ่มเติม


setNote(note)

ตั้งค่าโน้ตให้เป็นค่าที่ระบุ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
noteStringค่าโน้ตที่จะตั้งสําหรับช่วง ค่า null จะนําโน้ตออก

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setNotes(notes)

ตั้งค่าตารางกริดของสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
notesObject[][]อาร์เรย์ของโน้ต 2 มิติ ค่า null จะนําโน้ตออก

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

ดูเพิ่มเติม


setNumberFormat(numberFormat)

ตั้งค่ารูปแบบตัวเลขหรือวันที่เป็นสตริงการจัดรูปแบบที่ระบุ รูปแบบที่เรายอมรับมีอธิบายไว้ในเอกสารประกอบของ Sheets API

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberFormatStringสตริงรูปแบบตัวเลข

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setNumberFormats(numberFormats)

ตั้งค่าตารางกริดของรูปแบบตัวเลขหรือวันที่ (ต้องตรงกับมิติข้อมูลของช่วงนี้) ค่าคือสตริงรูปแบบตามที่อธิบายไว้ในเอกสารประกอบของ Sheets API

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberFormatsObject[][]อาร์เรย์รูปแบบ 2 มิติ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setRichTextValue(value)

ตั้งค่า Rich Text สําหรับเซลล์ในช่วงนั้น

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueRichTextValueค่า Rich Text ที่ต้องการ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setRichTextValues(values)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าด้วยค่า Rich Text

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuesRichTextValue[][]ค่า Rich Text ที่ต้องการ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

ตั้งค่าว่าช่วงดังกล่าวควรจะแสดงไฮเปอร์ลิงก์หรือไม่

พารามิเตอร์

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

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setTextDirection(direction)

ตั้งค่าทิศทางข้อความของเซลล์ในช่วง หากทิศทางที่ระบุคือ null ระบบจะอนุมานเส้นทางแล้วตั้งค่า

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
directionTextDirectionทิศทางข้อความที่ต้องการ หาก null อนุมานเส้นทางก่อนการตั้งค่า

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setTextDirections(directions)

ตั้งค่าตารางกริดรูปสี่เหลี่ยมผืนผ้าของเส้นทางข้อความ หากทิศทางที่ระบุคือ null ระบบจะอนุมานเส้นทางและกําหนด

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
directionsTextDirection[][]เส้นทางข้อความที่ต้องการ หากเส้นทางที่ระบุคือ null จะมีการอนุมานเส้นทางก่อนการตั้งค่า

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setTextRotation(degrees)

ตั้งค่าการหมุนเวียนข้อความสําหรับเซลล์ในช่วงนั้น อินพุตจะสอดคล้องกับมุมระหว่างการวางแนวข้อความมาตรฐานกับการวางแนวที่ต้องการ อินพุต 0 บ่งบอกว่า ข้อความได้รับการตั้งค่าเป็นการวางแนวมาตรฐาน

สําหรับข้อความในด้านซ้ายและขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา ส่วนมุมขวาไปซ้ายจะอยู่ในทิศทางตามเข็มนาฬิกา

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
degreesIntegerมุมที่ต้องการระหว่างการวางแนวมาตรฐานและการวางแนวที่ต้องการ สําหรับข้อความซ้ายไปขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setTextRotation(rotation)

ตั้งค่าการหมุนเวียนข้อความสําหรับเซลล์ในช่วงนั้น

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rotationTextRotationการตั้งค่าการหมุนข้อความที่ต้องการ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setTextRotations(rotations)

ตั้งค่าตารางกริดแบบหมุนของข้อความแบบสี่เหลี่ยมผืนผ้า

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rotationsTextRotation[][]การตั้งค่าการหมุนข้อความที่ต้องการ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setTextStyle(style)

ตั้งค่ารูปแบบข้อความสําหรับเซลล์ในช่วง

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
styleTextStyleรูปแบบข้อความที่ต้องการ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setTextStyles(styles)

ตั้งค่าตารางกริดของรูปแบบข้อความสี่เหลี่ยมผืนผ้า

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
stylesTextStyle[][]รูปแบบข้อความที่ต้องการ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setValue(value)

ตั้งค่าของช่วง ค่าอาจเป็นตัวเลข สตริง บูลีน หรือวันที่ หากขึ้นต้นด้วย '=' ระบบจะตีความว่าเป็นสูตร

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setValue(100);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueObjectค่าของช่วง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setValues(values)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าของค่า (ต้องตรงกับมิติข้อมูลของช่วงนี้)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuesObject[][]อาร์เรย์ค่าสองมิติ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setVerticalAlignment(alignment)

ตั้งค่าการวางแนวในแนวตั้ง (บนลงล่าง) สําหรับช่วงที่ระบุ (ด้านบน/ตรงกลาง/ด้านล่าง)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
alignmentStringการจัดข้อความ ไม่ว่าจะเป็น 'top', 'middle' หรือ 'bottom' ค่า null จะรีเซ็ตการตรวจสอบความสอดคล้อง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setVerticalAlignments(alignments)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าของการจัดข้อความแนวตั้ง (ต้องตรงกับขนาดของช่วงนี้)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
alignmentsObject[][]อาร์เรย์ของมิติข้อมูล 2 มิติ ไม่ว่าจะเป็น 'top', 'middle' หรือ 'bottom' ค่า null จะรีเซ็ตการตรวจสอบความสอดคล้อง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

ดูเพิ่มเติม


setVerticalText(isVertical)

ตั้งค่าว่าจะให้ซ้อนข้อความสําหรับเซลล์ในช่วงหรือไม่ ถ้าข้อความวางในแนวตั้ง ก็จะไม่สนใจการตั้งค่าการหมุนข้อความ

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
isVerticalBooleanเลือกว่าจะซ้อนข้อความหรือไม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setWrap(isWrapEnabled)

ตั้งค่าการตัดเซลล์ของช่วงที่ระบุ

การปรับขนาดเซลล์ที่เปิดใช้การรวม (ค่าเริ่มต้น) เพื่อแสดงเนื้อหาทั้งหมด เซลล์ที่มีการห่อปิดใช้งานการแสดงผลไว้มากที่สุดในเซลล์โดยไม่มีการปรับขนาดหรือทํางานบนการแสดงหลายบรรทัด

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setWrap(true);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
isWrapEnabledBooleanต้องการตัดข้อความหรือไม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setWrapStrategies(strategies)

ตั้งค่าตารางกริดของกลยุทธ์การรวม

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
strategiesWrapStrategy[][]กลยุทธ์การรวมที่ต้องการ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setWrapStrategy(strategy)

ตั้งค่ากลยุทธ์การตัดข้อความสําหรับเซลล์ในช่วง

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
strategyWrapStrategyกลยุทธ์การรวมที่ต้องการ

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

setWraps(isWrapEnabled)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
isWrapEnabledObject[][]อาร์เรย์ 2 มิติของตัวแปรการรวมที่กําหนดว่าจะรวมข้อความในเซลล์หรือไม่

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

ดูเพิ่มเติม


shiftColumnGroupDepth(delta)

เปลี่ยนความลึกในการจัดกลุ่มคอลัมน์ของช่วงตามจํานวนที่ระบุ

การดําเนินการนี้จะสร้าง แก้ไข หรือลบกลุ่มที่ตัดกับช่วงดังกล่าว สําหรับเดลต้าเชิงบวก กลุ่มจะถูกสร้างขึ้นและ/หรือแก้ไข สําหรับเดลต้าเชิงลบ กลุ่มจะถูกทําลายและ/หรือแก้ไข

ซึ่งจะไม่มีผลเมื่อลดความลึกของกลุ่มลงต่ํากว่า 0 ขึ้นไป

หาก column group control position คือ BEFORE แสดงว่ามีข้อผิดพลาดเมื่อพยายามเปลี่ยนความลึกของแถวแรก

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
deltaIntegerจํานวนที่จะเปลี่ยนแปลงความลึกของกลุ่มคอลัมน์ในช่วงนี้

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

ผ้าคลุม

Error — เมื่อพยายามเปลี่ยนความลึกของคอลัมน์แรกเมื่อตําแหน่งการควบคุมคือ GroupControlTogglePosition.BEFORE

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

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

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

shiftRowGroupDepth(delta)

เปลี่ยนความลึกในการจัดกลุ่มแถวของช่วงตามจํานวนที่ระบุ

การดําเนินการนี้จะสร้าง แก้ไข หรือลบกลุ่มที่ตัดกับช่วงดังกล่าว สําหรับเดลต้าเชิงบวก กลุ่มจะถูกสร้างขึ้นและ/หรือแก้ไข สําหรับเดลต้าเชิงลบ กลุ่มจะถูกทําลายและ/หรือแก้ไข

ซึ่งจะไม่มีผลเมื่อลดความลึกของกลุ่มลงต่ํากว่า 0 ขึ้นไป

หาก row group control position คือ BEFORE แสดงว่ามีข้อผิดพลาดเมื่อพยายามเปลี่ยนความลึกของแถวแรก

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
deltaIntegerจํานวนที่จะเปลี่ยนแปลงความลึกของกลุ่มแถว

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

ผ้าคลุม

Error — เมื่อพยายามเปลี่ยนความลึกของแถวแรกเมื่อตําแหน่งการควบคุมคือ GroupControlTogglePosition.BEFORE

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

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

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

sort(sortSpecObj)

จัดเรียงเซลล์ในช่วงที่ระบุ ตามคอลัมน์ และลําดับที่ระบุ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
sortSpecObjObjectคอลัมน์ที่จะจัดเรียง

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

splitTextToColumns()

แยกคอลัมน์ข้อความเป็นหลายคอลัมน์โดยพิจารณาจากตัวคั่นที่ระบบตรวจพบโดยอัตโนมัติ

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

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

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

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

splitTextToColumns(delimiter)

แยกคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยใช้สตริงที่ระบุเป็นตัวคั่นที่กําหนดเอง

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

พารามิเตอร์

ชื่อประเภทคำอธิบาย
delimiterStringตัวคั่นที่กําหนดเองที่ต้องการแบ่ง

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

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

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

splitTextToColumns(delimiter)

แยกคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยพิจารณาจากตัวคั่นที่ระบุ

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

พารามิเตอร์

ชื่อประเภทคำอธิบาย
delimiterTextToColumnsDelimiterตัวคั่นที่กําหนดไว้ล่วงหน้าสําหรับแบ่งใน

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

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

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

trimWhitespace()

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

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

uncheck()

เปลี่ยนสถานะช่องทําเครื่องหมายในช่วงเป็น "ไม่เลือก" ละเว้นเซลล์ในช่วงที่ไม่กําหนดค่าหรือไม่ได้เลือกอยู่

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'unchecked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

ไปกลับ

Range — ช่วงนี้สําหรับเชนธุรกิจ

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

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

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

วิธีการเลิกใช้งาน