หน้านี้ได้รับการแปลโดย Cloud Translation API

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`	แสดงข้อมูลภายในช่วงนี้เป็น 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`	แสดงผลรหัสตารางกริดของชีตหลักของช่วง
`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`	ตั้งค่าชุดแบบอักษร เช่น "Arial" หรือ "Helvetica"
`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`	เปลี่ยนสถานะของช่องทำเครื่องหมายในช่วงเป็น "ไม่เลือก"

วิธีการที่เลิกใช้งานแล้ว

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getFontColor()`	`String`	แสดงสีแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วงในรูปแบบ CSS (เช่น เป็น `'#ffffff'` หรือ `'white'`)
`getFontColors()`	`String[][]`	แสดงสีแบบอักษรของเซลล์ในช่วงในรูปแบบ CSS (เช่น `'#ffffff'` หรือ `'white'`)

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

`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 ที่ระบุต้องประกอบด้วย 1 เซลล์ มิเช่นนั้นจะส่ง ข้อยกเว้น

// Gets the first sheet of the spreadsheet.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
var range = sheet.getRange('B5');
var currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

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

`addDeveloperMetadata(key)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

พารามิเตอร์

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

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`addDeveloperMetadata(key, visibility)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

พารามิเตอร์

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

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`addDeveloperMetadata(key, value)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 of Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

พารามิเตอร์

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

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`addDeveloperMetadata(key, value, visibility)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
  'NAME',
  'GOOGLE',
  SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`key`	`String`	คีย์สำหรับข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์
`value`	`String`	ค่าสำหรับข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์
`visibility`	`DeveloperMetadataVisibility`	การเปิดเผยข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`applyColumnBanding()`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString());

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

รีเทิร์น

Banding — แถบสีใหม่

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

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

`applyColumnBanding(bandingTheme)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

พารามิเตอร์

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

รีเทิร์น

Banding — แถบสีใหม่

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

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true);

// Gets the banding color and logs it to the console.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

// Gets the header color object and logs it to the console. Returns null because the header
// visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`bandingTheme`	`BandingTheme`	ธีมสีที่จะใช้กับคอลัมน์ในช่วง
`showHeader`	`Boolean`	หากเป็น `true` สีส่วนหัวของธีมแถบสีจะมีผลกับรายการแรก
`showFooter`	`Boolean`	หากเป็น `true` สีส่วนท้ายของธีมแถบสีจะมีผลกับค่า

รีเทิร์น

Banding — แถบสีใหม่

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

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

`applyRowBanding()`

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

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies row banding to rows 1-30.
range.applyRowBanding();

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

รีเทิร์น

Banding — แถบสี

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

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

`applyRowBanding(bandingTheme)`

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

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding theme to rows 1-30.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

พารามิเตอร์

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

รีเทิร์น

Banding — แถบสีใหม่

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

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

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

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding to rows 1-30 and
// specifies to hide the header and show the footer.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`bandingTheme`	`BandingTheme`	ธีมสีที่จะใช้กับแถวในช่วง
`showHeader`	`Boolean`	หากเป็น `true` สีส่วนหัวของธีมแถบสีจะใช้กับแถวแรก
`showFooter`	`Boolean`	หากเป็น `true` สีส่วนท้ายของธีมแถบสีจะมีผลกับแถวสุดท้าย

รีเทิร์น

Banding — แถบสีใหม่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`destination`	`Range`	ช่วงที่จะกรอกค่าโดยอัตโนมัติ ช่วงปลายทางควร มีช่วงนี้และขยายไปในทิศทางเดียวเท่านั้น (ขึ้น ลง ซ้าย หรือ ขวา)
`series`	`AutoFillSeries`	ประเภทของชุดการป้อนอัตโนมัติที่ควรใช้ในการคำนวณค่าใหม่ ของชุดข้อมูลนี้จะแตกต่างกันไป ขึ้นอยู่กับประเภทและปริมาณข้อมูลต้นฉบับ

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

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

`autoFillToNeighbor(series)`

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

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

ตัวอย่างเช่น ถ้า A1:A20 เต็มไปด้วยตัวเลขที่เพิ่มขึ้นและวิธีการนี้ ถูกเรียกในช่วง B1:B4 ซึ่งมีชุดวันที่ ค่าใหม่จะมีค่า แทรกใน B5:B20 แล้ว ด้วยวิธีนี้ ค่าใหม่เหล่านี้จะ "คงที่" ลงในเซลล์ที่มี ในคอลัมน์ 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`series`	`AutoFillSeries`	ประเภทของชุดการป้อนอัตโนมัติที่ควรใช้ในการคำนวณค่าใหม่ ของชุดข้อมูลนี้จะแตกต่างกันไป ขึ้นอยู่กับประเภทและปริมาณข้อมูลต้นฉบับ

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

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

`breakApart()`

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

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

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Unmerges the range A1:C6 into individual cells.
range.breakApart();

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`canEdit()`

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

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Logs whether the user has permission to edit every cell in the range.
console.log(range.canEdit());

รีเทิร์น

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

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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

`clear(options)`

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

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

พารามิเตอร์

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

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

ชื่อ	ประเภท	คำอธิบาย
`commentsOnly`	`Boolean`	ล้างเฉพาะความคิดเห็นไหม
`contentsOnly`	`Boolean`	ล้างเฉพาะเนื้อหาหรือไม่
`formatOnly`	`Boolean`	ล้างเฉพาะรูปแบบหรือไม่ โปรดทราบว่าการล้าง จะล้างกฎการตรวจสอบข้อมูลด้วย
`validationsOnly`	`Boolean`	เลือกว่าจะล้างเฉพาะกฎการตรวจสอบข้อมูลหรือไม่
`skipFilteredRows`	`Boolean`	เลือกว่าจะหลีกเลี่ยงการล้างแถวที่กรองหรือไม่

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`gridId`	`Integer`	รหัสที่ไม่ซ้ำกันของชีตภายในสเปรดชีต โดยไม่คำนึงถึงตำแหน่ง
`column`	`Integer`	คอลัมน์แรกของช่วงเป้าหมาย
`columnEnd`	`Integer`	คอลัมน์สุดท้ายของช่วงเป้าหมาย
`row`	`Integer`	แถวเริ่มต้นของช่วงเป้าหมาย
`rowEnd`	`Integer`	แถวสุดท้ายของช่วงเป้าหมาย

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

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

ดูเพิ่มเติม

getGridId()

`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`sheet`	`Sheet`	ชีตเป้าหมาย
`column`	`Integer`	คอลัมน์แรกของช่วงเป้าหมาย
`columnEnd`	`Integer`	คอลัมน์สุดท้ายของช่วงเป้าหมาย
`row`	`Integer`	แถวเริ่มต้นของช่วงเป้าหมาย
`rowEnd`	`Integer`	แถวสุดท้ายของช่วงเป้าหมาย

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

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));

