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

Class Sheet

เข้าถึงและแก้ไขชีตสเปรดชีต การดำเนินการทั่วไป ได้แก่ การเปลี่ยนชื่อชีตและการเข้าถึงออบเจ็กต์ช่วงจากชีต

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`activate()`	`Sheet`	เปิดใช้งานชีตนี้
`addDeveloperMetadata(key)`	`Sheet`	เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์ที่ระบุลงในชีต
`addDeveloperMetadata(key, visibility)`	`Sheet`	เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์และระดับการแชร์ที่ระบุลงในชีต
`addDeveloperMetadata(key, value)`	`Sheet`	เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์และค่าที่ระบุลงในชีต
`addDeveloperMetadata(key, value, visibility)`	`Sheet`	เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์ ค่า และการแชร์ที่กำหนดไว้ในชีต
`appendRow(rowContents)`	`Sheet`	เพิ่มแถวต่อท้ายด้านล่างของเขตข้อมูลปัจจุบันในชีต
`asDataSourceSheet()`	`DataSourceSheet`	แสดงผลชีตเป็น `DataSourceSheet` หากชีตเป็นประเภท `SheetType.DATASOURCE` หรือ `null` ในกรณีอื่นๆ
`autoResizeColumn(columnPosition)`	`Sheet`	ตั้งค่าความกว้างของคอลัมน์ที่ระบุให้พอดีกับเนื้อหา
`autoResizeColumns(startColumn, numColumns)`	`Sheet`	กำหนดความกว้างของคอลัมน์ทั้งหมดโดยเริ่มจากตำแหน่งคอลัมน์ที่ระบุเพื่อให้พอดีกับเนื้อหา
`autoResizeRows(startRow, numRows)`	`Sheet`	กำหนดความสูงของแถวทั้งหมดโดยเริ่มจากตำแหน่งแถวที่ระบุเพื่อให้พอดีกับเนื้อหา
`clear()`	`Sheet`	ล้างชีตเนื้อหาและข้อมูลการจัดรูปแบบ
`clear(options)`	`Sheet`	ล้างชีตเนื้อหาและ/หรือรูปแบบตามที่ระบุด้วยตัวเลือกขั้นสูงที่ระบุ
`clearConditionalFormatRules()`	`void`	นำกฎการจัดรูปแบบตามเงื่อนไขทั้งหมดออกจากชีต
`clearContents()`	`Sheet`	ล้างชีตเนื้อหาโดยที่ยังคงข้อมูลการจัดรูปแบบไว้
`clearFormats()`	`Sheet`	ล้างการจัดรูปแบบชีตโดยที่เก็บเนื้อหาไว้
`clearNotes()`	`Sheet`	ล้างชีตของโน้ตทั้งหมด
`collapseAllColumnGroups()`	`Sheet`	ยุบกลุ่มคอลัมน์ทั้งหมดในชีต
`collapseAllRowGroups()`	`Sheet`	ยุบกลุ่มแถวทั้งหมดในชีต
`copyTo(spreadsheet)`	`Sheet`	คัดลอกชีตไปยังสเปรดชีตที่ระบุ ซึ่งอาจเป็นสเปรดชีตเดียวกับแหล่งที่มาก็ได้
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	แสดงผล `DeveloperMetadataFinder` สำหรับการค้นหาข้อมูลเมตาของนักพัฒนาแอปภายในขอบเขตของชีตนี้
`createTextFinder(findText)`	`TextFinder`	สร้างเครื่องมือค้นหาข้อความสำหรับชีต ซึ่งสามารถค้นหาและแทนที่ข้อความภายในชีตได้
`deleteColumn(columnPosition)`	`Sheet`	ลบคอลัมน์ในตำแหน่งคอลัมน์ที่ระบุ
`deleteColumns(columnPosition, howMany)`	`void`	ลบจำนวนคอลัมน์โดยเริ่มจากตำแหน่งคอลัมน์ที่ระบุ
`deleteRow(rowPosition)`	`Sheet`	ลบแถวในตําแหน่งแถวที่ระบุ
`deleteRows(rowPosition, howMany)`	`void`	ลบจำนวนแถวที่เริ่มต้นจากตําแหน่งของแถวที่ระบุ
`expandAllColumnGroups()`	`Sheet`	ขยายกลุ่มคอลัมน์ทั้งหมดในชีต
`expandAllRowGroups()`	`Sheet`	ขยายกลุ่มแถวทั้งหมดในชีต
`expandColumnGroupsUpToDepth(groupDepth)`	`Sheet`	ขยายกลุ่มคอลัมน์ทั้งหมดจนถึงระดับความลึกที่กำหนด และยุบกลุ่มอื่นๆ ทั้งหมด
`expandRowGroupsUpToDepth(groupDepth)`	`Sheet`	ขยายกลุ่มแถวทั้งหมดจนถึงระดับความลึกที่กำหนด และยุบกลุ่มอื่นๆ ทั้งหมด
`getActiveCell()`	`Range`	แสดงผลเซลล์ที่ใช้งานอยู่ในชีตนี้
`getActiveRange()`	`Range`	แสดงผลช่วงที่คุณเลือกในสเปรดชีตที่ใช้งานอยู่ หรือ `null` หากไม่มีช่วงทำงานอยู่
`getActiveRangeList()`	`RangeList`	แสดงรายการช่วงที่มีการใช้งานในสเปรดชีตที่ใช้งานอยู่ หรือ `null` หากไม่มีช่วงที่มีการใช้งาน
`getBandings()`	`Banding[]`	แสดงผลแถบทั้งหมดในชีตนี้
`getCharts()`	`EmbeddedChart[]`	แสดงผลอาร์เรย์ของแผนภูมิในชีตนี้
`getColumnGroup(columnIndex, groupDepth)`	`Group`	แสดงผลกลุ่มคอลัมน์ที่ดัชนีและความลึกของกลุ่มที่ระบุ
`getColumnGroupControlPosition()`	`GroupControlTogglePosition`	แสดงผล `GroupControlTogglePosition` สำหรับกลุ่มคอลัมน์ทั้งหมดในชีต
`getColumnGroupDepth(columnIndex)`	`Integer`	แสดงผลระดับกลุ่มของคอลัมน์ที่ดัชนีที่ระบุ
`getColumnWidth(columnPosition)`	`Integer`	รับความกว้างเป็นพิกเซลของคอลัมน์ที่ระบุ
`getConditionalFormatRules()`	`ConditionalFormatRule[]`	ดูกฎการจัดรูปแบบตามเงื่อนไขทั้งหมดในชีตนี้
`getCurrentCell()`	`Range`	แสดงผลเซลล์ปัจจุบันในสเปรดชีตที่ใช้งานอยู่ หรือ `null` หากไม่มีเซลล์ปัจจุบัน
`getDataRange()`	`Range`	แสดงผล `Range` ที่สอดคล้องกับมิติข้อมูลที่มีข้อมูลอยู่
`getDataSourceFormulas()`	`DataSourceFormula[]`	รับสูตรแหล่งข้อมูลทั้งหมด
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	รับตาราง Pivot ของแหล่งข้อมูลทั้งหมด
`getDataSourceTables()`	`DataSourceTable[]`	รับตารางแหล่งข้อมูลทั้งหมด
`getDeveloperMetadata()`	`DeveloperMetadata[]`	รับข้อมูลเมตาของนักพัฒนาแอปทั้งหมดที่เชื่อมโยงกับชีตนี้
`getDrawings()`	`Drawing[]`	แสดงผลอาร์เรย์ของภาพวาดในชีต
`getFilter()`	`Filter`	แสดงฟิลเตอร์ในสเปรดชีตนี้ หรือ `null` หากไม่มีตัวกรอง
`getFormUrl()`	`String`	แสดงผล URL ของแบบฟอร์มที่ส่งคําตอบไปยังชีตนี้ หรือ `null` หากชีตนี้ไม่มีแบบฟอร์มที่เชื่อมโยง
`getFrozenColumns()`	`Integer`	แสดงผลจํานวนคอลัมน์ที่ตรึงไว้
`getFrozenRows()`	`Integer`	แสดงผลจํานวนแถวที่ตรึงไว้
`getImages()`	`OverGridImage[]`	แสดงผลรูปภาพที่วางทับบนตารางกริดทั้งหมดในชีต
`getIndex()`	`Integer`	รับตําแหน่งของชีตในสเปรดชีตหลัก
`getLastColumn()`	`Integer`	แสดงผลตําแหน่งคอลัมน์สุดท้ายที่มีเนื้อหา
`getLastRow()`	`Integer`	แสดงตำแหน่งของแถวสุดท้ายที่มีเนื้อหา
`getMaxColumns()`	`Integer`	แสดงผลจํานวนคอลัมน์ปัจจุบันในชีต โดยไม่คำนึงถึงเนื้อหา
`getMaxRows()`	`Integer`	แสดงผลจํานวนแถวปัจจุบันในชีต โดยไม่คำนึงถึงเนื้อหา
`getName()`	`String`	แสดงผลชื่อชีต
`getNamedRanges()`	`NamedRange[]`	รับช่วงที่มีชื่อทั้งหมดในสเปรดชีตนี้
`getParent()`	`Spreadsheet`	แสดงผล `Spreadsheet` ที่มีชีตนี้
`getPivotTables()`	`PivotTable[]`	แสดงตาราง Pivot ทั้งหมดในชีตนี้
`getProtections(type)`	`Protection[]`	รับอาร์เรย์ของออบเจ็กต์ที่แสดงถึงช่วงที่ป้องกันทั้งหมดในชีต หรืออาร์เรย์องค์ประกอบเดียวที่แสดงถึงการป้องกันในชีต
`getRange(row, column)`	`Range`	แสดงผลช่วงที่มีเซลล์ซ้ายบนสุดที่พิกัดที่ระบุ
`getRange(row, column, numRows)`	`Range`	แสดงผลช่วงที่มีเซลล์ซ้ายบนที่พิกัดที่ระบุ และมีจำนวนแถวที่ระบุ
`getRange(row, column, numRows, numColumns)`	`Range`	แสดงผลช่วงที่มีเซลล์ซ้ายบนที่พิกัดที่ระบุซึ่งมีจํานวนแถวและคอลัมน์ที่ระบุ
`getRange(a1Notation)`	`Range`	แสดงผลช่วงตามที่ระบุไว้ในรูปแบบ A1 หรือ R1C1
`getRangeList(a1Notations)`	`RangeList`	แสดงผลคอลเล็กชัน `RangeList` ที่แสดงถึงช่วงในสเปรดชีตเดียวกันที่ระบุโดยรายการการเขียน A1 หรือการเขียน R1C1 ที่ไม่ใช่ค่าว่าง
`getRowGroup(rowIndex, groupDepth)`	`Group`	แสดงผลกลุ่มแถวที่ดัชนีและความลึกของกลุ่มที่ระบุ
`getRowGroupControlPosition()`	`GroupControlTogglePosition`	แสดงผล `GroupControlTogglePosition` สำหรับกลุ่มแถวทั้งหมดในชีต
`getRowGroupDepth(rowIndex)`	`Integer`	แสดงผลระดับกลุ่มของแถวที่ดัชนีที่ระบุ
`getRowHeight(rowPosition)`	`Integer`	รับความสูงเป็นพิกเซลของแถวที่ระบุ
`getSelection()`	`Selection`	แสดงผล `Selection` ปัจจุบันในสเปรดชีต
`getSheetId()`	`Integer`	แสดงผลรหัสชีตที่แสดงโดยออบเจ็กต์นี้
`getSheetName()`	`String`	แสดงผลชื่อชีต
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	แสดงผลตารางกริดสี่เหลี่ยมผืนผ้าของค่าสําหรับช่วงนี้โดยเริ่มจากพิกัดที่ระบุ
`getSlicers()`	`Slicer[]`	แสดงผลอาร์เรย์ของเครื่องมือเลือกข้อมูลในชีต
`getTabColorObject()`	`Color`	รับสีแท็บชีต หรือ `null` หากแท็บชีตไม่มีสี
`getType()`	`SheetType`	แสดงผลประเภทของชีต
`hasHiddenGridlines()`	`Boolean`	แสดงผล `true` หากเส้นตารางของชีตซ่อนอยู่ หรือแสดงผล `false` ในกรณีอื่นๆ
`hideColumn(column)`	`void`	ซ่อนคอลัมน์ในช่วงที่ระบุ
`hideColumns(columnIndex)`	`void`	ซ่อนคอลัมน์เดียวที่ดัชนีที่ระบุ
`hideColumns(columnIndex, numColumns)`	`void`	ซ่อนคอลัมน์ติดต่อกันอย่างน้อย 1 คอลัมน์โดยเริ่มจากดัชนีที่ระบุ
`hideRow(row)`	`void`	ซ่อนแถวในช่วงที่ระบุ
`hideRows(rowIndex)`	`void`	ซ่อนแถวที่ดัชนีที่ระบุ
`hideRows(rowIndex, numRows)`	`void`	ซ่อนแถวติดต่อกันอย่างน้อย 1 แถวโดยเริ่มจากดัชนีที่ระบุ
`hideSheet()`	`Sheet`	ซ่อนชีตนี้
`insertChart(chart)`	`void`	เพิ่มแผนภูมิใหม่ลงในชีตนี้
`insertColumnAfter(afterPosition)`	`Sheet`	แทรกคอลัมน์หลังตำแหน่งคอลัมน์ที่ระบุ
`insertColumnBefore(beforePosition)`	`Sheet`	แทรกคอลัมน์ก่อนตำแหน่งคอลัมน์ที่ระบุ
`insertColumns(columnIndex)`	`void`	แทรกคอลัมน์ว่างในชีตที่ตำแหน่งที่ระบุ
`insertColumns(columnIndex, numColumns)`	`void`	แทรกคอลัมน์ว่างติดต่อกันอย่างน้อย 1 คอลัมน์ในชีตโดยเริ่มจากตำแหน่งที่ระบุ
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	แทรกคอลัมน์ตามจำนวนที่ระบุไว้หลังตําแหน่งคอลัมน์ที่ระบุ
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	แทรกจำนวนคอลัมน์ก่อนตำแหน่งคอลัมน์ที่ระบุ
`insertImage(blobSource, column, row)`	`OverGridImage`	แทรก `BlobSource` เป็นรูปภาพในเอกสารที่แถวและคอลัมน์ที่ระบุ
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	แทรก `BlobSource` เป็นรูปภาพในเอกสารที่แถวและคอลัมน์ที่ระบุ โดยมีค่าออฟเซตพิกเซล
`insertImage(url, column, row)`	`OverGridImage`	แทรกรูปภาพในเอกสารที่แถวและคอลัมน์ที่ระบุ
`insertImage(url, column, row, offsetX, offsetY)`	`OverGridImage`	แทรกรูปภาพในเอกสารที่แถวและคอลัมน์ที่ระบุ โดยมีค่าออฟเซ็ตพิกเซล
`insertRowAfter(afterPosition)`	`Sheet`	แทรกแถวหลังตําแหน่งแถวที่ระบุ
`insertRowBefore(beforePosition)`	`Sheet`	แทรกแถวก่อนตำแหน่งแถวที่ระบุ
`insertRows(rowIndex)`	`void`	แทรกแถวว่างในชีตที่ตำแหน่งที่ระบุ
`insertRows(rowIndex, numRows)`	`void`	แทรกแถวว่างติดต่อกันอย่างน้อย 1 แถวในชีตโดยเริ่มจากตำแหน่งที่ระบุ
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	แทรกแถวตามจำนวนที่ระบุไว้หลังตำแหน่งแถวที่ระบุ
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	แทรกแถวจำนวนหนึ่งก่อนตำแหน่งแถวที่ระบุ
`insertSlicer(range, anchorRowPos, anchorColPos)`	`Slicer`	เพิ่มตัวแบ่งส่วนข้อมูลใหม่ลงในชีตนี้
`insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)`	`Slicer`	เพิ่มตัวแบ่งส่วนข้อมูลใหม่ลงในชีตนี้
`isColumnHiddenByUser(columnPosition)`	`Boolean`	แสดงผลว่าผู้ใช้ซ่อนคอลัมน์ที่ระบุหรือไม่
`isRightToLeft()`	`Boolean`	แสดงผล `true` หากเลย์เอาต์ชีตนี้เป็นแบบจากขวาไปซ้าย
`isRowHiddenByFilter(rowPosition)`	`Boolean`	แสดงผลว่าตัวกรอง (ไม่ใช่มุมมองตัวกรอง) ซ่อนแถวที่ระบุหรือไม่
`isRowHiddenByUser(rowPosition)`	`Boolean`	แสดงผลว่าผู้ใช้ซ่อนแถวที่ระบุหรือไม่
`isSheetHidden()`	`Boolean`	แสดงผลเป็น `true` หากชีตซ่อนอยู่
`moveColumns(columnSpec, destinationIndex)`	`void`	ย้ายคอลัมน์ที่เลือกตามช่วงที่ระบุไปยังตำแหน่งที่ระบุด้วย `destinationIndex`
`moveRows(rowSpec, destinationIndex)`	`void`	ย้ายแถวที่เลือกตามช่วงที่กำหนดไปยังตำแหน่งที่ระบุโดย `destinationIndex`
`newChart()`	`EmbeddedChartBuilder`	แสดงผลเครื่องมือสร้างเพื่อสร้างแผนภูมิใหม่สำหรับชีตนี้
`protect()`	`Protection`	สร้างออบเจ็กต์ที่สามารถป้องกันไม่ให้ผู้ใช้ที่ไม่ได้รับอนุญาตแก้ไขชีตได้
`removeChart(chart)`	`void`	นำแผนภูมิออกจากชีตหลัก
`setActiveRange(range)`	`Range`	ตั้งค่าช่วงที่ระบุเป็น `active range` ในชีตที่ใช้งานอยู่ โดยมีเซลล์ซ้ายบนสุดของช่วงเป็น `current cell`
`setActiveRangeList(rangeList)`	`RangeList`	ตั้งค่ารายการช่วงที่ระบุเป็น `active ranges` ในชีตที่ใช้งานอยู่
`setActiveSelection(range)`	`Range`	กำหนดพื้นที่การเลือกที่ใช้งานอยู่สำหรับชีตนี้
`setActiveSelection(a1Notation)`	`Range`	ตั้งค่าการเลือกที่ใช้งานอยู่ตามที่ระบุไว้ในรูปแบบ A1 หรือ R1C1
`setColumnGroupControlPosition(position)`	`Sheet`	กำหนดตำแหน่งของปุ่มเปิด/ปิดการควบคุมกลุ่มคอลัมน์ในชีต
`setColumnWidth(columnPosition, width)`	`Sheet`	ตั้งค่าความกว้างของคอลัมน์ที่ระบุเป็นพิกเซล
`setColumnWidths(startColumn, numColumns, width)`	`Sheet`	ตั้งค่าความกว้างของคอลัมน์ที่ระบุเป็นพิกเซล
`setConditionalFormatRules(rules)`	`void`	แทนที่กฎการจัดรูปแบบตามเงื่อนไขทั้งหมดที่มีอยู่ในชีตด้วยกฎอินพุต
`setCurrentCell(cell)`	`Range`	ตั้งค่าเซลล์ที่ระบุเป็น `current cell`
`setFrozenColumns(columns)`	`void`	ตรึงคอลัมน์ตามจำนวนที่ระบุ
`setFrozenRows(rows)`	`void`	ตรึงแถวตามจำนวนที่ระบุ
`setHiddenGridlines(hideGridlines)`	`Sheet`	ซ่อนหรือแสดงเส้นตารางของชีต
`setName(name)`	`Sheet`	ตั้งชื่อชีต
`setRightToLeft(rightToLeft)`	`Sheet`	ตั้งค่าหรือยกเลิกการตั้งค่าเลย์เอาต์ชีตเป็นจากขวาไปซ้าย
`setRowGroupControlPosition(position)`	`Sheet`	ตั้งค่าตําแหน่งของปุ่มเปิด/ปิดการควบคุมกลุ่มแถวในสเปรดชีต
`setRowHeight(rowPosition, height)`	`Sheet`	ตั้งค่าความสูงของแถวที่ระบุเป็นพิกเซล
`setRowHeights(startRow, numRows, height)`	`Sheet`	ตั้งค่าความสูงของแถวที่ระบุเป็นพิกเซล
`setRowHeightsForced(startRow, numRows, height)`	`Sheet`	ตั้งค่าความสูงของแถวที่ระบุเป็นพิกเซล
`setTabColor(color)`	`Sheet`	ตั้งค่าสีแท็บชีต
`setTabColorObject(color)`	`Sheet`	ตั้งค่าสีแท็บชีต
`showColumns(columnIndex)`	`void`	เลิกซ่อนคอลัมน์ที่ดัชนีที่ระบุ
`showColumns(columnIndex, numColumns)`	`void`	เลิกซ่อนคอลัมน์ติดต่อกันอย่างน้อย 1 คอลัมน์โดยเริ่มจากดัชนีที่ระบุ
`showRows(rowIndex)`	`void`	เลิกซ่อนแถวที่ดัชนีที่ระบุ
`showRows(rowIndex, numRows)`	`void`	เลิกซ่อนแถวติดต่อกันอย่างน้อย 1 แถวโดยเริ่มจากดัชนีที่ระบุ
`showSheet()`	`Sheet`	แสดงชีต
`sort(columnPosition)`	`Sheet`	จัดเรียงชีตตามคอลัมน์จากน้อยไปมาก
`sort(columnPosition, ascending)`	`Sheet`	จัดเรียงชีตตามคอลัมน์
`unhideColumn(column)`	`void`	เลิกซ่อนคอลัมน์ในช่วงที่ระบุ
`unhideRow(row)`	`void`	เลิกซ่อนแถวในช่วงที่ระบุ
`updateChart(chart)`	`void`	อัปเดตแผนภูมิในชีตนี้

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getSheetProtection()`	`PageProtection`	แสดงผลอินสแตนซ์ `PageProtection` ที่อธิบายสิทธิ์สำหรับชีตปัจจุบัน
`getTabColor()`	`String`	รับสีแท็บชีต หรือ `null` หากแท็บชีตไม่มีสี
`setSheetProtection(permissions)`	`void`	ตั้งค่าสิทธิ์สำหรับชีตปัจจุบัน

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

`activate()`

เปิดใช้งานชีตนี้ ไม่ได้เปลี่ยนแปลงชีต แต่จะเปลี่ยนแปลงเฉพาะแนวคิดของชีตที่ใช้งานอยู่ของชีตหลัก

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.activate();

รีเทิร์น

Sheet — ชีตที่ใช้งานอยู่ใหม่

`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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'NAME' to the developer metadata for the sheet.
sheet.addDeveloperMetadata('NAME');