พารามิเตอร์

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

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`destination`	`Range`	ช่วงปลายทางที่จะคัดลอกไป เฉพาะตำแหน่งของเซลล์ด้านบนซ้ายเท่านั้นที่เกี่ยวข้อง
`copyPasteType`	`CopyPasteType`	ประเภทที่ระบุวิธีวางเนื้อหาของช่วงลงใน ปลายทาง
`transposed`	`Boolean`	ควรวางช่วงในการวางแนวแบบสลับตำแหน่งไหม

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

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});

พารามิเตอร์

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

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

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

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`gridId`	`Integer`	รหัสที่ไม่ซ้ำกันของชีตภายในสเปรดชีต โดยไม่คำนึงถึงตำแหน่ง
`column`	`Integer`	คอลัมน์แรกของช่วงเป้าหมาย
`columnEnd`	`Integer`	คอลัมน์สุดท้ายของช่วงเป้าหมาย
`row`	`Integer`	แถวเริ่มต้นของช่วงเป้าหมาย
`rowEnd`	`Integer`	แถวสุดท้ายของช่วงเป้าหมาย

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

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

ดูเพิ่มเติม

getGridId()

`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`sheet`	`Sheet`	ชีตเป้าหมาย
`column`	`Integer`	คอลัมน์แรกของช่วงเป้าหมาย
`columnEnd`	`Integer`	คอลัมน์สุดท้ายของช่วงเป้าหมาย
`row`	`Integer`	แถวเริ่มต้นของช่วงเป้าหมาย
`rowEnd`	`Integer`	แถวสุดท้ายของช่วงเป้าหมาย

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

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());

พารามิเตอร์

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

รีเทิร์น

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

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

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);

พารามิเตอร์

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

รีเทิร์น

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

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

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

`createDeveloperMetadataFinder()`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6.
const range = sheet.getRange('A1:C6');

// Creates a developer metadata finder to search for metadata in the scope of this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

รีเทิร์น

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 ซึ่งเป็นประเภทเริ่มต้นของชีต ชีตตารางกริดคือชีตที่ไม่ได้เชื่อมต่อกับฐานข้อมูล หากต้องการสร้างตัวกรองประเภทอื่นๆ อ้างอิงถึงรายการต่อไปนี้

สร้างตัวกรองตาราง Pivot ด้วย PivotTable.addFilter(sourceDataColumn, filterCriteria)
สร้างตัวกรองสำหรับชีตที่เชื่อมต่อกับฐานข้อมูลด้วย DataSourceSheet.addFilter(columnName, filterCriteria)
สร้างตัวกรองสำหรับตาราง Pivot ที่เชื่อมต่อกับฐานข้อมูลด้วย DataSourcePivotTable.addFilter(columnName, filterCriteria)

รีเทิร์น

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

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

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

`createPivotTable(sourceData)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

พารามิเตอร์

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

รีเทิร์น

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

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

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 = textFinder.replaceWith('cat');

พารามิเตอร์

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

รีเทิร์น

TextFinder — TextFinder ของช่วง

`deleteCells(shiftDimension)`

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

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

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

พารามิเตอร์

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

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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

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

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 — รหัสสีของพื้นหลัง

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

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 — สีพื้นหลังของเซลล์ด้านซ้ายบนของช่วง

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

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 มิติของสีพื้นหลัง

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

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 มิติของรหัสสีของพื้นหลัง

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

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

`getBandings()`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets a range.
const range = sheet.getRange('A1:K50');

// Gets the banding info for the range.
const bandings = range.getBandings();

// Logs the second row color for each banding to the console.
for (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

รีเทิร์น

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

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

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());

พารามิเตอร์

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

รีเทิร์น

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

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

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 — ตำแหน่งคอลัมน์เริ่มต้นของช่วงในสเปรดชีต

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

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 — เขตข้อมูลของช่วงหรือช่วงของทั้งสเปรดชีต

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

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());

พารามิเตอร์

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

รีเทิร์น

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

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

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

`getDataSourceFormula()`

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

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1 on Sheet1.
const range = sheet.getRange('A1');

// Gets the data source formula from cell A1.
const dataSourceFormula = range.getDataSourceFormula();

// Gets the formula.
const formula = dataSourceFormula.getFormula();

// Logs the formula.
console.log(formula);

รีเทิร์น

DataSourceFormula — DataSourceFormula ของเซลล์

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

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

`getDataSourceFormulas()`

แสดงผล DataSourceFormula สำหรับเซลล์ในช่วง

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B5 on Sheet1.
const range = sheet.getRange('A1:B5');

// Gets an array of the data source formulas in the range A1:B5.
const dataSourceFormulas = range.getDataSourceFormulas();

// Logs the first formula in the array.
console.log(dataSourceFormulas[0].getFormula());

รีเทิร์น

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

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

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

`getDataSourcePivotTables()`

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

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets an array of the data source pivot tables in the range A1:G50.
const dataSourcePivotTables = range.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

รีเทิร์น

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

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

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

`getDataSourceTables()`

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

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets the first data source table in the range A1:G50.
const dataSourceTable = range.getDataSourceTables()[0];

// Logs the time of the last completed data execution on the data source table.
console.log(dataSourceTable.getStatus().getLastExecutionTime());

รีเทิร์น

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

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

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();
}

piechart.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 อื่นๆ เช่น แผนภูมิ

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

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

`getDataTable()`

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

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B7 on Sheet1.
const range = sheet.getRange('A1:B7');

// Gets the range A1:B7 as a data table. The values in each column must be of the same type.
const datatable = range.getDataTable();

// Uses the Charts service to build a bar chart from the data table.
// This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Chart Title Here')
                  .build();

รีเทิร์น

DataTable — ข้อมูลในรูปแบบตารางข้อมูล

`getDataTable(firstRowIsHeader)`

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

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();

พารามิเตอร์

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

รีเทิร์น

DataTable — ข้อมูลในรูปแบบตารางข้อมูล

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

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 — กฎการตรวจสอบข้อมูลสำหรับเซลล์ด้านบนซ้ายของช่วง

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

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 มิติของกฎการตรวจสอบข้อมูลที่เชื่อมโยงกับเซลล์ใน

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

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

`getDeveloperMetadata()`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds metadata to row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Logs the metadata to console.
for (const metadata of range.getDeveloperMetadata()) {
  console.log(`${metadata.getKey()}: ${metadata.getValue()}`);
}

รีเทิร์น

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

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

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

`getDisplayValue()`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