// Gets the updated metadata info and logs it to the console.
console.log(sheet.getDeveloperMetadata()[0].getKey());

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'NAME' and sets the developer metadata visibility to PROJECT
// for the sheet.
sheet.addDeveloperMetadata(
    'NAME',
    SpreadsheetApp.DeveloperMetadataVisibility.PROJECT,
);

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

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for
// the sheet.
sheet.addDeveloperMetadata('COMPANY', 'TECH');

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

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and
// sets the visibility to DOCUMENT for the sheet.
sheet.addDeveloperMetadata(
    'COMPANY',
    'TECH',
    SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT,
);

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

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`appendRow(rowContents)`

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

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

// Appends a new row with 3 columns to the bottom of the current
// data region in the sheet containing the values in the array.
sheet.appendRow(['a man', 'a plan', 'panama']);

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`asDataSourceSheet()`

แสดงผลชีตเป็น DataSourceSheet หากชีตเป็นประเภท SheetType.DATASOURCE หรือ null ในกรณีอื่นๆ

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the data source sheet value if the sheet is of type
// SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value.
const dataSourceSheet = sheet.asDataSourceSheet();

// Gets the data source sheet value and logs it to the console.
console.log(dataSourceSheet);
console.log(sheet.getType().toString());

รีเทิร์น