// Gets the value and logs it to the console.
console.log(cell.getDisplayValue());

รีเทิร์น

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

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

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

`getDisplayValues()`

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

แสดงผลอาร์เรย์ 2 มิติของค่าที่แสดง จัดทำดัชนีตามแถว และตามคอลัมน์ ค่าคือออบเจ็กต์ 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 มิติ

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

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 — ตัวกรอง

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

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 — สีแบบอักษรของเซลล์ด้านซ้ายบนของช่วง

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

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[][] — อาร์เรย์ 2 มิติของสีแบบอักษรที่เชื่อมโยงกับเซลล์ในช่วง

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

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 มิติของชุดแบบอักษรที่เชื่อมโยงกับเซลล์ในช่วง

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

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 — ชุดแบบอักษรของเซลล์

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

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 — บรรทัดของแบบอักษร

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

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 มิติของบรรทัดแบบอักษรที่เชื่อมโยงกับเซลล์ในช่วง

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

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 — ขนาดแบบอักษรในขนาดจุด

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

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 มิติของขนาดแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง

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

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 — รูปแบบตัวอักษรของข้อความในเซลล์

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

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 มิติของรูปแบบแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง

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

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 — น้ำหนักแบบอักษรของข้อความในเซลล์

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

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 มิติของน้ำหนักแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง

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

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 — สูตรสำหรับเซลล์

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

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

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

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

`getFormulas()`

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

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 มิติของสูตรในรูปแบบสตริง

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

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

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

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

`getGridId()`

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

// 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 — รหัสตารางกริดของชีตหลัก

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

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 — ความสูงของช่วง

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

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 — การจัดแนวข้อความในเซลล์ในแนวนอน

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

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 มิติของข้อความที่อยู่ในแนวแนวนอนที่เชื่อมโยงกับเซลล์ใน

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

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 — ตำแหน่งคอลัมน์สิ้นสุดของช่วงในสเปรดชีต

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

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 — ตำแหน่งแถวสุดท้ายของช่วงในสเปรดชีต

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

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());

พารามิเตอร์

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

รีเทิร์น

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

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

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 — โน้ตที่เกี่ยวข้องกับเซลล์ที่ระบุ

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

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 มิติของบันทึกที่เชื่อมโยงกับเซลล์ในช่วง

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

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 — จำนวนคอลัมน์ในช่วงนี้

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

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 — จำนวนแถวในช่วงนี้

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

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

`getNumberFormat()`

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

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

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

รีเทิร์น

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

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

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

`getNumberFormats()`

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

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

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

`getRichTextValue()`

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

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

รีเทิร์น

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

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

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

`getRichTextValues()`

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

// Gets 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++) {
    console.log(values[i][j].getText());
  }
}

รีเทิร์น

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

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

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 — ตำแหน่งแถวของช่วง

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

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 — ตำแหน่งแถวของช่วง

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

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

ดูเพิ่มเติม

getRow()

`getSheet()`

แสดงผลชีตของช่วงนี้

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the sheet that the range belongs to.
const rangeSheet = range.getSheet();

// Gets the sheet name and logs it to the console.
console.log(rangeSheet.getName());

รีเทิร์น

Sheet — แผ่นงานที่มีช่วงนี้

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

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 — ทิศทางข้อความของเซลล์ซ้ายบนสุดในช่วง

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

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 มิติของทิศทางข้อความ

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

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 — การตั้งค่าการหมุนข้อความ

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

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 มิติของการหมุนข้อความที่เชื่อมโยงกับเซลล์ในช่วง

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

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 — รูปแบบข้อความของเซลล์ซ้ายบนสุดในช่วง

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

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 มิติของรูปแบบข้อความ

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

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

`getValue()`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the value of the top-left cell in the range and logs it to the console.
console.log(range.getValue());

รีเทิร์น

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

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

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

`getValues()`

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

แสดงผลอาร์เรย์สองมิติของค่า จัดทำดัชนีตามแถว และตามคอลัมน์ ค่าอาจเป็น ประเภท 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 มิติ

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

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 — การจัดแนวข้อความในเซลล์ในแนวตั้ง

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

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 มิติของข้อความที่อยู่ในแนวดิ่งที่เชื่อมโยงกับเซลล์ใน

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

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

`getWidth()`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the width of the range in number of columns and logs it to the console.
console.log(range.getWidth());

รีเทิร์น

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

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

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 — ข้อความในเซลล์นี้ตัดขึ้นบรรทัดใหม่หรือไม่

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

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 มิติ

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

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 — กลยุทธ์การตัดข้อความของเซลล์ซ้ายบนสุดในช่วง

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

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 มิติของข้อความที่อยู่ในแนวดิ่งที่เชื่อมโยงกับเซลล์ใน

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

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);

พารามิเตอร์

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

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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

พารามิเตอร์

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

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

พารามิเตอร์

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

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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());

รีเทิร์น

Boolean — true หากช่วงว่างเปล่า false หรือไม่เช่นนั้น

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

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();

รีเทิร์น

Boolean — true ถ้าเลือกเซลล์ทั้งหมดในช่วงไว้ false ถ้าเลือกทุกเซลล์ในฟิลด์ ไม่ได้เลือกไว้ หรือ null หากมีการยกเลิกการเลือกเซลล์ใดหรือไม่มีเซลล์ใด การตรวจสอบข้อมูลของช่องทำเครื่องหมาย

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

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

`isEndColumnBounded()`

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

 // Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular column and logs it to the
// console.
console.log(range.isEndColumnBounded());

รีเทิร์น

Boolean — true หากจุดสิ้นสุดของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่ง false หรือไม่เช่นนั้น

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

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

`isEndRowBounded()`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular row and logs it to the console.
console.log(range.isEndRowBounded());

รีเทิร์น

Boolean — true หากจุดสิ้นสุดของช่วงเชื่อมโยงกับแถวใดแถวหนึ่ง false หรือไม่เช่นนั้น

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

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular column and logs it to the
// console.
console.log(range.isStartColumnBounded());

รีเทิร์น

Boolean — true หากจุดเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่ง false หรือไม่เช่นนั้น

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

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

`isStartRowBounded()`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular row and logs it to the
// console.
console.log(range.isStartRowBounded());

รีเทิร์น

Boolean — true หากจุดเริ่มต้นของช่วงเชื่อมโยงกับแถวใดแถวหนึ่ง false หรือไม่เช่นนั้น

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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"));

พารามิเตอร์

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

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowOffset`	`Integer`	จำนวนแถวที่ลงมาจากเซลล์ด้านบนซ้ายของช่วง ค่าลบ หมายถึงแถวขึ้นจากเซลล์ซ้ายบนของช่วง
`columnOffset`	`Integer`	จำนวนคอลัมน์จากเซลล์ซ้ายบนของช่วง ค่าลบ แสดงคอลัมน์ทางซ้ายจากเซลล์ซ้ายบนของช่วง

รีเทิร์น

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowOffset`	`Integer`	จำนวนแถวที่ลงมาจากเซลล์ด้านบนซ้ายของช่วง ค่าลบ หมายถึงแถวขึ้นจากเซลล์ซ้ายบนของช่วง
`columnOffset`	`Integer`	จำนวนคอลัมน์จากเซลล์ซ้ายบนของช่วง ค่าลบ แสดงคอลัมน์ทางซ้ายจากเซลล์ซ้ายบนของช่วง
`numRows`	`Integer`	ความสูงในแถวของช่วงใหม่

รีเทิร์น

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowOffset`	`Integer`	จำนวนแถวที่ลงมาจากเซลล์ด้านบนซ้ายของช่วง ค่าลบ หมายถึงแถวขึ้นจากเซลล์ซ้ายบนของช่วง
`columnOffset`	`Integer`	จำนวนคอลัมน์จากเซลล์ซ้ายบนของช่วง ค่าลบ แสดงคอลัมน์ทางซ้ายจากเซลล์ซ้ายบนของช่วง
`numRows`	`Integer`	ความสูงในแถวของช่วงใหม่
`numColumns`	`Integer`	ความกว้างในคอลัมน์ของช่วงใหม่

รีเทิร์น

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 — ออบเจ็กต์ที่แสดงการตั้งค่าการป้องกัน

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงผลลัพธ์หลังจากนำรายการที่ซ้ำออก ขนาดของช่วงจะลดลง แถวสำหรับทุกๆ แถวที่นำออกแล้ว

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnsToCompare`	`Integer[]`	คอลัมน์ที่จะวิเคราะห์หาค่าที่ซ้ำกัน หากไม่มีคอลัมน์ จากนั้นจะมีการวิเคราะห์คอลัมน์ทั้งหมดเพื่อหารายการที่ซ้ำกัน