DataSourceSheet — ชีตแหล่งข้อมูล

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

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

`autoResizeColumn(columnPosition)`

ตั้งค่าความกว้างของคอลัมน์ที่ระบุให้พอดีกับเนื้อหา

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

sheet.getRange('a1').setValue(
    'Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnPosition`	`Integer`	ตำแหน่งของคอลัมน์ที่จะปรับขนาด

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`autoResizeColumns(startColumn, numColumns)`

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

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

// Sets the first 15 columns to a width that fits their text.
sheet.autoResizeColumns(1, 15);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`startColumn`	`Integer`	คอลัมน์เริ่มต้นที่จะปรับขนาดอัตโนมัติ
`numColumns`	`Integer`	จำนวนคอลัมน์ที่จะปรับขนาดอัตโนมัติ

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`autoResizeRows(startRow, numRows)`

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

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

// Sets the first 15 rows to a height that fits their text.
sheet.autoResizeRows(1, 15);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`startRow`	`Integer`	แถวเริ่มต้นที่จะปรับขนาดอัตโนมัติ
`numRows`	`Integer`	จำนวนแถวที่จะปรับขนาดอัตโนมัติ

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`clear()`

ล้างชีตเนื้อหาและข้อมูลการจัดรูปแบบ

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.clear();

รีเทิร์น

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

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

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

`clear(options)`

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
sheet.clear({formatOnly: true, contentsOnly: true});

พารามิเตอร์

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

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

ชื่อ	ประเภท	คำอธิบาย
`contentsOnly`	`Boolean`	ล้างเนื้อหาหรือไม่
`formatOnly`	`Boolean`	ล้างการจัดรูปแบบหรือไม่

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`clearConditionalFormatRules()`

นำกฎการจัดรูปแบบตามเงื่อนไขทั้งหมดออกจากชีต เทียบเท่ากับการเรียกใช้ setConditionalFormatRules(rules) ด้วยอาร์เรย์ว่างเป็นอินพุต

const sheet = SpreadsheetApp.getActiveSheet();
sheet.clearConditionalFormatRules();

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

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

`clearContents()`

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

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.clearContents();

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`clearFormats()`

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

การจัดรูปแบบหมายถึงการจัดรูปแบบข้อมูลตามที่ตัวเลือกในเมนู "รูปแบบ" อนุญาต (เช่น ตัวหนา ตัวเอียง การจัดรูปแบบตามเงื่อนไข) ไม่ใช่ความกว้างหรือความสูงของเซลล์

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.clearFormats();

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`clearNotes()`

ล้างชีตของโน้ตทั้งหมด

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.clearNotes();

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`collapseAllColumnGroups()`

ยุบกลุ่มคอลัมน์ทั้งหมดในชีต

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

// All column groups on the sheet are collapsed.
sheet.collapseAllColumnGroups();

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`collapseAllRowGroups()`

ยุบกลุ่มแถวทั้งหมดในชีต

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

// All row groups on the sheet are collapsed.
sheet.collapseAllRowGroups();

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`copyTo(spreadsheet)`

คัดลอกชีตไปยังสเปรดชีตที่ระบุ ซึ่งอาจเป็นสเปรดชีตเดียวกับแหล่งที่มาก็ได้ แผ่นงานที่คัดลอกจะมีชื่อว่า "สําเนาของ [ชื่อเดิม]"

const source = SpreadsheetApp.getActiveSpreadsheet();
const sheet = source.getSheets()[0];

const destination = SpreadsheetApp.openById('ID_GOES HERE');
sheet.copyTo(destination);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`spreadsheet`	`Spreadsheet`	สเปรดชีตที่จะคัดลอกชีตนี้ไป ซึ่งอาจเป็นสเปรดชีตเดียวกับแหล่งที่มาก็ได้

รีเทิร์น

Sheet — ชีตใหม่สําหรับการต่อเชื่อม

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

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

`createDeveloperMetadataFinder()`

แสดงผล DeveloperMetadataFinder สำหรับการค้นหาข้อมูลเมตาของนักพัฒนาแอปภายในขอบเขตของชีตนี้ ข้อมูลเมตาจะอยู่ภายในขอบเขตของสเปรดชีตหนึ่งๆ หากเชื่อมโยงกับสเปรดชีตนั้นเอง หรือเชื่อมโยงกับแถว คอลัมน์ หรือช่วงในสเปรดชีตนั้น

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Creates the developer metadata finder.
const metadatafinder = sheet.createDeveloperMetadataFinder();

// Finds the metadata with value 'PARIS' and displays its key in the console.
console.log(metadatafinder.withValue('PARIS').find()[0].getKey());

รีเทิร์น

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

`createTextFinder(findText)`

สร้างเครื่องมือค้นหาข้อความสำหรับชีต ซึ่งสามารถค้นหาและแทนที่ข้อความภายในชีตได้

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

// Creates  a text finder.
const textFinder = sheet.createTextFinder('dog');

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

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

พารามิเตอร์

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

รีเทิร์น

TextFinder — TextFinder ของชีต

`deleteColumn(columnPosition)`

ลบคอลัมน์ในตำแหน่งคอลัมน์ที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first column
sheet.deleteColumn(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnPosition`	`Integer`	ตำแหน่งของคอลัมน์ โดยเริ่มจาก 1 สำหรับคอลัมน์แรก

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`deleteColumns(columnPosition, howMany)`

ลบจำนวนคอลัมน์โดยเริ่มจากตำแหน่งคอลัมน์ที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first two columns
sheet.deleteColumns(1, 2);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnPosition`	`Integer`	ตำแหน่งของคอลัมน์แรกที่จะลบ
`howMany`	`Integer`	จํานวนคอลัมน์ที่จะลบ

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

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

`deleteRow(rowPosition)`

ลบแถวในตําแหน่งแถวที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowPosition`	`Integer`	ตำแหน่งของแถว โดยเริ่มจาก 1 สำหรับแถวแรก

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`deleteRows(rowPosition, howMany)`

ลบจำนวนแถวที่เริ่มต้นจากตําแหน่งของแถวที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first two rows
sheet.deleteRows(1, 2);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowPosition`	`Integer`	ตำแหน่งของแถวแรกที่จะลบ
`howMany`	`Integer`	จํานวนแถวที่จะลบ

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

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

`expandAllColumnGroups()`

ขยายกลุ่มคอลัมน์ทั้งหมดในชีต วิธีนี้ต้องมีกลุ่มคอลัมน์อย่างน้อย 1 กลุ่ม

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

// All column groups on the sheet are expanded.
sheet.expandAllColumnGroups();

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`expandAllRowGroups()`

ขยายกลุ่มแถวทั้งหมดในชีต วิธีนี้ต้องมีกลุ่มแถวอย่างน้อย 1 กลุ่ม

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

// All row groups on the sheet are expanded.
sheet.expandAllRowGroups();

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`expandColumnGroupsUpToDepth(groupDepth)`

ขยายกลุ่มคอลัมน์ทั้งหมดจนถึงระดับความลึกที่กำหนด และยุบกลุ่มอื่นๆ ทั้งหมด

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

// All column groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandColumnGroupsUpToDepth(2);

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`expandRowGroupsUpToDepth(groupDepth)`

ขยายกลุ่มแถวทั้งหมดจนถึงระดับความลึกที่กำหนด และยุบกลุ่มอื่นๆ ทั้งหมด

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

// All row groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandRowGroupsUpToDepth(2);

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`getActiveCell()`

แสดงผลเซลล์ที่ใช้งานอยู่ในชีตนี้

หมายเหตุ: เราขอแนะนำให้ใช้ getCurrentCell() ซึ่งจะแสดงผลเซลล์ที่ไฮไลต์อยู่ในปัจจุบัน

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Returns the active cell
const cell = sheet.getActiveCell();

รีเทิร์น

Range — เซลล์ที่ใช้งานอยู่ในปัจจุบัน

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

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

`getActiveRange()`

แสดงผลช่วงที่คุณเลือกในสเปรดชีตที่ใช้งานอยู่ หรือ null หากไม่มีช่วงทำงานอยู่ หากเลือกหลายช่วง วิธีการนี้จะแสดงเฉพาะช่วงล่าสุดที่เลือก

คําว่า "ช่วงที่มีการใช้งาน" หมายถึงช่วงที่ผู้ใช้เลือกไว้ในชีตที่ใช้งานอยู่ แต่ในฟังก์ชันที่กําหนดเองจะหมายถึงเซลล์ที่กําลังคํานวณใหม่

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const activeRange = sheet.getActiveRange();

รีเทิร์น

Range — ช่วงที่มีการใช้งาน

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

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

ดูเพิ่มเติม

setActiveRange(range)

`getActiveRangeList()`

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

หากเลือกช่วงเดียว การดำเนินการนี้จะทํางานแบบการเรียก getActiveRange()

const sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
const activeRangeList = sheet.getActiveRangeList();

รีเทิร์น

RangeList — รายการช่วงที่มีการใช้งาน

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

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

ดูเพิ่มเติม

setActiveRangeList(rangeList)

`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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Gets info on the bandings' second row color and logs it to the console.
for (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

รีเทิร์น

Banding[] — แถบทั้งหมดในชีตนี้

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

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

`getCharts()`

แสดงผลอาร์เรย์ของแผนภูมิในชีตนี้

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const charts = sheet.getCharts();

for (const i in charts) {
  const chart = charts[i];
  // Do something with the chart
}

รีเทิร์น

EmbeddedChart[] — อาร์เรย์ของแผนภูมิ

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

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

`getColumnGroup(columnIndex, groupDepth)`

แสดงผลกลุ่มคอลัมน์ที่ดัชนีและความลึกของกลุ่มที่ระบุ

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

// Returns the group whose control index is at column 2 and has a depth of 1, or
// null if the group doesn’t exist.
const columnGroup = sheet.getColumnGroup(2, 1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnIndex`	`Integer`	ดัชนีคอลัมน์ของปุ่มเปิด/ปิดการควบคุมกลุ่มหรือดัชนีภายในกลุ่ม
`groupDepth`	`Integer`	ความลึกของกลุ่ม

รีเทิร์น

Group — กลุ่มคอลัมน์ที่ดัชนีและความลึกของกลุ่มควบคุม หรือจะแสดงข้อยกเว้นหากกลุ่มนั้นไม่อยู่

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

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

`getColumnGroupControlPosition()`

แสดงผล GroupControlTogglePosition สำหรับกลุ่มคอลัมน์ทั้งหมดในชีต

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

// GroupControlTogglePosition.AFTER if the column grouping control toggle is
// shown after the group.
const columnGroupControlPosition = sheet.getColumnGroupControlPosition();

รีเทิร์น

GroupControlTogglePosition — true หากปุ่มเปิด/ปิดการควบคุมการจัดกลุ่มคอลัมน์แสดงอยู่หลังกลุ่มในสเปรดชีตนี้ และ false หากไม่เป็นเช่นนั้น

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

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

`getColumnGroupDepth(columnIndex)`

แสดงผลระดับกลุ่มของคอลัมน์ที่ดัชนีที่ระบุ

ความลึกของกลุ่มจะระบุจํานวนกลุ่มที่ซ้อนทับกับคอลัมน์ ซึ่งมีค่าได้ตั้งแต่ 0 ถึง 8

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

// 1 if there is a group over columns 1 through 3
const groupDepth = sheet.getColumnGroupDepth(1);

พารามิเตอร์

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

รีเทิร์น

Integer — ความลึกของกลุ่มของคอลัมน์ที่ดัชนีที่ระบุ

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

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

`getColumnWidth(columnPosition)`

รับความกว้างเป็นพิกเซลของคอลัมน์ที่ระบุ

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

// Columns start at 1
Logger.log(sheet.getColumnWidth(1));

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnPosition`	`Integer`	ตําแหน่งของคอลัมน์ที่จะตรวจสอบ

รีเทิร์น

Integer — ความกว้างของคอลัมน์เป็นพิกเซล

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

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

`getConditionalFormatRules()`

ดูกฎการจัดรูปแบบตามเงื่อนไขทั้งหมดในชีตนี้

// Logs the conditional format rules in a sheet.
const rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules();
for (let i = 0; i < rules.length; i++) {
  const rule = rules[i];
  Logger.log(rule);
}

รีเทิร์น

ConditionalFormatRule[] — อาร์เรย์ของกฎทั้งหมดในสเปรดชีต

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

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

`getCurrentCell()`

แสดงผลเซลล์ปัจจุบันในสเปรดชีตที่ใช้งานอยู่ หรือ null หากไม่มีเซลล์ปัจจุบัน เซลล์ปัจจุบันคือเซลล์ที่มีโฟกัสใน UI ของ Google ชีต และไฮไลต์ด้วยเส้นขอบสีเข้ม เซลล์ปัจจุบันจะมีได้ไม่เกิน 1 เซลล์ เมื่อผู้ใช้เลือกช่วงเซลล์อย่างน้อย 1 ช่วง เซลล์ใดเซลล์หนึ่งในส่วนที่เลือกจะเป็นเซลล์ปัจจุบัน

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// Returns the current highlighted cell in the one of the active ranges.
const currentCell = sheet.getCurrentCell();

รีเทิร์น

Range — เซลล์ปัจจุบัน

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

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

`getDataRange()`

แสดงผล Range ที่สอดคล้องกับมิติข้อมูลที่มีข้อมูลอยู่

ซึ่งเทียบเท่ากับการสร้างช่วงที่ถูกจำกัดด้วย A1 และ (Sheet.getLastColumn(), Sheet.getLastRow())

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

// This represents ALL the data
const range = sheet.getDataRange();
const values = range.getValues();

// This logs the spreadsheet in CSV format with a trailing comma
for (let i = 0; i < values.length; i++) {
  let row = '';
  for (let j = 0; j < values[i].length; j++) {
    if (values[i][j]) {
      row = row + values[i][j];
    }
    row = `${row},`;
  }
  Logger.log(row);
}

รีเทิร์น

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

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

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

`getDataSourceFormulas()`

รับสูตรแหล่งข้อมูลทั้งหมด

// Opens the spreadsheet by its ID. If you created your script from within 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 an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

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

รีเทิร์น

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 an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.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 an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

รีเทิร์น

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

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

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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Gets all the developer metadata for the sheet.
const developerMetaDataList = sheet.getDeveloperMetadata();

// Logs the developer metadata to the console.
for (const developerMetaData of developerMetaDataList) {
  console.log(developerMetaData.getKey());
}

รีเทิร์น

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

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

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

`getDrawings()`

แสดงผลอาร์เรย์ของภาพวาดในชีต

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the drawings from the sheet.
const allDrawings = sheet.getDrawings();

// Logs the number of drawings present on the sheet.
console.log(allDrawings.length);

รีเทิร์น

Drawing[] — รายการภาพวาดในชีตนี้

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

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

`getFilter()`

แสดงฟิลเตอร์ในสเปรดชีตนี้ หรือ null หากไม่มีตัวกรอง

// Gets the filter on the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();

รีเทิร์น

Filter — ตัวกรอง

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

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

`getFormUrl()`

แสดงผล URL ของแบบฟอร์มที่ส่งคําตอบไปยังชีตนี้ หรือ null หากชีตนี้ไม่มีแบบฟอร์มที่เชื่อมโยง แสดงข้อยกเว้นหากผู้ใช้ไม่มีสิทธิ์แก้ไขสเปรดชีต

const sheet = SpreadsheetApp.getActiveSheet();
const url = sheet.getFormUrl();

รีเทิร์น

String — URL ของแบบฟอร์มที่วางคําตอบไว้ในชีตนี้ หรือ null หากชีตนี้ไม่มีแบบฟอร์มที่เชื่อมโยง

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

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

`getFrozenColumns()`

แสดงผลจํานวนคอลัมน์ที่ตรึงไว้

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

Logger.log('Number of frozen columns: %s', sheet.getFrozenColumns());

รีเทิร์น

Integer — จํานวนคอลัมน์ที่ตรึง

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

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

`getFrozenRows()`

แสดงผลจํานวนแถวที่ตรึงไว้

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

Logger.log('Number of frozen rows: %s', sheet.getFrozenRows());

รีเทิร์น

Integer — จํานวนแถวที่ตรึงไว้

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

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

`getImages()`

แสดงผลรูปภาพที่วางทับบนตารางกริดทั้งหมดในชีต

// Opens the spreadsheet file 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 over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use
// ss.getImages() instead.
const images = sheet.getImages();

// For each image, logs the anchor cell in A1 notation.
for (const image of images) {
  console.log(image.getAnchorCell().getA1Notation());
}

รีเทิร์น

OverGridImage[] — อาร์เรย์ของรูปภาพที่วางทับบนตาราง

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

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

`getIndex()`

รับตําแหน่งของชีตในสเปรดชีตหลัก เริ่มต้นที่ 1

const ss = SpreadsheetApp.getActiveSpreadsheet();
// Note that the JavaScript index is 0, but this logs 1
const sheet = ss.getSheets()[0];
// ... because spreadsheets are 1-indexed
Logger.log(sheet.getIndex());

รีเทิร์น

Integer — ตำแหน่งของชีตในสเปรดชีตหลัก

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

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

`getLastColumn()`

แสดงผลตําแหน่งคอลัมน์สุดท้ายที่มีเนื้อหา

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

// This logs the value in the very last cell of this sheet
const lastRow = sheet.getLastRow();
const lastColumn = sheet.getLastColumn();
const lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

รีเทิร์น

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

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

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

`getLastRow()`

แสดงตำแหน่งของแถวสุดท้ายที่มีเนื้อหา

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

// This logs the value in the very last cell of this sheet
const lastRow = sheet.getLastRow();
const lastColumn = sheet.getLastColumn();
const lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

รีเทิร์น

Integer — แถวสุดท้ายของสเปรดชีตที่มีเนื้อหา

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

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

`getMaxColumns()`

แสดงผลจํานวนคอลัมน์ปัจจุบันในชีต โดยไม่คำนึงถึงเนื้อหา

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
Logger.log(first.getMaxColumns());

รีเทิร์น

Integer — ความกว้างสูงสุดของชีต

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

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

`getMaxRows()`

แสดงผลจํานวนแถวปัจจุบันในชีต โดยไม่คำนึงถึงเนื้อหา

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
Logger.log(first.getMaxRows());

รีเทิร์น

Integer — ความสูงสูงสุดของชีต

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

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

`getName()`

แสดงผลชื่อชีต

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
Logger.log(sheet.getName());

รีเทิร์น

String — ชื่อชีต

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

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

`getNamedRanges()`

รับช่วงที่มีชื่อทั้งหมดในสเปรดชีตนี้

// The code below logs the name of the first named range.
const namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges();
if (namedRanges.length > 1) {
  Logger.log(namedRanges[0].getName());
}

รีเทิร์น

NamedRange[] — อาร์เรย์ของช่วงที่มีชื่อทั้งหมดในชีต

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

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

`getParent()`

แสดงผล Spreadsheet ที่มีชีตนี้

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// parent is identical to ss
const parent = sheet.getParent();

รีเทิร์น

Spreadsheet — สเปรดชีตหลัก

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

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

`getPivotTables()`

แสดงตาราง Pivot ทั้งหมดในชีตนี้

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the pivot table info for the sheet.
const pivotTables = sheet.getPivotTables();

// Logs the pivot tables to the console.
for (const pivotTable of pivotTables) {
  console.log(pivotTable.getSourceDataRange().getValues());
}

รีเทิร์น

PivotTable[] — ตาราง Pivot ในชีตนี้

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

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

`getProtections(type)`

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

// Remove all range protections in the spreadsheet that the user has permission
// to edit.
const sheet = SpreadsheetApp.getActiveSheet();
const protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (let i = 0; i < protections.length; i++) {
  const protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Remove sheet protection from the active sheet, if the user has permission to
// edit it.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
if (protection?.canEdit()) {
  protection.remove();
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`type`	`ProtectionType`	ประเภทพื้นที่คุ้มครอง `SpreadsheetApp.ProtectionType.RANGE` หรือ `SpreadsheetApp.ProtectionType.SHEET`

รีเทิร์น

Protection[] — อาร์เรย์ของออบเจ็กต์ที่แสดงถึงช่วงที่ป้องกันทั้งหมดในชีต หรืออาร์เรย์องค์ประกอบเดียวที่แสดงถึงการป้องกันในชีต

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

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

`getRange(row, column)`

แสดงผลช่วงที่มีเซลล์ซ้ายบนสุดที่พิกัดที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Passing only two arguments returns a "range" with a single cell.
const range = sheet.getRange(1, 1);
const values = range.getValues();
Logger.log(values[0][0]);

พารามิเตอร์

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

รีเทิร์น

Range — ช่วงที่มีเฉพาะเซลล์นี้

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

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

`getRange(row, column, numRows)`

แสดงผลช่วงที่มีเซลล์ซ้ายบนที่พิกัดที่ระบุ และมีจำนวนแถวที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// When the "numRows" argument is used, only a single column of data is
// returned.
const range = sheet.getRange(1, 1, 3);
const values = range.getValues();

// Prints 3 values from the first column, starting from row 1.
for (const row in values) {
  for (const col in values[row]) {
    Logger.log(values[row][col]);
  }
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`row`	`Integer`	ดัชนีแถวเริ่มต้นของช่วง โดยระบบจะเริ่มต้นการระบุดัชนีแถวที่ 1
`column`	`Integer`	ดัชนีคอลัมน์ของช่วง โดยระบบจะเริ่มต้นดัชนีคอลัมน์ที่ 1
`numRows`	`Integer`	จำนวนแถวที่จะแสดงผล

รีเทิร์น

Range — ช่วงที่มีคอลัมน์ข้อมูลเดียวซึ่งมีจำนวนแถวที่ระบุ

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

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

`getRange(row, column, numRows, numColumns)`

แสดงผลช่วงที่มีเซลล์ซ้ายบนที่พิกัดที่ระบุซึ่งมีจํานวนแถวและคอลัมน์ที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange(1, 1, 3, 3);
const values = range.getValues();

// Print values from a 3x3 box.
for (const row in values) {
  for (const col in values[row]) {
    Logger.log(values[row][col]);
  }
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`row`	`Integer`	ดัชนีแถวเริ่มต้นของช่วง โดยระบบจะเริ่มต้นการระบุดัชนีแถวที่ 1
`column`	`Integer`	ดัชนีคอลัมน์เริ่มต้นของช่วง โดยระบบจะเริ่มต้นดัชนีคอลัมน์ที่ 1
`numRows`	`Integer`	จำนวนแถวที่จะแสดงผล
`numColumns`	`Integer`	จำนวนคอลัมน์ที่จะแสดงผล

รีเทิร์น

Range — ช่วงที่เกี่ยวข้องกับพื้นที่ที่ระบุ

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

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

`getRange(a1Notation)`

แสดงผลช่วงตามที่ระบุไว้ในรูปแบบ A1 หรือ R1C1

// Get a range A1:D4 on sheet titled "Invoices"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange('Invoices!A1:D4');

// Get cell A1 on the first sheet
const sheet = ss.getSheets()[0];
const cell = sheet.getRange('A1');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`a1Notation`	`String`	ช่วงที่จะแสดงผลตามที่ระบุไว้ในรูปแบบ A1 หรือ R1C1

รีเทิร์น

Range — ช่วงของระดับที่สถานที่ที่ระบุ

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

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

`getRangeList(a1Notations)`

แสดงผลคอลเล็กชัน RangeList ที่แสดงถึงช่วงในสเปรดชีตเดียวกันที่ระบุโดยรายการการเขียน A1 หรือการเขียน R1C1 ที่ไม่ใช่ค่าว่าง

// Get a list of ranges A1:D4, F1:H4.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`a1Notations`	`String[]`	รายการช่วงที่จะแสดงผลตามที่ระบุไว้ในรูปแบบ A1 หรือ R1C1

รีเทิร์น

RangeList — รายการช่วงของตำแหน่งที่ระบุ

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

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

`getRowGroup(rowIndex, groupDepth)`

แสดงผลกลุ่มแถวที่ดัชนีและความลึกของกลุ่มที่ระบุ

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

// Returns the group whose control index is at row 2 and has a depth of 1, or
// null if the group doesn’t exist.
const rowGroup = sheet.getRowGroup(2, 1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowIndex`	`Integer`	ดัชนีแถวของปุ่มเปิด/ปิดการควบคุมกลุ่มหรือดัชนีภายในกลุ่ม
`groupDepth`	`Integer`	ความลึกของกลุ่ม

รีเทิร์น

Group — กลุ่มแถวที่ดัชนีและความลึกของกลุ่มควบคุม หรือจะแสดงข้อยกเว้นหากกลุ่มนั้นไม่อยู่

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

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

`getRowGroupControlPosition()`

แสดงผล GroupControlTogglePosition สำหรับกลุ่มแถวทั้งหมดในชีต

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

// GroupControlTogglePosition.AFTER if the row grouping control toggle is shown
// after the group.
const rowGroupControlPosition = sheet.getRowGroupControlPosition();

รีเทิร์น

GroupControlTogglePosition — true หากปุ่มเปิด/ปิดการควบคุมการจัดกลุ่มแถวแสดงอยู่หลังกลุ่มในสเปรดชีตนี้ และ false หากไม่เป็นเช่นนั้น

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

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

`getRowGroupDepth(rowIndex)`

แสดงผลระดับกลุ่มของแถวที่ดัชนีที่ระบุ

ความลึกของกลุ่มระบุจํานวนกลุ่มที่ทับซ้อนกับแถว ซึ่งมีค่าได้ตั้งแต่ 0 ถึง 8

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

// 1 if there is a group over rows 1 through 3
const groupDepth = sheet.getRowGroupDepth(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowIndex`	`Integer`	ดัชนีของแถว

รีเทิร์น

Integer — ความลึกของกลุ่มของแถวที่ดัชนีที่ระบุ

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

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

`getRowHeight(rowPosition)`

รับความสูงเป็นพิกเซลของแถวที่ระบุ

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

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowPosition`	`Integer`	ตําแหน่งของแถวที่จะตรวจสอบ

รีเทิร์น

Integer — ความสูงของแถวเป็นพิกเซล

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

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

`getSelection()`

แสดงผล Selection ปัจจุบันในสเปรดชีต

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const currentCell = selection.getCurrentCell();

รีเทิร์น

Selection — รายการที่เลือกอยู่

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

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

`getSheetId()`

แสดงผลรหัสชีตที่แสดงโดยออบเจ็กต์นี้

รหัสนี้สำหรับชีตที่ไม่ซ้ำกันของสเปรดชีต รหัสคือจำนวนเต็มที่เพิ่มขึ้นแบบเชิงเดี่ยวที่กำหนดไว้ ณ เวลาที่สร้างชีต ซึ่งไม่ขึ้นอยู่กับตำแหน่งของชีต ซึ่งมีประโยชน์เมื่อใช้ร่วมกับเมธอด เช่น Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) ที่ใช้พารามิเตอร์ gridId แทนอินสแตนซ์ Sheet

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

Logger.log(sheet.getSheetId());

รีเทิร์น

Integer — รหัสของชีตที่ไม่ซ้ำกันสำหรับสเปรดชีต

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

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

`getSheetName()`

แสดงผลชื่อชีต

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

Logger.log(sheet.getSheetName());

รีเทิร์น

String — ชื่อชีต

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

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

`getSheetValues(startRow, startColumn, numRows, numColumns)`

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

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

// The two samples below produce the same output
let values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

const range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`startRow`	`Integer`	ตำแหน่งของแถวเริ่มต้น
`startColumn`	`Integer`	ตำแหน่งของคอลัมน์เริ่มต้น
`numRows`	`Integer`	จำนวนแถวที่จะแสดงค่า
`numColumns`	`Integer`	จำนวนคอลัมน์ที่จะแสดงผลค่า

รีเทิร์น

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

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

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

`getSlicers()`

แสดงผลอาร์เรย์ของเครื่องมือเลือกข้อมูลในชีต

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all slicers in the spreadsheet.
const slicers = sheet.getSlicers();

// Logs the slicer titles to the console.
for (const slicer of slicers) {
  console.log(slicer.getTitle());
}

รีเทิร์น

Slicer[] — รายการตัวแบ่งส่วนในชีตนี้

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

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

`getTabColorObject()`

รับสีแท็บชีต หรือ null หากแท็บชีตไม่มีสี

// This example assumes there is a sheet named "Sheet1"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('Sheet1');
const color = first.getTabColorObject();

รีเทิร์น

Color — สีของแท็บชีต หรือ null หากแท็บชีตไม่มีสี

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

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

`getType()`

แสดงผลประเภทของชีต

ชีตประเภทเริ่มต้นคือ SheetType.GRID ชีตที่มีออบเจ็กต์ที่ฝังอยู่รายการเดียว เช่น EmbeddedChart คือชีต SheetType.OBJECT

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
Logger.log(sheet.getType());

รีเทิร์น

SheetType — ประเภทชีต

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

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

`hasHiddenGridlines()`

แสดงผล true หากเส้นตารางของชีตซ่อนอยู่ หรือแสดงผล 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if the spreadsheet has hidden gridelines and logs the result to the
// console.
console.log(sheet.hasHiddenGridlines());

รีเทิร์น

Boolean — true หากเส้นตารางซ่อนอยู่ และ false ในกรณีอื่นๆ

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

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

`hideColumn(column)`

ซ่อนคอลัมน์ในช่วงที่ระบุ

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

// This hides the first column
let range = sheet.getRange('A1');
sheet.hideColumn(range);

// This hides the first 3 columns
range = sheet.getRange('A:C');
sheet.hideColumn(range);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`column`	`Range`	ช่วงของคอลัมน์ที่จะซ่อน

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

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

`hideColumns(columnIndex)`

ซ่อนคอลัมน์เดียวที่ดัชนีที่ระบุ ใช้การนับ 1 ฐานสําหรับวิธีการนี้

หากต้องการซ่อนมากกว่า 1 คอลัมน์โดยใช้ดัชนี ให้ใช้ hideColumns(columnIndex, numColumns)

หากต้องการซ่อนมากกว่า 1 คอลัมน์โดยใช้ช่วง ให้ใช้ hideColumn()

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Hides the first column
sheet.hideColumns(1);

พารามิเตอร์

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

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

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

`hideColumns(columnIndex, numColumns)`

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Hides the first three columns
sheet.hideColumns(1, 3);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnIndex`	`Integer`	ดัชนีเริ่มต้นของคอลัมน์ที่จะซ่อน
`numColumns`	`Integer`	จํานวนคอลัมน์ที่จะซ่อน

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

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

`hideRow(row)`

ซ่อนแถวในช่วงที่ระบุ

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

// This hides the first row
const range = sheet.getRange('A1');
sheet.hideRow(range);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`row`	`Range`	ช่วงแถวที่จะซ่อน

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

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

`hideRows(rowIndex)`

ซ่อนแถวที่ดัชนีที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Hides the first row
sheet.hideRows(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowIndex`	`Integer`	ดัชนีของแถวที่จะซ่อน

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

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

`hideRows(rowIndex, numRows)`

ซ่อนแถวติดต่อกันอย่างน้อย 1 แถวโดยเริ่มจากดัชนีที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Hides the first three rows
sheet.hideRows(1, 3);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowIndex`	`Integer`	ดัชนีเริ่มต้นของแถวที่จะซ่อน
`numRows`	`Integer`	จํานวนแถวที่จะซ่อน

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

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

`hideSheet()`

ซ่อนชีตนี้ จะไม่มีผลหากชีตซ่อนอยู่ หากเรียกใช้เมธอดนี้ในชีตที่มองเห็นได้เพียงชีตเดียว ระบบจะแสดงข้อยกเว้น

const sheet = SpreadsheetApp.getActiveSheet();
sheet.hideSheet();

รีเทิร์น

Sheet — ชีตปัจจุบัน

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

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

`insertChart(chart)`

เพิ่มแผนภูมิใหม่ลงในชีตนี้

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

// This creates a simple bar chart from the first three rows
// of the first two columns of the spreadsheet
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B4'))
                  .setPosition(5, 5, 0, 0)
                  .setOption('title', 'Dynamic Chart')
                  .build();
sheet.insertChart(chart);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`chart`	`EmbeddedChart`	แผนภูมิที่จะแทรก

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

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

`insertColumnAfter(afterPosition)`

แทรกคอลัมน์หลังตำแหน่งคอลัมน์ที่ระบุ

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

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`afterPosition`	`Integer`	คอลัมน์ที่ควรเพิ่มคอลัมน์ใหม่ต่อจากนี้

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`insertColumnBefore(beforePosition)`

แทรกคอลัมน์ก่อนตำแหน่งคอลัมน์ที่ระบุ

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

// This inserts a column in the first column position
sheet.insertColumnBefore(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`beforePosition`	`Integer`	คอลัมน์ที่ควรเพิ่มคอลัมน์ใหม่ก่อน

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`insertColumns(columnIndex)`

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Shifts all columns by one
sheet.insertColumns(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnIndex`	`Integer`	ดัชนีที่ระบุตำแหน่งที่จะแทรกคอลัมน์

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

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

`insertColumns(columnIndex, numColumns)`

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Shifts all columns by three
sheet.insertColumns(1, 3);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnIndex`	`Integer`	ดัชนีที่ระบุตำแหน่งที่จะแทรกคอลัมน์
`numColumns`	`Integer`	จํานวนคอลัมน์ที่จะแทรก

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

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

`insertColumnsAfter(afterPosition, howMany)`

แทรกคอลัมน์ตามจำนวนที่ระบุไว้หลังตําแหน่งคอลัมน์ที่ระบุ

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

// Inserts two columns after the first column on the first sheet of the
// spreadsheet.
sheet.insertColumnsAfter(1, 2);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`afterPosition`	`Integer`	คอลัมน์ที่ควรเพิ่มคอลัมน์ใหม่ต่อจากนี้
`howMany`	`Integer`	จํานวนคอลัมน์ที่จะแทรก

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`insertColumnsBefore(beforePosition, howMany)`

แทรกจำนวนคอลัมน์ก่อนตำแหน่งคอลัมน์ที่ระบุ

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

// This inserts five columns before the first column
sheet.insertColumnsBefore(1, 5);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`beforePosition`	`Integer`	คอลัมน์ที่ควรเพิ่มคอลัมน์ใหม่ก่อน
`howMany`	`Integer`	จํานวนคอลัมน์ที่จะแทรก

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`insertImage(blobSource, column, row)`

แทรก BlobSource เป็นรูปภาพในเอกสารที่แถวและคอลัมน์ที่ระบุ ระบบจะดึงขนาดรูปภาพจากเนื้อหา Blob ขนาด BLOB สูงสุดที่รองรับคือ 2 MB

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

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`blobSource`	`BlobSource`	Blob ที่มีเนื้อหารูปภาพ ประเภท MIME และชื่อ (ไม่บังคับ)
`column`	`Integer`	ตำแหน่งคอลัมน์
`row`	`Integer`	ตำแหน่งแถว

รีเทิร์น

OverGridImage — รูปภาพที่แทรก

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

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

`insertImage(blobSource, column, row, offsetX, offsetY)`

แทรก BlobSource เป็นรูปภาพในเอกสารที่แถวและคอลัมน์ที่ระบุ โดยมีค่าออฟเซตพิกเซล ระบบจะดึงข้อมูลขนาดรูปภาพจากเนื้อหา Blob ขนาดของ BLOB สูงสุดที่รองรับคือ 2 MB

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

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`blobSource`	`BlobSource`	Blob ที่มีเนื้อหารูปภาพ ประเภท MIME และชื่อ (ไม่บังคับ)
`column`	`Integer`	ตำแหน่งคอลัมน์
`row`	`Integer`	ตำแหน่งแถว
`offsetX`	`Integer`	การเลื่อนแนวนอนจากมุมเซลล์เป็นพิกเซล
`offsetY`	`Integer`	การเลื่อนแนวตั้งจากมุมเซลล์เป็นพิกเซล

รีเทิร์น

OverGridImage — รูปภาพที่แทรก

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

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

`insertImage(url, column, row)`

แทรกรูปภาพในเอกสารที่แถวและคอลัมน์ที่ระบุ

URL ที่ระบุต้องเข้าถึงได้แบบสาธารณะ

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

sheet.insertImage('https://www.google.com/images/srpr/logo3w.png', 1, 1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`url`	`String`	URL ของรูปภาพ
`column`	`Integer`	ตำแหน่งคอลัมน์ตารางกริด
`row`	`Integer`	ตำแหน่งแถวตารางกริด

รีเทิร์น

OverGridImage — รูปภาพที่แทรก

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

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

`insertImage(url, column, row, offsetX, offsetY)`

แทรกรูปภาพในเอกสารที่แถวและคอลัมน์ที่ระบุ โดยมีค่าออฟเซ็ตพิกเซล

URL ที่ระบุต้องเข้าถึงได้แบบสาธารณะ

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

sheet.insertImage(
    'https://www.google.com/images/srpr/logo3w.png',
    1,
    1,
    10,
    10,
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`url`	`String`	URL ของรูปภาพ
`column`	`Integer`	ตำแหน่งคอลัมน์
`row`	`Integer`	ตำแหน่งแถว
`offsetX`	`Integer`	การเลื่อนแนวนอนจากมุมเซลล์เป็นพิกเซล
`offsetY`	`Integer`	การเลื่อนแนวตั้งจากมุมเซลล์เป็นพิกเซล

รีเทิร์น

OverGridImage — รูปภาพที่แทรก

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

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

`insertRowAfter(afterPosition)`

แทรกแถวหลังตําแหน่งแถวที่ระบุ

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

// This inserts a row after the first row position
sheet.insertRowAfter(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`afterPosition`	`Integer`	แถวที่ควรเพิ่มแถวใหม่ต่อจากนี้

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`insertRowBefore(beforePosition)`

แทรกแถวก่อนตำแหน่งแถวที่ระบุ

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

// This inserts a row before the first row position
sheet.insertRowBefore(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`beforePosition`	`Integer`	แถวก่อนหน้าที่ควรเพิ่มแถวใหม่

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`insertRows(rowIndex)`

แทรกแถวว่างในชีตที่ตำแหน่งที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Shifts all rows down by one
sheet.insertRows(1);

พารามิเตอร์

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

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

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

`insertRows(rowIndex, numRows)`

แทรกแถวว่างติดต่อกันอย่างน้อย 1 แถวในชีตโดยเริ่มจากตำแหน่งที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Shifts all rows down by three
sheet.insertRows(1, 3);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowIndex`	`Integer`	ดัชนีที่ระบุตำแหน่งที่จะแทรกแถว
`numRows`	`Integer`	จํานวนแถวที่จะแทรก

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

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

`insertRowsAfter(afterPosition, howMany)`

แทรกแถวตามจำนวนที่ระบุไว้หลังตำแหน่งแถวที่ระบุ

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

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`afterPosition`	`Integer`	แถวที่ควรเพิ่มแถวใหม่ต่อจากนี้
`howMany`	`Integer`	จํานวนแถวที่จะแทรก

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`insertRowsBefore(beforePosition, howMany)`

แทรกแถวจำนวนหนึ่งก่อนตำแหน่งแถวที่ระบุ

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

// This inserts five rows before the first row
sheet.insertRowsBefore(1, 5);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`beforePosition`	`Integer`	แถวก่อนหน้าที่ควรเพิ่มแถวใหม่
`howMany`	`Integer`	จํานวนแถวที่จะแทรก

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`insertSlicer(range, anchorRowPos, anchorColPos)`

เพิ่มตัวแบ่งส่วนข้อมูลใหม่ลงในชีตนี้

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Inserts the slicer with a random range into the sheet.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`range`	`Range`	ช่วงที่สร้างตัวควบคุมตัวกรอง
`anchorRowPos`	`Integer`	ส่วนด้านบนของตัวแบ่งจะยึดอยู่ที่แถวนี้
`anchorColPos`	`Integer`	ด้านบนของตัวแบ่งส่วนได้รับการยึดในคอลัมน์นี้

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองที่แทรกใหม่

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

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

`insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)`

เพิ่มตัวแบ่งส่วนข้อมูลใหม่ลงในชีตนี้

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Inserts a slicer using the random range function.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`range`	`Range`	ช่วงที่สร้างตัวควบคุมตัวกรอง
`anchorRowPos`	`Integer`	ส่วนด้านบนของตัวแบ่งจะยึดอยู่ที่แถวนี้
`anchorColPos`	`Integer`	ด้านบนของตัวแบ่งส่วนได้รับการยึดในคอลัมน์นี้
`offsetX`	`Integer`	การเลื่อนแนวนอนจากมุมเซลล์เป็นพิกเซล
`offsetY`	`Integer`	การเลื่อนแนวตั้งจากมุมเซลล์เป็นพิกเซล

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองที่แทรกใหม่

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

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

`isColumnHiddenByUser(columnPosition)`

แสดงผลว่าผู้ใช้ซ่อนคอลัมน์ที่ระบุหรือไม่

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

// Columns start at 1
Logger.log(sheet.isColumnHiddenByUser(1));

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnPosition`	`Integer`	ตําแหน่งของคอลัมน์ที่จะตรวจสอบ

รีเทิร์น

Boolean — true หากคอลัมน์ซ่อนอยู่ และ false ในกรณีอื่นๆ

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

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

`isRightToLeft()`

แสดงผล true หากเลย์เอาต์ชีตนี้เป็นแบบจากขวาไปซ้าย แสดงค่า 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if a spreadsheet is ordered from right to left and logs the result to
// the console.
console.log(sheet.isRightToLeft());

รีเทิร์น

Boolean — true หากเป็นจากขวาไปซ้าย และ false ในกรณีอื่นๆ

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

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

`isRowHiddenByFilter(rowPosition)`

แสดงผลว่าตัวกรอง (ไม่ใช่มุมมองตัวกรอง) ซ่อนแถวที่ระบุหรือไม่

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowPosition`	`Integer`	ตําแหน่งของแถวที่จะตรวจสอบ

รีเทิร์น

Boolean — true หากแถวซ่อนอยู่ และ false ในกรณีอื่นๆ

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

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

`isRowHiddenByUser(rowPosition)`

แสดงผลว่าผู้ใช้ซ่อนแถวที่ระบุหรือไม่

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByUser(1));

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowPosition`	`Integer`	ตําแหน่งของแถวที่จะตรวจสอบ

รีเทิร์น

Boolean — true หากแถวซ่อนอยู่ และ false ในกรณีอื่นๆ

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

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

`isSheetHidden()`

แสดงผลเป็น true หากชีตซ่อนอยู่

const sheet = SpreadsheetApp.getActiveSheet();
if (sheet.isSheetHidden()) {
  // do something...
}

รีเทิร์น

Boolean — true หากชีตซ่อนอยู่ หรือ false หากไม่ได้ซ่อน

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

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

`moveColumns(columnSpec, destinationIndex)`

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

// The code below moves rows A-B to destination index 5.
// This results in those columns becoming columns C-D.
const sheet = SpreadsheetApp.getActiveSheet();
// Selects column A and column B to be moved.
const columnSpec = sheet.getRange('A1:B1');
sheet.moveColumns(columnSpec, 5);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnSpec`	`Range`	ช่วงของคอลัมน์ที่ควรย้าย
`destinationIndex`	`Integer`	ดัชนีที่ควรย้ายคอลัมน์ไป โปรดทราบว่าดัชนีนี้อิงตามพิกัดก่อนที่จะมีการย้ายคอลัมน์ ระบบจะเลื่อนข้อมูลที่มีอยู่ไปทางขวาเพื่อเพิ่มพื้นที่ให้กับคอลัมน์ที่ย้าย ขณะที่นำคอลัมน์ต้นทางออกจากตารางกริด ดังนั้น ข้อมูลจึงอาจอยู่ในดัชนีอื่นนอกเหนือจากที่ระบุไว้เดิม

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

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

`moveRows(rowSpec, destinationIndex)`

ย้ายแถวที่เลือกตามช่วงที่กำหนดไปยังตำแหน่งที่ระบุโดย destinationIndex rowSpec ไม่จำเป็นต้องแสดงทั้งแถวหรือกลุ่มแถวที่จะย้าย แต่จะเลือกแถวทั้งหมดที่อยู่ในช่วง

// The code below moves rows 1-2 to destination index 5.
// This results in those rows becoming rows 3-4.
const sheet = SpreadsheetApp.getActiveSheet();
// Selects row 1 and row 2 to be moved.
const rowSpec = sheet.getRange('A1:A2');
sheet.moveRows(rowSpec, 5);

พารามิเตอร์

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

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

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

`newChart()`

แสดงผลเครื่องมือสร้างเพื่อสร้างแผนภูมิใหม่สำหรับชีตนี้

ตัวอย่างนี้แสดงวิธีสร้างแผนภูมิใหม่

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B8');
const chartBuilder = sheet.newChart();
chartBuilder.addRange(range)
    .setChartType(Charts.ChartType.LINE)
    .setPosition(2, 2, 0, 0)
    .setOption('title', 'My Line Chart!');
sheet.insertChart(chartBuilder.build());

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างเพื่อสร้างแผนภูมิใหม่

`protect()`

สร้างออบเจ็กต์ที่สามารถป้องกันไม่ให้ผู้ใช้ที่ไม่ได้รับอนุญาตแก้ไขชีตได้ จนกว่าสคริปต์จะเปลี่ยนรายการผู้แก้ไขสเปรดชีตจริงๆ (โดยการเรียกใช้ Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) หรือตั้งค่าใหม่สำหรับ Protection.setDomainEdit(editable)) สิทธิ์จะเหมือนกับสิทธิ์ของสเปรดชีต ซึ่งหมายความว่าสเปรดชีตจะยังคงไม่ได้รับการปกป้อง หากชีตได้รับการปกป้องแล้ว เมธอดนี้จะแสดงผลออบเจ็กต์ที่แสดงการตั้งค่าการป้องกันที่มีอยู่ แผ่นงานที่ป้องกันอาจมีภูมิภาคที่ไม่ได้รับการปกป้อง