รีเทิร์น

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

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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`color`	`String`	รหัสสีในรูปแบบ CSS (เช่น `'#ffffff'` หรือ `'white'`) CANNOT TRANSLATE ค่า `null` จะรีเซ็ตสี

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`color`	`Color`	สีพื้นหลังที่จะตั้งค่า ค่า `null` จะรีเซ็ตสีพื้นหลัง

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`color`	`Color[][]`	อาร์เรย์ของสีสองมิติ ค่า `null` จะรีเซ็ตสี

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`red`	`Integer`	ค่าสีแดงในรูปแบบ RGB
`green`	`Integer`	ค่าสีเขียวในรูปแบบ RGB
`blue`	`Integer`	ค่าสีน้ำเงินในรูปแบบ RGB

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`color`	`String[][]`	อาร์เรย์ 2 มิติของสีในรูปแบบ CSS (เช่น `'#ffffff'` หรือ `'white'`); ค่า `null` จะรีเซ็ตสี

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`top`	`Boolean`	`true` สำหรับเส้นขอบ, `false` สำหรับไม่มี, `null` สำหรับไม่เปลี่ยนแปลง
`left`	`Boolean`	`true` สำหรับเส้นขอบ, `false` สำหรับไม่มี, `null` สำหรับไม่เปลี่ยนแปลง
`bottom`	`Boolean`	`true` สำหรับเส้นขอบ, `false` สำหรับไม่มี, `null` สำหรับไม่เปลี่ยนแปลง
`right`	`Boolean`	`true` สำหรับเส้นขอบ, `false` สำหรับไม่มี, `null` สำหรับไม่เปลี่ยนแปลง
`vertical`	`Boolean`	`true` สำหรับเส้นขอบแนวตั้งภายใน `false` ไม่มีการเปลี่ยนแปลง `null` หากไม่มีการเปลี่ยนแปลง
`horizontal`	`Boolean`	`true` สำหรับเส้นขอบแนวนอนภายใน `false` สำหรับไม่มี `null` สำหรับไม่เปลี่ยนแปลง

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`top`	`Boolean`	`true` สำหรับเส้นขอบ, `false` สำหรับไม่มี, `null` สำหรับไม่เปลี่ยนแปลง
`left`	`Boolean`	`true` สำหรับเส้นขอบ, `false` สำหรับไม่มี, `null` สำหรับไม่เปลี่ยนแปลง
`bottom`	`Boolean`	`true` สำหรับเส้นขอบ, `false` สำหรับไม่มี, `null` สำหรับไม่เปลี่ยนแปลง
`right`	`Boolean`	`true` สำหรับเส้นขอบ, `false` สำหรับไม่มี, `null` สำหรับไม่เปลี่ยนแปลง
`vertical`	`Boolean`	`true` สำหรับเส้นขอบแนวตั้งภายใน `false` ไม่มีการเปลี่ยนแปลง `null` หากไม่มีการเปลี่ยนแปลง
`horizontal`	`Boolean`	`true` สำหรับเส้นขอบแนวนอนภายใน `false` สำหรับไม่มี `null` สำหรับไม่เปลี่ยนแปลง
`color`	`String`	สีในรูปแบบ CSS (เช่น `'#ffffff'` หรือ `'white'`), `null` สำหรับสีเริ่มต้น (สีดำ)
`style`	`BorderStyle`	รูปแบบสำหรับเส้นขอบ `null` สำหรับรูปแบบเริ่มต้น (ทึบ)

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

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

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`setDataValidations(rules)`

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

// 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rules`	`DataValidation[][]`	อาร์เรย์ 2 มิติของกฎการตรวจสอบข้อมูลที่จะกำหนด ค่า `null` นำการตรวจสอบข้อมูลออก

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`color`	`String`	สีแบบอักษรในรูปแบบ CSS (เช่น `'#ffffff'` หรือ `'white'`) CANNOT TRANSLATE ค่า `null` จะรีเซ็ตสี

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`color`	`Color`	สีแบบอักษรที่ต้องการตั้งค่า ค่า `null` จะรีเซ็ตสี

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`colors`	`Color[][]`	อาร์เรย์ของสีสองมิติ ค่า `null` จะรีเซ็ตสีแบบอักษร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`colors`	`Object[][]`	อาร์เรย์ 2 มิติของสีในรูปแบบ CSS (เช่น `'#ffffff'` หรือ `'white'`); ค่า `null` จะรีเซ็ตสี

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`setFontFamilies(fontFamilies)`

ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของชุดแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) ตัวอย่างของ ชุดแบบอักษรคือ "Arial" หรือ "Helvetica"

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`fontFamilies`	`Object[][]`	อาร์เรย์สองมิติของแบบอักษร ค่า `null` ได้รีเซ็ตค่า ชุดแบบอักษร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`setFontFamily(fontFamily)`

ตั้งค่าชุดแบบอักษร เช่น "Arial" หรือ "Helvetica"

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

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`fontFamily`	`String`	ชุดแบบอักษรที่จะตั้งค่า ค่า `null` จะรีเซ็ตชุดแบบอักษร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`fontLine`	`String`	รูปแบบเส้นแบบอักษร ซึ่งอาจเป็น `'underline'`, `'line-through'` หรือ `'none'`; ค่า `null` จะรีเซ็ตรูปแบบเส้นแบบอักษร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`fontLines`	`Object[][]`	อาร์เรย์ 2 มิติของรูปแบบเส้นแบบอักษร (`'underline'`, `'line-through'` หรือ `'none'`) ค่า `null` จะรีเซ็ตรูปแบบเส้นแบบอักษร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`size`	`Integer`	ขนาดแบบอักษรในขนาดจุด

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`sizes`	`Object[][]`	อาร์เรย์สองมิติของขนาด

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`fontStyle`	`String`	รูปแบบตัวอักษร `'italic'` หรือ `'normal'` `null` จะรีเซ็ตรูปแบบตัวอักษร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`fontStyles`	`Object[][]`	อาร์เรย์ 2 มิติของรูปแบบแบบอักษร `'italic'` หรือ `'normal'` ค่า `null` จะรีเซ็ตรูปแบบตัวอักษร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`fontWeight`	`String`	น้ำหนักของแบบอักษร `'bold'` หรือ `'normal'` `null` จะรีเซ็ตน้ำหนักของแบบอักษร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`setFontWeights(fontWeights)`

ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าสำหรับน้ำหนักแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) ตัวอย่างของ ความหนาของแบบอักษรคือ "ตัวหนา"

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`fontWeights`	`Object[][]`	อาร์เรย์ 2 มิติของน้ำหนักแบบอักษร `'bold'` หรือ `'normal'` ค่า `null` จะรีเซ็ตน้ำหนักแบบอักษร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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)");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`formula`	`String`	สตริงที่แสดงถึงสูตรที่จะตั้งให้กับเซลล์

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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])");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`formula`	`String`	สูตรสตริง

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`formulas`	`String[][]`	อาร์เรย์สตริง 2 มิติของสูตร

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`formulas`	`String[][]`	อาร์เรย์ 2 มิติของสูตรในรูปแบบ R1C1

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`alignment`	`String`	การจัดข้อความ `'left'`, `'center'` หรือ `'normal'` CANNOT TRANSLATE ค่า `null` จะรีเซ็ตการจัดข้อความ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`alignments`	`Object[][]`	อาร์เรย์ 2 มิติของการจัดแนว ซึ่งได้แก่ `'left'`, `'center'` หรือ `'normal'` ค่า `null` จะรีเซ็ตการจัดข้อความ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

ดูเพิ่มเติม

setHorizontalAlignment(alignment)

`setNote(note)`

ตั้งค่าโน้ตเป็นค่าที่ระบุ

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

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`note`	`String`	ค่าหมายเหตุที่จะตั้งสำหรับช่วง ค่า `null` จะนำหมายเหตุออก

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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)

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`notes`	`Object[][]`	อาร์เรย์ 2 มิติของหมายเหตุ ค่า `null` จะนำหมายเหตุออก

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

ดูเพิ่มเติม

setNote(note)

`setNumberFormat(numberFormat)`

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

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

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`numberFormat`	`String`	สตริงรูปแบบตัวเลข

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`numberFormats`	`Object[][]`	อาร์เรย์สองมิติของรูปแบบตัวเลข

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`value`	`RichTextValue`	ค่า Rich Text ที่ต้องการ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`values`	`RichTextValue[][]`	ค่า Rich Text ที่ต้องการ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

`setShowHyperlink(showHyperlink)`

ตั้งค่าว่าช่วงควรแสดงไฮเปอร์ลิงก์หรือไม่

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