// Protect the active sheet, then remove all other users from the list of
// editors.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.protect().setDescription('Sample protected sheet');

// 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.
const 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

`removeChart(chart)`

นำแผนภูมิออกจากชีตหลัก

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

// This removes all the embedded charts from the spreadsheet
const charts = sheet.getCharts();
for (const i in charts) {
  sheet.removeChart(charts[i]);
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`chart`	`EmbeddedChart`	แผนภูมิที่จะนําออก

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

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

`setActiveRange(range)`

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

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const range = sheet.getRange('A1:D4');
sheet.setActiveRange(range);

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`range`	`Range`	ช่วงที่จะตั้งเป็นช่วงที่มีการใช้งาน

รีเทิร์น

Range — ช่วงใหม่ที่ใช้งานอยู่

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

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

`setActiveRangeList(rangeList)`

ตั้งค่ารายการช่วงที่ระบุเป็น active ranges ในชีตที่ใช้งานอยู่ ช่วงสุดท้ายในรายการจะตั้งค่าเป็น active range

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
sheet.setActiveRangeList(rangeList);

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rangeList`	`RangeList`	รายการช่วงที่จะเลือก

รีเทิร์น

RangeList — รายการช่วงใหม่ที่เลือก

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

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

`setActiveSelection(range)`

กำหนดพื้นที่การเลือกที่ใช้งานอยู่สำหรับชีตนี้

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

const range = sheet.getRange('A1:D4');
sheet.setActiveSelection(range);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`range`	`Range`	ช่วงที่จะตั้งเป็นการเลือกที่ใช้งานอยู่

รีเทิร์น

Range — ช่วงใหม่ที่ใช้งานอยู่

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

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

`setActiveSelection(a1Notation)`

ตั้งค่าการเลือกที่ใช้งานอยู่ตามที่ระบุไว้ในรูปแบบ A1 หรือ R1C1

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

sheet.setActiveSelection('A1:D4');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`a1Notation`	`String`	ช่วงที่จะตั้งค่าเป็นใช้งานอยู่ตามที่ระบุไว้ในรูปแบบ A1 หรือ R1C1

รีเทิร์น

Range — ช่วงใหม่ที่ใช้งานอยู่

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

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

`setColumnGroupControlPosition(position)`

กำหนดตำแหน่งของปุ่มเปิด/ปิดการควบคุมกลุ่มคอลัมน์ในชีต

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setColumnGroupControlPosition(
    SpreadsheetApp.GroupControlTogglePosition.AFTER,
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`position`	`GroupControlTogglePosition`	ตำแหน่งของสวิตช์การควบคุมกลุ่มคอลัมน์

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`setColumnWidth(columnPosition, width)`

ตั้งค่าความกว้างของคอลัมน์ที่ระบุเป็นพิกเซล

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

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(1, 200);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnPosition`	`Integer`	ตำแหน่งของคอลัมน์ที่จะตั้งค่า
`width`	`Integer`	ความกว้างเป็นพิกเซลที่จะตั้งค่า

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`setColumnWidths(startColumn, numColumns, width)`

ตั้งค่าความกว้างของคอลัมน์ที่ระบุเป็นพิกเซล

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

// Sets the first three columns to a width of 200 pixels
sheet.setColumnWidths(1, 3, 200);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`startColumn`	`Integer`	ตำแหน่งคอลัมน์เริ่มต้นที่จะเปลี่ยนแปลง
`numColumns`	`Integer`	จํานวนคอลัมน์ที่จะเปลี่ยนแปลง
`width`	`Integer`	ความกว้างเป็นพิกเซลที่จะตั้งค่า

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`setConditionalFormatRules(rules)`

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

// Remove one of the existing conditional format rules.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
rules.splice(1, 1);  // Deletes the 2nd format rule.
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rules`	`ConditionalFormatRule[]`	กฎการจัดรูปแบบตามเงื่อนไขใหม่

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

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

`setCurrentCell(cell)`

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

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

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

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

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const cell = sheet.getRange('B5');
sheet.setCurrentCell(cell);

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`cell`	`Range`	เซลล์ที่จะตั้งเป็นเซลล์ปัจจุบัน

รีเทิร์น

Range — เซลล์ปัจจุบันที่ตั้งค่าใหม่

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

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

`setFrozenColumns(columns)`

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

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

// Freezes the first column
sheet.setFrozenColumns(1);

พารามิเตอร์

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

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

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

`setFrozenRows(rows)`

ตรึงแถวตามจำนวนที่ระบุ หากเป็น 0 ระบบจะไม่ตรึงแถวใดๆ

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

// Freezes the first row
sheet.setFrozenRows(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rows`	`Integer`	จำนวนแถวที่จะตรึง

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

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

`setHiddenGridlines(hideGridlines)`

ซ่อนหรือแสดงเส้นตารางของชีต

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

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

// Hides the gridlines in the sheet.
sheet.setHiddenGridlines(true);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`hideGridlines`	`Boolean`	หากเป็น `true` ให้ซ่อนเส้นตารางในชีตนี้ ไม่เช่นนั้นให้แสดงเส้นตาราง

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`setName(name)`

ตั้งชื่อชีต

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.setName('not first anymore');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`name`	`String`	ชื่อใหม่ของชีต

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`setRightToLeft(rightToLeft)`

ตั้งค่าหรือยกเลิกการตั้งค่าเลย์เอาต์ชีตเป็นจากขวาไปซ้าย

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets the sheet layout, so that the sheet is ordered from right to left.
sheet.setRightToLeft(true);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rightToLeft`	`Boolean`	หากเป็น `true` ระบบจะตั้งค่าเลย์เอาต์ชีตเป็นจากขวาไปซ้าย โดยมีเซลล์ A1 ที่มุมขวาบน หากเป็น `false` ระบบจะตั้งค่าเลย์เอาต์ชีตเป็นค่าเริ่มต้นจากซ้ายไปขวา โดยมีเซลล์ A1 ที่ด้านซ้ายบน

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`setRowGroupControlPosition(position)`

ตั้งค่าตําแหน่งของปุ่มเปิด/ปิดการควบคุมกลุ่มแถวในสเปรดชีต

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setRowGroupControlPosition(
    SpreadsheetApp.GroupControlTogglePosition.AFTER,
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`position`	`GroupControlTogglePosition`	ตําแหน่งของปุ่มเปิด/ปิดการควบคุมกลุ่มแถว

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`setRowHeight(rowPosition, height)`

ตั้งค่าความสูงของแถวที่ระบุเป็นพิกเซล โดยค่าเริ่มต้น แถวจะขยายให้พอดีกับเนื้อหาของเซลล์ หากต้องการบังคับให้แถวมีความสูงที่ระบุ ให้ใช้ setRowHeightsForced(startRow, numRows, height)

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

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(1, 200);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowPosition`	`Integer`	ตำแหน่งแถวที่จะเปลี่ยนแปลง
`height`	`Integer`	ความสูงเป็นพิกเซลที่จะตั้งค่า

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`setRowHeights(startRow, numRows, height)`

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

// Sets the first three rows to a height of 20 pixels
sheet.setRowHeights(1, 3, 20);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`startRow`	`Integer`	ตำแหน่งแถวเริ่มต้นที่จะเปลี่ยนแปลง
`numRows`	`Integer`	จํานวนแถวที่จะเปลี่ยนแปลง
`height`	`Integer`	ความสูงเป็นพิกเซลที่จะตั้งค่า

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`setRowHeightsForced(startRow, numRows, height)`

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

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

// Sets the first three rows to a height of 5 pixels.
sheet.setRowHeightsForced(1, 3, 5);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`startRow`	`Integer`	ตำแหน่งแถวเริ่มต้นที่จะเปลี่ยนแปลง
`numRows`	`Integer`	จํานวนแถวที่จะเปลี่ยนแปลง
`height`	`Integer`	ความสูงเป็นพิกเซลที่จะตั้งค่า

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`setTabColor(color)`

ตั้งค่าสีแท็บชีต

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.setTabColor('ff0000');  // Set the color to red.
first.setTabColor(null);      // Unset the color.

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`setTabColorObject(color)`

ตั้งค่าสีแท็บชีต

// This example assumes there is a sheet named "Sheet1"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('Sheet1');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                  .build();
first.setTabColorObject(color);  // Set the color to theme accent 1.
first.setTabColorObject(null);   // Unset the color.

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตนี้สําหรับการต่อเชื่อม

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

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

`showColumns(columnIndex)`

เลิกซ่อนคอลัมน์ที่ดัชนีที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Unhides the first column
sheet.showColumns(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnIndex`	`Integer`	ดัชนีของคอลัมน์ที่จะเลิกซ่อน

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

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

`showColumns(columnIndex, numColumns)`

เลิกซ่อนคอลัมน์ติดต่อกันอย่างน้อย 1 คอลัมน์โดยเริ่มจากดัชนีที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Unhides the first three columns
sheet.showColumns(1, 3);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnIndex`	`Integer`	ดัชนีเริ่มต้นของคอลัมน์ที่จะเลิกซ่อน
`numColumns`	`Integer`	จำนวนคอลัมน์ที่จะเลิกซ่อน

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

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

`showRows(rowIndex)`

เลิกซ่อนแถวที่ดัชนีที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Unhides the first row
sheet.showRows(1);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowIndex`	`Integer`	ดัชนีของแถวที่จะเลิกซ่อน

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

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

`showRows(rowIndex, numRows)`

เลิกซ่อนแถวติดต่อกันอย่างน้อย 1 แถวโดยเริ่มจากดัชนีที่ระบุ

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Unhides the first three rows
sheet.showRows(1, 3);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rowIndex`	`Integer`	ดัชนีเริ่มต้นของแถวที่จะเลิกซ่อน
`numRows`	`Integer`	จำนวนแถวที่จะเลิกซ่อน

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

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

`showSheet()`

แสดงชีต จะไม่มีผลหากชีตแสดงอยู่แล้ว

const sheet = SpreadsheetApp.getActiveSheet();
sheet.showSheet();

รีเทิร์น

Sheet — ชีตปัจจุบัน

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

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

`sort(columnPosition)`

จัดเรียงชีตตามคอลัมน์จากน้อยไปมาก

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

// Sorts the sheet by the first column, ascending
sheet.sort(1);

พารามิเตอร์

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

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`sort(columnPosition, ascending)`

จัดเรียงชีตตามคอลัมน์ ใช้พารามิเตอร์เพื่อระบุการเรียงจากน้อยไปมากหรือจากมากไปน้อย

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

// Sorts the sheet by the first column, descending
sheet.sort(1, false);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnPosition`	`Integer`	คอลัมน์ที่จะจัดเรียง
`ascending`	`Boolean`	`true` สำหรับการจัดเรียงจากน้อยไปมาก และ `false` สำหรับการจัดเรียงจากมากไปน้อย

รีเทิร์น

Sheet — ชีตที่มีประโยชน์สำหรับการต่อเชนเมธอด

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

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

`unhideColumn(column)`

เลิกซ่อนคอลัมน์ในช่วงที่ระบุ

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

// This unhides the first column if it was previously hidden
const range = sheet.getRange('A1');
sheet.unhideColumn(range);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`column`	`Range`	ช่วงที่จะเลิกซ่อน หากซ่อนอยู่

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

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

`unhideRow(row)`

เลิกซ่อนแถวในช่วงที่ระบุ

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

// This unhides the first row if it was previously hidden
const range = sheet.getRange('A1');
sheet.unhideRow(range);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`row`	`Range`	ช่วงที่จะเลิกซ่อน หากซ่อนอยู่

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

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

`updateChart(chart)`

อัปเดตแผนภูมิในชีตนี้

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

// This code is going to loop through all the charts and change them to
// column charts
const charts = sheet.getCharts();
for (const i in charts) {
  const chart = charts[i];
  const newChart = chart.modify().setChartType(Charts.ChartType.COLUMN).build();
  sheet.updateChart(newChart);
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`chart`	`EmbeddedChart`	แผนภูมิที่จะอัปเดต

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

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

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

`getSheetProtection()`

เลิกใช้งานแล้ว สำหรับสเปรดชีตที่สร้างใน Google ชีตเวอร์ชันใหม่ ให้ใช้ getProtections(type) ซึ่งจะแสดงผลคลาส Protection ที่มีประสิทธิภาพมากกว่า แม้ว่าเราจะเลิกใช้งานวิธีการนี้แล้ว แต่ก็ยังใช้ได้อยู่เพื่อให้ชีตเวอร์ชันเก่าใช้งานร่วมกันได้

แสดงผลอินสแตนซ์ PageProtection ที่อธิบายสิทธิ์สำหรับชีตปัจจุบัน

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

const permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser('user@example.com');

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
const users = permissions.getUsers();
Logger.log(users);

รีเทิร์น

PageProtection — ออบเจ็กต์ที่อธิบายสิทธิ์การเข้าถึงชีต

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

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

`getTabColor()`

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

รับสีแท็บชีต หรือ null หากแท็บชีตไม่มีสี

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
const color = first.getTabColor();

รีเทิร์น

String — รหัสสีในเครื่องหมาย CSS (เช่น '#ffffff')

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

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

`setSheetProtection(permissions)`

เลิกใช้งานแล้ว สำหรับสเปรดชีตที่สร้างใน Google ชีตเวอร์ชันใหม่ ให้ใช้ protect() ซึ่งจะแสดงผลคลาส Protection ที่มีประสิทธิภาพมากกว่า แม้ว่าเราจะเลิกใช้งานวิธีการนี้แล้ว แต่ก็ยังใช้ได้เพื่อให้ชีตเวอร์ชันเก่าใช้งานร่วมกันได้

ตั้งค่าสิทธิ์สำหรับชีตปัจจุบัน

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

const permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
const sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`permissions`	`PageProtection`	ออบเจ็กต์สิทธิ์การเข้าถึงที่จะตั้งค่าในชีตนี้

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

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