// Sets cell A30 to show hyperlinks.
range.setShowHyperlink(true);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`showHyperlink`	`Boolean`	จะแสดงไฮเปอร์ลิงก์หรือไม่

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`direction`	`TextDirection`	ทิศทางข้อความที่ต้องการ ถ้า `null` ทิศทางจะอนุมานก่อน การตั้งค่า

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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());

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`directions`	`TextDirection[][]`	เส้นทางของข้อความที่ต้องการ หากทิศทางที่ระบุคือ `null` ก็จะเป็น ก่อนการตั้งค่า

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`degrees`	`Integer`	มุมที่ต้องการระหว่างการวางแนวมาตรฐานและการวางแนวที่ต้องการ สำหรับข้อความแบบซ้ายไปขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rotation`	`TextRotation`	การตั้งค่าการหมุนข้อความที่ต้องการ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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());

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rotations`	`TextRotation[][]`	การตั้งค่าการหมุนข้อความที่ต้องการ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`style`	`TextStyle`	รูปแบบข้อความที่ต้องการ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`styles`	`TextStyle[][]`	รูปแบบข้อความที่ต้องการ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`value`	`Object`	ค่าของช่วง

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`values`	`Object[][]`	อาร์เรย์ค่าสองมิติ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`alignment`	`String`	การจัดข้อความ `'top'`, `'middle'` หรือ `'bottom'` CANNOT TRANSLATE ค่า `null` จะรีเซ็ตการจัดข้อความ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`alignments`	`Object[][]`	อาร์เรย์ 2 มิติของการจัดข้อความ `'top'`, `'middle'` หรือ `'bottom'`; ค่า `null` จะรีเซ็ตการจัดข้อความ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

ดูเพิ่มเติม

setVerticalAlignment(alignment)

`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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`isVertical`	`Boolean`	ซ้อนข้อความหรือไม่

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`isWrapEnabled`	`Boolean`	ตัดข้อความขึ้นบรรทัดใหม่หรือไม่

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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());

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`strategies`	`WrapStrategy[][]`	กลยุทธ์การรวมที่ต้องการ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`strategy`	`WrapStrategy`	กลยุทธ์การรวมที่ต้องการ

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`isWrapEnabled`	`Object[][]`	อาร์เรย์ 2 มิติของตัวแปรการรวมที่กำหนดว่าจะตัดหรือไม่ ข้อความในเซลล์หรือไม่

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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

ดูเพิ่มเติม

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

เปลี่ยนความลึกในการจัดกลุ่มคอลัมน์ของช่วงตามจำนวนที่ระบุ

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

การเลือกนี้จะไม่มีผลเมื่อลดความลึกของกลุ่มให้ต่ำกว่า 0 หรือต่ำกว่า 8

หาก 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`delta`	`Integer`	จำนวนที่จะเปลี่ยนความลึกของกลุ่มคอลัมน์ของช่วงนี้

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

การขว้าง

Error — เมื่อพยายามเปลี่ยนความลึกของคอลัมน์แรกเมื่อ ตำแหน่งควบคุมคือ GroupControlTogglePosition.BEFORE

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

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

`shiftRowGroupDepth(delta)`

เปลี่ยนความลึกในการจัดกลุ่มแถวของช่วงตามจำนวนที่ระบุ

การเลือกนี้จะไม่มีผลเมื่อลดความลึกของกลุ่มให้ต่ำกว่า 0 หรือต่ำกว่า 8

หาก 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`delta`	`Integer`	จำนวนที่จะเปลี่ยนความลึกของกลุ่มแถวของช่วงนี้

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

การขว้าง

Error — เมื่อพยายามเปลี่ยนความลึกของแถวแรกเมื่อตัวควบคุม ตำแหน่งคือ GroupControlTogglePosition.BEFORE

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

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}]);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`sortSpecObj`	`Object`	คอลัมน์ที่จะจัดเรียง

รีเทิร์น

Range — ช่วงนี้สำหรับการทำสายโซ่

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

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            |

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

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            |

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`delimiter`	`String`	ตัวคั่นที่กำหนดเองที่จะแยก

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

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            |

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`delimiter`	`TextToColumnsDelimiter`	ตัวคั่นที่กำหนดล่วงหน้าที่จะแยก

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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 — ช่วงนี้สำหรับการทำสายโซ่

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

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

วิธีการที่เลิกใช้งานแล้ว

`getFontColor()`

เลิกใช้งานแล้ว แทนที่โดย getFontColorObject()

แสดงสีแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วงในรูปแบบ CSS (เช่น เป็น '#ffffff' หรือ 'white')

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

Logger.log(range.getFontColor());

รีเทิร์น

String — สีแบบอักษรในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

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

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

`getFontColors()`

เลิกใช้งานแล้ว แทนที่โดย getFontColorObjects()

แสดงสีแบบอักษรของเซลล์ในช่วงในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

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

var results = range.getFontColors();

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

รีเทิร์น

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

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

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