Class Range

Phạm vi

Truy cập và sửa đổi dải ô trong bảng tính. Dải ô có thể là một ô trong trang tính hoặc một nhóm các ô liền kề trong một trang tính.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
activate()	Range	Đặt dải ô được chỉ định làm active range, có phần trên cùng ô bên trái trong dải ô dưới dạng current cell.
activateAsCurrentCell()	Range	Đặt ô được chỉ định làm current cell.
addDeveloperMetadata(key)	Range	Thêm siêu dữ liệu nhà phát triển bằng khoá đã chỉ định vào dải ô.
addDeveloperMetadata(key, visibility)	Range	Thêm siêu dữ liệu dành cho nhà phát triển với khoá đã chỉ định và chế độ hiển thị vào dải ô.
addDeveloperMetadata(key, value)	Range	Thêm siêu dữ liệu nhà phát triển với khoá và giá trị được chỉ định vào dải ô.
addDeveloperMetadata(key, value, visibility)	Range	Thêm siêu dữ liệu nhà phát triển với khoá, giá trị và chế độ hiển thị đã chỉ định vào dải ô.
applyColumnBanding()	Banding	Áp dụng giao diện dải cột mặc định cho dải ô.
applyColumnBanding(bandingTheme)	Banding	Áp dụng giao diện dải cột cụ thể cho dải ô.
applyColumnBanding(bandingTheme, showHeader, showFooter)	Banding	Áp dụng giao diện dải cột được chỉ định cho dải ô có đầu trang và chân trang được chỉ định phần cài đặt.
applyRowBanding()	Banding	Áp dụng một giao diện dải hàng mặc định cho dải ô.
applyRowBanding(bandingTheme)	Banding	Áp dụng giao diện dải hàng chỉ định cho dải ô.
applyRowBanding(bandingTheme, showHeader, showFooter)	Banding	Áp dụng giao diện dải hàng được chỉ định cho dải ô có chế độ cài đặt đầu trang và chân trang được chỉ định.
autoFill(destination, series)	void	Điền dữ liệu vào destinationRange dựa trên dữ liệu trong dải ô này.
autoFillToNeighbor(series)	void	Tính toán một dải ô cần điền dữ liệu mới dựa trên các ô lân cận và tự động điền dải ô đó với các giá trị mới dựa trên dữ liệu có trong dải ô này.
breakApart()	Range	Chia nhỏ các ô gồm nhiều cột bất kỳ trong dải ô thành từng ô riêng lẻ.
canEdit()	Boolean	Xác định xem người dùng có quyền chỉnh sửa mọi ô trong dải ô hay không.
check()	Range	Thay đổi trạng thái của hộp đánh dấu trong dải ô thành "đã đánh dấu".
clear()	Range	Xoá phạm vi nội dung và định dạng.
clear(options)	Range	Xoá phạm vi nội dung, định dạng, quy tắc xác thực dữ liệu và/hoặc nhận xét, như được chỉ định bằng các tuỳ chọn nâng cao nhất định.
clearContent()	Range	Xoá nội dung của dải ô, giữ nguyên định dạng.
clearDataValidations()	Range	Xoá các quy tắc xác thực dữ liệu cho dải ô.
clearFormat()	Range	Xoá định dạng cho dải ô này.
clearNote()	Range	Xoá ghi chú trong ô hoặc các ô đã cho.
collapseGroups()	Range	Thu gọn tất cả các nhóm hoàn toàn nằm trong dải ô.
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)	void	Sao chép định dạng của dải ô vào vị trí cụ thể.
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)	void	Sao chép định dạng của dải ô đến vị trí cụ thể.
copyTo(destination)	void	Sao chép dữ liệu từ một dải ô sang một dải ô khác.
copyTo(destination, copyPasteType, transposed)	void	Sao chép dữ liệu từ một dải ô sang một dải ô khác.
copyTo(destination, options)	void	Sao chép dữ liệu từ một dải ô sang một dải ô khác.
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)	void	Sao chép nội dung của dải ô vào vị trí đã cho.
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)	void	Sao chép nội dung của dải ô vào vị trí đã cho.
createDataSourcePivotTable(dataSource)	DataSourcePivotTable	Tạo một bảng tổng hợp nguồn dữ liệu trống từ nguồn dữ liệu, được neo vào ô đầu tiên trong phạm vi này.
createDataSourceTable(dataSource)	DataSourceTable	Tạo một bảng nguồn dữ liệu trống từ nguồn dữ liệu, được neo vào ô đầu tiên trong dải ô.
createDeveloperMetadataFinder()	DeveloperMetadataFinder	Trả về DeveloperMetadataFinderApi để tìm siêu dữ liệu nhà phát triển trong phạm vi của API này dải ô.
createFilter()	Filter	Tạo một bộ lọc và áp dụng bộ lọc đó cho dải ô được chỉ định trên trang tính.
createPivotTable(sourceData)	PivotTable	Tạo một bảng tổng hợp trống từ sourceData được chỉ định được neo vào ô đầu tiên trong phạm vi này.
createTextFinder(findText)	TextFinder	Tạo một trình tìm kiếm văn bản cho dải ô. Trình tìm kiếm này có thể tìm và thay thế văn bản trong dải ô này.
deleteCells(shiftDimension)	void	Xoá dải ô này.
expandGroups()	Range	Mở rộng các nhóm thu gọn có dải ô hoặc nút điều khiển giao cắt với dải ô này.
getA1Notation()	String	Trả về chuỗi mô tả dải ô, bằng ký hiệu A1.
getBackground()	String	Trả về màu nền của ô trên cùng bên trái trong dải ô (ví dụ: '#ffffff').
getBackgroundObject()	Color	Trả về màu nền của ô trên cùng bên trái trong dải ô.
getBackgroundObjects()	Color[][]	Trả về màu nền của các ô trong dải ô.
getBackgrounds()	String[][]	Trả về màu nền của các ô trong dải ô (ví dụ: '#ffffff').
getBandings()	Banding[]	Trả về tất cả dải được áp dụng cho bất kỳ ô nào trong dải ô này.
getCell(row, column)	Range	Trả về một ô đã cho trong một dải ô.
getColumn()	Integer	Trả về vị trí cột bắt đầu của dải ô này.
getDataRegion()	Range	Trả về bản sao của dải ô được mở rộng trong bốn Direction chính để bao gồm tất cả các ô liền kề có chứa dữ liệu.
getDataRegion(dimension)	Range	Trả về bản sao của dải ô được mở rộng Direction.UP và Direction.DOWN nếu giá trị phương diện được chỉ định là Dimension.ROWS hoặc Direction.NEXT và Direction.PREVIOUS nếu phương diện là Dimension.COLUMNS.
getDataSourceFormula()	DataSourceFormula	Trả về DataSourceFormula cho ô đầu tiên trong dải ô hoặc null nếu ô không chứa công thức nguồn dữ liệu.
getDataSourceFormulas()	DataSourceFormula[]	Trả về DataSourceFormula cho các ô trong dải ô.
getDataSourcePivotTables()	DataSourcePivotTable[]	Lấy tất cả bảng tổng hợp nguồn dữ liệu giao cắt với dải ô.
getDataSourceTables()	DataSourceTable[]	Lấy tất cả bảng nguồn dữ liệu giao với dải ô.
getDataSourceUrl()	String	Trả về một URL cho dữ liệu trong dải ô này. URL này có thể được dùng để tạo biểu đồ và truy vấn.
getDataTable()	DataTable	Trả về dữ liệu bên trong đối tượng này dưới dạng DataTable.
getDataTable(firstRowIsHeader)	DataTable	Trả về dữ liệu bên trong dải ô này dưới dạng DataTable.
getDataValidation()	DataValidation	Trả về quy tắc xác thực dữ liệu cho ô trên cùng bên trái trong dải ô.
getDataValidations()	DataValidation[][]	Trả về quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô.
getDeveloperMetadata()	DeveloperMetadata[]	Lấy siêu dữ liệu nhà phát triển liên kết với dải ô này.
getDisplayValue()	String	Trả về giá trị hiển thị của ô trên cùng bên trái trong dải ô.
getDisplayValues()	String[][]	Trả về lưới hình chữ nhật chứa các giá trị của dải ô này.
getFilter()	Filter	Trả về bộ lọc trên trang tính chứa dải ô này hoặc null nếu không có bộ lọc trên trang tính trang tính.
getFontColorObject()	Color	Trả về màu phông chữ của ô ở góc trên cùng bên trái của dải ô.
getFontColorObjects()	Color[][]	Trả về màu phông chữ của các ô trong dải ô.
getFontFamilies()	String[][]	Trả về bộ phông chữ của các ô trong dải ô.
getFontFamily()	String	Trả về bộ phông chữ của ô ở góc trên cùng bên trái của dải ô.
getFontLine()	String	Lấy kiểu đường kẻ của ô ở góc trên cùng bên trái của dải ô ('underline', 'line-through' hoặc 'none').
getFontLines()	String[][]	Lấy kiểu đường kẻ của ô trong dải ô ('underline', 'line-through' hoặc 'none').
getFontSize()	Integer	Trả về kích thước phông chữ theo kích thước điểm của ô ở góc trên cùng bên trái của dải ô.
getFontSizes()	Integer[][]	Trả về kích thước phông chữ của các ô trong dải ô.
getFontStyle()	String	Trả về kiểu phông chữ ('italic' hoặc 'normal') của ô ở trên cùng bên trái góc của dải ô.
getFontStyles()	String[][]	Trả về kiểu phông chữ của các ô trong dải ô.
getFontWeight()	String	Trả về độ đậm phông chữ (bình thường/in đậm) của ô ở góc trên cùng bên trái của dải ô.
getFontWeights()	String[][]	Trả về độ đậm phông chữ của các ô trong dải ô.
getFormula()	String	Trả về công thức (ký hiệu A1) cho ô trên cùng bên trái của dải ô hoặc một chuỗi trống nếu ô trống hoặc không chứa công thức.
getFormulaR1C1()	String	Trả về công thức (ký hiệu R1C1) cho một ô đã cho hoặc null nếu không có.
getFormulas()	String[][]	Trả về công thức (ký hiệu A1) cho các ô trong dải ô.
getFormulasR1C1()	String[][]	Trả về công thức (ký hiệu R1C1) cho các ô trong dải ô.
getGridId()	Integer	Trả về mã nhận dạng lưới của trang tính mẹ của dải ô.
getHeight()	Integer	Trả về chiều cao của dải ô.
getHorizontalAlignment()	String	Trả về căn chỉnh văn bản theo chiều ngang (trái/giữa/phải) của ô ở trên cùng bên trái góc của dải ô.
getHorizontalAlignments()	String[][]	Trả về vị trí căn chỉnh theo chiều ngang của các ô trong dải ô.
getLastColumn()	Integer	Trả về vị trí cột kết thúc.
getLastRow()	Integer	Trả về vị trí hàng kết thúc.
getMergedRanges()	Range[]	Trả về một mảng gồm các đối tượng Range đại diện cho các ô đã hợp nhất hoàn toàn trong dải ô hiện tại hoặc chứa ít nhất một ô trong dải ô hiện tại.
getNextDataCell(direction)	Range	Bắt đầu từ ô trong cột và hàng đầu tiên của dải ô, trả về ô tiếp theo trong hướng đã cho là cạnh của một dải ô liền kề có dữ liệu trong đó hoặc ô ở cạnh của bảng tính theo hướng đó.
getNote()	String	Trả về ghi chú liên kết với dải ô cho sẵn.
getNotes()	String[][]	Trả về các ghi chú liên kết với các ô trong dải ô.
getNumColumns()	Integer	Trả về số lượng cột trong dải ô này.
getNumRows()	Integer	Trả về số lượng hàng trong dải ô này.
getNumberFormat()	String	Lấy định dạng số hoặc ngày của ô trên cùng bên trái của dải ô cho sẵn.
getNumberFormats()	String[][]	Trả về định dạng số hoặc ngày tháng cho các ô trong dải ô.
getRichTextValue()	RichTextValue	Trả về giá trị Văn bản đa dạng thức cho ô trên cùng bên trái của dải ô hoặc null nếu ô giá trị không phải là văn bản.
getRichTextValues()	RichTextValue[][]	Trả về giá trị Văn bản đa dạng thức cho các ô trong dải ô.
getRow()	Integer	Trả về vị trí hàng cho dải ô này.
getRowIndex()	Integer	Trả về vị trí hàng cho dải ô này.
getSheet()	Sheet	Trả về trang tính chứa dải ô này.
getTextDirection()	TextDirection	Trả về hướng văn bản cho ô trên cùng bên trái của dải ô.
getTextDirections()	TextDirection[][]	Trả về hướng văn bản cho các ô trong dải ô.
getTextRotation()	TextRotation	Trả về chế độ cài đặt xoay văn bản cho ô trên cùng bên trái của dải ô.
getTextRotations()	TextRotation[][]	Trả về chế độ cài đặt xoay văn bản cho các ô trong dải ô.
getTextStyle()	TextStyle	Trả về kiểu văn bản cho ô trên cùng bên trái của dải ô.
getTextStyles()	TextStyle[][]	Trả về kiểu văn bản cho các ô trong dải ô.
getValue()	Object	Trả về giá trị của ô trên cùng bên trái trong dải ô.
getValues()	Object[][]	Trả về lưới hình chữ nhật chứa các giá trị của dải ô này.
getVerticalAlignment()	String	Trả về căn chỉnh dọc (trên cùng/ở giữa/dưới cùng) của ô ở góc trên cùng bên trái của dải ô.
getVerticalAlignments()	String[][]	Trả về căn chỉnh dọc của các ô trong dải ô.
getWidth()	Integer	Trả về chiều rộng của dải ô trong cột.
getWrap()	Boolean	Trả về xem văn bản trong ô có được xuống dòng tự động hay không.
getWrapStrategies()	WrapStrategy[][]	Trả về chiến lược xuống dòng tự động cho các ô trong dải ô.
getWrapStrategy()	WrapStrategy	Trả về chiến lược xuống dòng tự động cho ô trên cùng bên trái của dải ô.
getWraps()	Boolean[][]	Trả về xem văn bản trong ô có được xuống dòng hay không.
insertCells(shiftDimension)	Range	Chèn các ô trống vào dải ô này.
insertCheckboxes()	Range	Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng true cho các ô đã đánh dấu và Bỏ đánh dấu false.
insertCheckboxes(checkedValue)	Range	Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng một giá trị tuỳ chỉnh cho trạng thái đã đánh dấu và chuỗi trống để bỏ đánh dấu.
insertCheckboxes(checkedValue, uncheckedValue)	Range	Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng các giá trị tuỳ chỉnh cho ô đã đánh dấu và các trạng thái chưa đánh dấu.
isBlank()	Boolean	Trả về true nếu dải ô hoàn toàn trống.
isChecked()	Boolean	Trả về xem liệu tất cả các ô trong dải ô có trạng thái hộp đánh dấu là "đã đánh dấu" hay không.
isEndColumnBounded()	Boolean	Xác định xem điểm cuối của dải ô có liên kết với một cột cụ thể hay không.
isEndRowBounded()	Boolean	Xác định xem điểm cuối của dải ô có liên kết với một hàng cụ thể hay không.
isPartOfMerge()	Boolean	Trả về true nếu các ô trong dải ô hiện tại chồng chéo lên bất kỳ ô đã hợp nhất nào.
isStartColumnBounded()	Boolean	Xác định xem điểm bắt đầu của dải ô có được liên kết với một cột cụ thể hay không.
isStartRowBounded()	Boolean	Xác định xem điểm bắt đầu của dải ô có được liên kết với một hàng cụ thể hay không.
merge()	Range	Hợp nhất các ô trong dải ô với nhau thành một khối duy nhất.
mergeAcross()	Range	Hợp nhất các ô trong dải ô trên các cột của dải ô.
mergeVertically()	Range	Hợp nhất các ô trong dải ô với nhau.
moveTo(target)	void	Cắt và dán (cả định dạng và giá trị) từ dải ô này vào dải ô đích.
offset(rowOffset, columnOffset)	Range	Trả về một dải ô mới được bù trừ từ dải ô này theo số hàng và cột cho trước (có thể mang giá trị âm).
offset(rowOffset, columnOffset, numRows)	Range	Trả về một dải ô mới tương ứng với dải ô hiện tại có điểm trên bên trái được bù trừ từ dải ô hiện tại theo hàng và cột đã cho và theo chiều cao đã cho tính theo ô.
offset(rowOffset, columnOffset, numRows, numColumns)	Range	Trả về một dải ô mới tương ứng với dải ô hiện tại có điểm trên bên trái được bù trừ từ dải ô hiện tại theo hàng và cột đã cho và với chiều cao và chiều rộng đã cho ô.
protect()	Protection	Tạo một đối tượng có thể bảo vệ dải ô không bị chỉnh sửa, ngoại trừ những người dùng đã quyền.
randomize()	Range	Sắp xếp ngẫu nhiên thứ tự của các hàng trong dải ô cho sẵn.
removeCheckboxes()	Range	Xoá tất cả hộp đánh dấu khỏi dải ô.
removeDuplicates()	Range	Xóa các hàng trong dải ô này có chứa các giá trị trùng lặp với các giá trị trong bất kỳ hàng trước đó.
removeDuplicates(columnsToCompare)	Range	Xóa các hàng trong dải ô này có chứa giá trị trùng lặp trong các cột được chỉ định giá trị bất kỳ hàng nào trước đó.
setBackground(color)	Range	Đặt màu nền của tất cả các ô trong dải ô trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').
setBackgroundObject(color)	Range	Đặt màu nền của tất cả các ô trong dải ô.
setBackgroundObjects(color)	Range	Thiết lập một lưới hình chữ nhật có màu nền (phải khớp với kích thước của dải ô này).
setBackgroundRGB(red, green, blue)	Range	Đặt nền thành màu đã cho bằng cách sử dụng các giá trị RGB (bao gồm các số nguyên từ 0 đến 255).
setBackgrounds(color)	Range	Thiết lập một lưới hình chữ nhật có màu nền (phải khớp với kích thước của dải ô này).
setBorder(top, left, bottom, right, vertical, horizontal)	Range	Đặt thuộc tính đường viền.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)	Range	Đặt thuộc tính đường viền bằng màu và/hoặc kiểu.
setDataValidation(rule)	Range	Đặt một quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô.
setDataValidations(rules)	Range	Đặt quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô.
setFontColor(color)	Range	Đặt màu phông chữ trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').
setFontColorObject(color)	Range	Đặt màu phông chữ của dải ô đã cho.
setFontColorObjects(colors)	Range	Thiết lập một lưới hình chữ nhật có màu phông chữ (phải khớp với kích thước của dải ô này).
setFontColors(colors)	Range	Thiết lập một lưới hình chữ nhật có màu phông chữ (phải khớp với kích thước của dải ô này).
setFontFamilies(fontFamilies)	Range	Thiết lập một lưới hình chữ nhật của bộ phông chữ (phải khớp với kích thước của dải ô này).
setFontFamily(fontFamily)	Range	Đặt bộ phông chữ, chẳng hạn như "vi" hoặc "WIDTH".
setFontLine(fontLine)	Range	Đặt kiểu dòng phông chữ của dải ô đã cho ('underline', 'line-through' hoặc 'none').
setFontLines(fontLines)	Range	Thiết lập một lưới hình chữ nhật cho các kiểu đường kẻ (phải khớp với kích thước của dải ô này).
setFontSize(size)	Range	Đặt kích thước phông chữ, trong đó kích thước là kích thước điểm sẽ sử dụng.
setFontSizes(sizes)	Range	Thiết lập một lưới hình chữ nhật có kích thước phông chữ (phải khớp với kích thước của dải ô này).
setFontStyle(fontStyle)	Range	Đặt kiểu phông chữ cho dải ô đã cho ('italic' hoặc 'normal').
setFontStyles(fontStyles)	Range	Thiết lập một lưới hình chữ nhật cho các kiểu phông chữ (phải khớp với kích thước của dải ô này).
setFontWeight(fontWeight)	Range	Đặt độ đậm phông chữ cho dải ô nhất định (bình thường/in đậm).
setFontWeights(fontWeights)	Range	Thiết lập một lưới hình chữ nhật có độ đậm phông chữ (phải khớp với kích thước của dải ô này).
setFormula(formula)	Range	Cập nhật công thức cho dải ô này.
setFormulaR1C1(formula)	Range	Cập nhật công thức cho dải ô này.
setFormulas(formulas)	Range	Thiết lập một lưới hình chữ nhật cho các công thức (phải khớp với kích thước của dải ô này).
setFormulasR1C1(formulas)	Range	Thiết lập một lưới hình chữ nhật cho các công thức (phải khớp với kích thước của dải ô này).
setHorizontalAlignment(alignment)	Range	Thiết lập cách căn chỉnh ngang (từ trái sang phải) cho dải ô cho sẵn (trái/giữa/phải).
setHorizontalAlignments(alignments)	Range	Thiết lập lưới hình chữ nhật căn chỉnh ngang.
setNote(note)	Range	Đặt ghi chú thành giá trị đã cho.
setNotes(notes)	Range	Thiết lập một lưới hình chữ nhật ghi chú (phải khớp với kích thước của dải ô này).
setNumberFormat(numberFormat)	Range	Đặt định dạng số hoặc ngày thành chuỗi định dạng cho sẵn.
setNumberFormats(numberFormats)	Range	Đặt một lưới hình chữ nhật có định dạng số hoặc ngày (phải khớp với kích thước của phạm vi này).
setRichTextValue(value)	Range	Đặt giá trị Văn bản đa dạng thức cho các ô trong dải ô.
setRichTextValues(values)	Range	Thiết lập một lưới hình chữ nhật chứa các giá trị Văn bản đa dạng thức.
setShowHyperlink(showHyperlink)	Range	Thiết lập xem dải ô có hiển thị siêu liên kết hay không.
setTextDirection(direction)	Range	Thiết lập hướng văn bản cho các ô trong dải ô.
setTextDirections(directions)	Range	Thiết lập một lưới hình chữ nhật chứa hướng văn bản.
setTextRotation(degrees)	Range	Thiết lập chế độ xoay văn bản cho các ô trong dải ô.
setTextRotation(rotation)	Range	Thiết lập chế độ xoay văn bản cho các ô trong dải ô.
setTextRotations(rotations)	Range	Thiết lập một lưới hình chữ nhật xoay văn bản.
setTextStyle(style)	Range	Đặt kiểu văn bản cho các ô trong dải ô.
setTextStyles(styles)	Range	Thiết lập lưới hình chữ nhật chứa kiểu văn bản.
setValue(value)	Range	Đặt giá trị cho dải ô.
setValues(values)	Range	Thiết lập một lưới hình chữ nhật chứa các giá trị (phải khớp với kích thước của dải ô này).
setVerticalAlignment(alignment)	Range	Đặt căn chỉnh dọc (trên cùng xuống dưới) cho dải ô cho trước (trên/giữa/dưới cùng).
setVerticalAlignments(alignments)	Range	Thiết lập một lưới hình chữ nhật căn chỉnh dọc (phải khớp với kích thước của dải ô này).
setVerticalText(isVertical)	Range	Đặt xem có xếp chồng văn bản cho các ô trong dải ô hay không.
setWrap(isWrapEnabled)	Range	Đặt xuống dòng tự động của dải ô đã cho.
setWrapStrategies(strategies)	Range	Thiết lập một lưới hình chữ nhật cho các chiến lược bao bọc.
setWrapStrategy(strategy)	Range	Đặt chiến lược xuống dòng tự động cho các ô trong dải ô.
setWraps(isWrapEnabled)	Range	Thiết lập một lưới hình chữ nhật cho các chính sách xuống dòng tự động (phải khớp với kích thước của dải ô này).
shiftColumnGroupDepth(delta)	Range	Thay đổi chiều sâu nhóm cột của dải ô theo số lượng đã chỉ định.
shiftRowGroupDepth(delta)	Range	Thay đổi chiều sâu nhóm hàng của dải ô theo số lượng đã chỉ định.
sort(sortSpecObj)	Range	Sắp xếp các ô trong dải ô đã cho, theo cột và thứ tự được chỉ định.
splitTextToColumns()	void	Chia một cột văn bản thành nhiều cột dựa trên dấu phân tách được phát hiện tự động.
splitTextToColumns(delimiter)	void	Chia một cột văn bản thành nhiều cột bằng cách sử dụng chuỗi được chỉ định làm dấu phân tách tuỳ chỉnh.
splitTextToColumns(delimiter)	void	Chia một cột văn bản thành nhiều cột dựa trên dấu phân tách được chỉ định.
trimWhitespace()	Range	Cắt bỏ khoảng trắng (chẳng hạn như dấu cách, thẻ hoặc dòng mới) ở mọi ô trong dải ô này.
uncheck()	Range	Thay đổi trạng thái của các hộp đánh dấu trong dải ô thành "đã bỏ chọn".

Các phương thức ngừng hoạt động

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
getFontColor()	String	Trả về màu phông chữ của ô ở góc trên cùng bên trái của dải ô, trong ký hiệu CSS (như dưới dạng '#ffffff' hoặc 'white').
getFontColors()	String[][]	Trả về màu phông chữ của các ô trong dải ô theo ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

Tài liệu chi tiết

activate()

Đặt dải ô được chỉ định làm active range, có phần trên cùng ô bên trái trong dải ô dưới dạng current cell.

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

---

activateAsCurrentCell()

Đặt ô được chỉ định làm current cell.

Nếu ô được chỉ định xuất hiện trong một dải ô hiện có, thì dải ô đó sẽ trở thành dải ô hoạt động dải ô trong đó ô là ô hiện tại.

Nếu ô được chỉ định không có trong dải ô hiện có nào, thì lựa chọn hiện có sẽ là bị xoá và ô trở thành ô hiện tại và dải ô đang hoạt động.

Lưu ý: Range được chỉ định phải bao gồm một ô, nếu không sẽ gửi một ô ngoại lệ.

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

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

addDeveloperMetadata(key)

Thêm siêu dữ liệu nhà phát triển bằng khoá đã chỉ định vào dải ô.

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

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

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

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

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

Tham số

Tên	Loại	Mô tả
key	String	Khoá cho siêu dữ liệu mới dành cho nhà phát triển.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

addDeveloperMetadata(key, visibility)

Thêm siêu dữ liệu dành cho nhà phát triển với khoá đã chỉ định và chế độ hiển thị vào dải ô.

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

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

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

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

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

Tham số

Tên	Loại	Mô tả
key	String	Khoá cho siêu dữ liệu mới dành cho nhà phát triển.
visibility	DeveloperMetadataVisibility	Chế độ hiển thị của siêu dữ liệu nhà phát triển mới.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

addDeveloperMetadata(key, value)

Thêm siêu dữ liệu nhà phát triển với khoá và giá trị được chỉ định vào dải ô.

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

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

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

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

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

Tham số

Tên	Loại	Mô tả
key	String	Khoá cho siêu dữ liệu mới dành cho nhà phát triển.
value	String	Giá trị cho siêu dữ liệu nhà phát triển mới.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

addDeveloperMetadata(key, value, visibility)

Thêm siêu dữ liệu nhà phát triển với khoá, giá trị và chế độ hiển thị đã chỉ định vào dải ô.

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

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

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

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

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

Tham số

Tên	Loại	Mô tả
key	String	Khoá cho siêu dữ liệu mới dành cho nhà phát triển.
value	String	Giá trị cho siêu dữ liệu nhà phát triển mới.
visibility	DeveloperMetadataVisibility	Chế độ hiển thị của siêu dữ liệu nhà phát triển mới.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

applyColumnBanding()

Áp dụng giao diện dải cột mặc định cho dải ô. Theo mặc định, dải bao gồm tiêu đề và không có màu chân trang.

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

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

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

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

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

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

Cầu thủ trả bóng

Banding — Dải mới.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

applyColumnBanding(bandingTheme)

Áp dụng giao diện dải cột cụ thể cho dải ô. Theo mặc định, dải có tiêu đề và không có màu chân trang.

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

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

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

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

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

Tham số

Tên	Loại	Mô tả
bandingTheme	BandingTheme	Một chủ đề màu sắc để áp dụng cho các cột trong dải ô.

Cầu thủ trả bóng

Banding — Dải mới.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

applyColumnBanding(bandingTheme, showHeader, showFooter)

Áp dụng giao diện dải cột được chỉ định cho dải ô có đầu trang và chân trang được chỉ định phần cài đặt.

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

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

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

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

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

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

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

Tham số

Tên	Loại	Mô tả
bandingTheme	BandingTheme	Một chủ đề màu sắc để áp dụng cho các cột trong dải ô.
showHeader	Boolean	Nếu là true, màu tiêu đề của giao diện tạo dải sẽ được áp dụng cho màu đầu tiên .
showFooter	Boolean	Nếu là true, màu chân trang của giao diện tạo dải sẽ được áp dụng cho màu cuối cùng .

Cầu thủ trả bóng

Banding — Dải mới.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

applyRowBanding()

Áp dụng một giao diện dải hàng mặc định cho dải ô. Theo mặc định, dải bao gồm tiêu đề và không có màu chân trang.

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

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

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

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

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

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

Cầu thủ trả bóng

Banding — Dải.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

applyRowBanding(bandingTheme)

Áp dụng giao diện dải hàng chỉ định cho dải ô. Theo mặc định, dải bao gồm tiêu đề và không có màu chân trang.

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

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

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

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

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

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

Tham số

Tên	Loại	Mô tả
bandingTheme	BandingTheme	Một giao diện màu để áp dụng cho các hàng trong dải ô.

Cầu thủ trả bóng

Banding — Dải mới.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

applyRowBanding(bandingTheme, showHeader, showFooter)

Áp dụng giao diện dải hàng được chỉ định cho dải ô có chế độ cài đặt đầu trang và chân trang được chỉ định.

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

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

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

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

Tham số

Tên	Loại	Mô tả
bandingTheme	BandingTheme	Một giao diện màu để áp dụng cho các hàng trong dải ô.
showHeader	Boolean	Nếu là true, màu tiêu đề của giao diện tạo dải sẽ được áp dụng cho hàng đầu tiên.
showFooter	Boolean	Nếu là true, màu chân trang của giao diện tạo dải sẽ được áp dụng cho hàng cuối cùng.

Cầu thủ trả bóng

Banding — Dải mới.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

autoFill(destination, series)

Điền dữ liệu vào destinationRange dựa trên dữ liệu trong dải ô này. Các giá trị mới cũng được xác định theo loại series đã chỉ định. Dải ô đích đến phải chứa dải ô này và chỉ kéo dài dải ô theo một hướng. Ví dụ: nội dung sau đây sẽ điền A1:A20 với một chuỗi số tăng dần dựa trên các giá trị hiện tại trong A1:A4:

var sheet = SpreadsheetApp.getActiveSheet();

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

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

Tham số

Tên	Loại	Mô tả
destination	Range	Dải ô sẽ được tự động điền giá trị. Phạm vi đích đến chứa dải ô này và mở rộng dải ô theo một hướng duy nhất (lên, xuống, sang trái hoặc sang phải).
series	AutoFillSeries	Loại chuỗi chuỗi Tự động điền nên được sử dụng để tính toán giá trị mới. Chiến lược phát hành đĩa đơn hiệu quả của chuỗi này khác nhau tuỳ theo loại và lượng dữ liệu nguồn.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

autoFillToNeighbor(series)

Tính toán một dải ô cần điền dữ liệu mới dựa trên các ô lân cận và tự động điền dải ô đó với các giá trị mới dựa trên dữ liệu có trong dải ô này. Các giá trị mới này cũng được xác định theo loại series chỉ định.

Phạm vi điểm đến đã tính toán sẽ xem xét dữ liệu xung quanh để xác định vị trí mới các giá trị sẽ được chèn vào: nếu có dữ liệu ở ngay bên trái hoặc bên phải của cột đang được tự động điền, các giá trị mới chỉ mở rộng đến mức dữ liệu liền kề này.

Ví dụ: nếu A1:A20 được điền bằng một chuỗi các số tăng dần và phương thức này được gọi trên dải ô B1:B4 có chứa một chuỗi ngày, các giá trị mới chỉ được chèn vào B5:B20. Bằng cách này, các giá trị mới này "gắn" vào các ô chứa trong cột A.

var sheet = SpreadsheetApp.getActiveSheet();

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

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

Tham số

Tên	Loại	Mô tả
series	AutoFillSeries	Loại chuỗi chuỗi Tự động điền nên được sử dụng để tính toán giá trị mới. Chiến lược phát hành đĩa đơn hiệu quả của chuỗi này khác nhau tuỳ theo loại và lượng dữ liệu nguồn.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

breakApart()

Chia nhỏ các ô gồm nhiều cột bất kỳ trong dải ô thành từng ô riêng lẻ.

Gọi hàm này trên một dải ô tương đương với việc chọn một dải ô rồi nhấp vào Định dạng > Hợp nhất ô > Huỷ hợp nhất.

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

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

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

canEdit()

Xác định xem người dùng có quyền chỉnh sửa mọi ô trong dải ô hay không. Bảng tính chủ sở hữu luôn có thể chỉnh sửa dải ô và trang tính được bảo vệ.

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

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

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

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

Cầu thủ trả bóng

Boolean — true nếu người dùng có quyền chỉnh sửa mọi ô trong dải ô; false nếu không.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

check()

Thay đổi trạng thái của hộp đánh dấu trong dải ô thành "đã đánh dấu". Bỏ qua các ô trong dải ô hiện không chứa giá trị đã đánh dấu hoặc bỏ đánh dấu đã định cấu hình.

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

clear()

Xoá phạm vi nội dung và định dạng.

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

clear(options)

Xoá phạm vi nội dung, định dạng, quy tắc xác thực dữ liệu và/hoặc nhận xét, như được chỉ định bằng các tuỳ chọn nâng cao nhất định. Theo mặc định, tất cả dữ liệu đều bị xoá.

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

Tham số

Tên	Loại	Mô tả
options	Object	Đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới.

Thông số nâng cao

Tên	Loại	Mô tả
commentsOnly	Boolean	Liệu có chỉ xoá bình luận hay không.
contentsOnly	Boolean	Liệu có chỉ xoá nội dung hay không.
formatOnly	Boolean	Liệu có chỉ xoá định dạng hay không; Xin lưu ý rằng việc xoá cũng xoá các quy tắc xác thực dữ liệu.
validationsOnly	Boolean	Liệu có chỉ xoá quy tắc xác thực dữ liệu hay không.
skipFilteredRows	Boolean	Liệu có tránh xoá các hàng đã lọc hay không.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

clearContent()

Xoá nội dung của dải ô, giữ nguyên định dạng.

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

clearDataValidations()

Xoá các quy tắc xác thực dữ liệu cho dải ô.

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

clearFormat()

Xoá định dạng cho dải ô này.

Thao tác này sẽ xoá định dạng văn bản của một hoặc nhiều ô trong dải ô, nhưng không đặt lại bất kỳ giá trị nào quy tắc định dạng số.

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

clearNote()

Xoá ghi chú trong ô hoặc các ô đã cho.

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

collapseGroups()

Thu gọn tất cả các nhóm hoàn toàn nằm trong dải ô. Nếu không có nhóm nào nằm trong dải ô, nhóm mở rộng sâu nhất một phần trong dải ô sẽ bị thu gọn.

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

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

Sao chép định dạng của dải ô đến vị trí cụ thể. Nếu đích đến lớn hơn hoặc nhỏ hơn dải ô nguồn thì nguồn sẽ được lặp lại hoặc cắt bớt tương ứng. Lưu ý rằng phương thức chỉ sao chép định dạng.

Để biết nội dung mô tả chi tiết về tham sốgridId, hãy xem getGridId().

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

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

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

Tham số

Tên	Loại	Mô tả
gridId	Integer	Mã nhận dạng duy nhất của trang tính trong bảng tính, bất kể vị trí.
column	Integer	Cột đầu tiên của dải ô mục tiêu.
columnEnd	Integer	Cột cuối của dải ô mục tiêu.
row	Integer	Hàng bắt đầu của dải ô mục tiêu.
rowEnd	Integer	Hàng kết thúc của dải ô mục tiêu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getGridId()

---

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

Sao chép định dạng của dải ô đến vị trí cụ thể. Nếu đích đến lớn hơn hoặc nhỏ hơn dải ô nguồn thì nguồn sẽ được lặp lại hoặc cắt bớt tương ứng. Lưu ý rằng phương thức chỉ sao chép định dạng.

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

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

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

Tham số

Tên	Loại	Mô tả
sheet	Sheet	Trang tính mục tiêu.
column	Integer	Cột đầu tiên của dải ô mục tiêu.
columnEnd	Integer	Cột cuối của dải ô mục tiêu.
row	Integer	Hàng bắt đầu của dải ô mục tiêu.
rowEnd	Integer	Hàng kết thúc của dải ô mục tiêu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

copyTo(destination)

Sao chép dữ liệu từ một dải ô sang một dải ô khác. Cả giá trị và định dạng được sao chép.

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

Tham số

Tên	Loại	Mô tả
destination	Range	Một dải ô đích để sao chép vào; chỉ có vị trí ô trên cùng bên trái là có liên quan.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

copyTo(destination, copyPasteType, transposed)

Sao chép dữ liệu từ một dải ô sang một dải ô khác.

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

Tham số

Tên	Loại	Mô tả
destination	Range	Một dải ô đích để sao chép vào; chỉ có vị trí ô trên cùng bên trái là có liên quan.
copyPasteType	CopyPasteType	Loại chỉ định cách dán nội dung của phạm vi vào đích.
transposed	Boolean	Liệu dải ô có được dán theo hướng hoán vị hay không.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

copyTo(destination, options)

Sao chép dữ liệu từ một dải ô sang một dải ô khác. Theo mặc định, cả giá trị và định dạng được sao chép, nhưng bạn có thể ghi đè định dạng này bằng đối số nâng cao.

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

Tham số

Tên	Loại	Mô tả
destination	Range	Một dải ô đích để sao chép vào; chỉ có vị trí ô trên cùng bên trái là có liên quan.
options	Object	Đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới.

Thông số nâng cao

Tên	Loại	Mô tả
formatOnly	Boolean	chỉ định rằng chỉ định dạng được sao chép
contentsOnly	Boolean	chỉ định rằng chỉ có nội dung cần được sao chép

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

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

Sao chép nội dung của dải ô vào vị trí đã cho. Nếu đích đến lớn hơn hoặc nhỏ hơn dải ô nguồn thì nguồn sẽ được lặp lại hoặc cắt bớt tương ứng.

Để biết nội dung mô tả chi tiết về tham sốgridId, hãy xem getGridId().

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

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

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

Tham số

Tên	Loại	Mô tả
gridId	Integer	Mã nhận dạng duy nhất của trang tính trong bảng tính, bất kể vị trí.
column	Integer	Cột đầu tiên của dải ô mục tiêu.
columnEnd	Integer	Cột cuối của dải ô mục tiêu.
row	Integer	Hàng bắt đầu của dải ô mục tiêu.
rowEnd	Integer	Hàng kết thúc của dải ô mục tiêu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getGridId()

---

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

Sao chép nội dung của dải ô vào vị trí đã cho. Nếu đích đến lớn hơn hoặc nhỏ hơn dải ô nguồn thì nguồn sẽ được lặp lại hoặc cắt bớt tương ứng.

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

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

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

Tham số

Tên	Loại	Mô tả
sheet	Sheet	Trang tính mục tiêu.
column	Integer	Cột đầu tiên của dải ô mục tiêu.
columnEnd	Integer	Cột cuối của dải ô mục tiêu.
row	Integer	Hàng bắt đầu của dải ô mục tiêu.
rowEnd	Integer	Hàng kết thúc của dải ô mục tiêu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

createDataSourcePivotTable(dataSource)

Tạo một bảng tổng hợp nguồn dữ liệu trống từ nguồn dữ liệu, được neo vào ô đầu tiên trong phạm vi này.

Ví dụ này cho biết cách tạo và định cấu hình một bảng tổng hợp nguồn dữ liệu mới.

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

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

Tham số

Tên	Loại	Mô tả
dataSource	DataSource	Nguồn dữ liệu dùng để tạo bảng tổng hợp.

Cầu thủ trả bóng

DataSourcePivotTable — Bảng tổng hợp nguồn dữ liệu mới tạo.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

createDataSourceTable(dataSource)

Tạo một bảng nguồn dữ liệu trống từ nguồn dữ liệu, được neo vào ô đầu tiên trong dải ô.

Ví dụ này cho biết cách tạo và định cấu hình bảng nguồn dữ liệu mới.

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

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

Tham số

Tên	Loại	Mô tả
dataSource	DataSource	Nguồn dữ liệu dùng để tạo bảng tổng hợp.

Cầu thủ trả bóng

DataSourceTable – Bảng nguồn dữ liệu mới được tạo.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

createDeveloperMetadataFinder()

Trả về DeveloperMetadataFinderApi để tìm siêu dữ liệu nhà phát triển trong phạm vi của lệnh này dải ô. Siêu dữ liệu chỉ nằm trong phạm vi của phạm vi đó nếu siêu dữ liệu hoàn toàn nằm trong phạm vi đó dải ô. Ví dụ: siêu dữ liệu liên kết với hàng "3:3" không thuộc phạm vi của một dải ô "A1:D5" nhưng nằm trong phạm vi "1:5".

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

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

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

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

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

Cầu thủ trả bóng

DeveloperMetadataFinder — Một công cụ tìm siêu dữ liệu dành cho nhà phát triển để tìm siêu dữ liệu thuộc phạm vi này.

---

createFilter()

Tạo một bộ lọc và áp dụng bộ lọc đó cho dải ô được chỉ định trên trang tính. Bạn không thể tạo nhiều hơn một bộ lọc trên trang tính. Để truy cập và sửa đổi bộ lọc sau khi tạo, hãy sử dụng getFilter() hoặc Sheet.getFilter().

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

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}

Dùng phương thức này để tạo bộ lọc cho Grid trang tính (loại trang tính mặc định). Trang tính lưới là các trang tính không kết nối với cơ sở dữ liệu. Để tạo các loại bộ lọc khác, tham khảo những nội dung sau:

• Tạo bộ lọc bảng tổng hợp bằng PivotTable.addFilter(sourceDataColumn, filterCriteria)
• Tạo bộ lọc cho một trang tính kết nối với cơ sở dữ liệu bằng DataSourceSheet.addFilter(columnName, filterCriteria)
• Tạo bộ lọc cho bảng tổng hợp kết nối với cơ sở dữ liệu bằng DataSourcePivotTable.addFilter(columnName, filterCriteria)

Cầu thủ trả bóng

Filter — Bộ lọc mới.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

createPivotTable(sourceData)

Tạo một bảng tổng hợp trống từ sourceData được chỉ định được neo vào ô đầu tiên trong phạm vi này.

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

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

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

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

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

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

Tham số

Tên	Loại	Mô tả
sourceData	Range	Dữ liệu để tạo bảng tổng hợp.

Cầu thủ trả bóng

PivotTable — PivotTable mới được tạo.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

createTextFinder(findText)

Tạo một trình tìm kiếm văn bản cho dải ô. Trình tìm kiếm này có thể tìm và thay thế văn bản trong dải ô này.

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

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

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

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

Tham số

Tên	Loại	Mô tả
findText	String	Văn bản cần tìm kiếm.

Cầu thủ trả bóng

TextFinder – TextFinder cho dải ô

---

deleteCells(shiftDimension)

Xoá dải ô này. Dữ liệu hiện có trong trang tính dọc theo phương diện được cung cấp bị thay đổi về dải ô đã xoá.

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

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

Tham số

Tên	Loại	Mô tả
shiftDimension	Dimension	Phương diện mà theo đó, bạn sẽ chuyển dữ liệu hiện có.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

expandGroups()

Mở rộng các nhóm thu gọn có dải ô hoặc nút điều khiển giao cắt với dải ô này. Chiến lược phát hành đĩa đơn vị trí nút bật/tắt điều khiển là chỉ mục mà tại đó nút bật/tắt điều khiển hiển thị, ngay trước hoặc sau nhóm, tuỳ thuộc vào chế độ cài đặt. Nếu có nhiều nhóm tại cùng một vị trí, nhóm nông nhất sẽ được mở rộng.

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getA1Notation()

Trả về chuỗi mô tả dải ô, bằng ký hiệu A1.

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

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

Cầu thủ trả bóng

String — Phần mô tả dạng chuỗi của dải ô trong ký hiệu A1.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getBackground()

Trả về màu nền của ô trên cùng bên trái trong dải ô (ví dụ: '#ffffff').

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

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

Cầu thủ trả bóng

String – Mã màu của nền.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getBackgroundObject()

Trả về màu nền của ô trên cùng bên trái trong dải ô.

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

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

Cầu thủ trả bóng

Color — Màu nền của ô trên cùng bên trái trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getBackgroundObjects()

Trả về màu nền của các ô trong dải ô.

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

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

Cầu thủ trả bóng

Color[][] – Một mảng màu nền hai chiều.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getBackgrounds()

Trả về màu nền của các ô trong dải ô (ví dụ: '#ffffff').

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

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

Cầu thủ trả bóng

String[][] – Một mảng mã màu hai chiều của nền.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getBandings()

Trả về tất cả dải được áp dụng cho bất kỳ ô nào trong dải ô này.

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

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

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

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

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

Cầu thủ trả bóng

Banding[] — Tất cả dải được áp dụng cho bất kỳ ô nào trong dải ô này.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getCell(row, column)

Trả về một ô đã cho trong một dải ô.

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

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

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

Tham số

Tên	Loại	Mô tả
row	Integer	Hàng của ô tương ứng với dải ô.
column	Integer	Cột của ô so với dải ô.

Cầu thủ trả bóng

Range — Dải ô chứa một ô duy nhất tại các toạ độ được chỉ định.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getColumn()

Trả về vị trí cột bắt đầu của dải ô này.

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

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

Cầu thủ trả bóng

Integer — Vị trí cột bắt đầu của dải ô trong bảng tính.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataRegion()

Trả về bản sao của dải ô được mở rộng trong bốn Direction chính để bao gồm tất cả các ô liền kề có chứa dữ liệu. Nếu dải ô được bao quanh bởi các ô trống không bao gồm các ô đó dọc theo các đường chéo, dải ô sẽ được trả về. Việc này tương tự như chọn dải ô đang nhập Ctrl+A vào trình chỉnh sửa.

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

Cầu thủ trả bóng

Range — Vùng dữ liệu của dải ô hoặc một dải ô cho toàn bộ bảng tính.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataRegion(dimension)

Trả về bản sao của dải ô được mở rộng Direction.UP và Direction.DOWN nếu giá trị phương diện được chỉ định là Dimension.ROWS hoặc Direction.NEXT và Direction.PREVIOUS nếu phương diện là Dimension.COLUMNS. Việc mở rộng phạm vi dựa trên việc phát hiện dữ liệu bên cạnh dải ô được sắp xếp như bảng. Phạm vi mở rộng bao phủ tất cả các ô liền kề có dữ liệu trong đó dọc theo kích thước được chỉ định, bao gồm cả bảng ranh giới. Nếu dải ô ban đầu được bao quanh bởi các ô trống dọc theo kích thước được chỉ định, chính dải ô được trả về. Phương thức này tương tự như chọn dải ô và nhập Ctrl+Space cho cột hoặc Shift+Space cho các hàng trong trình chỉnh sửa.

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

Tham số

Tên	Loại	Mô tả
dimension	Dimension	Phương diện mà theo đó để mở rộng phạm vi.

Cầu thủ trả bóng

Range – Vùng dữ liệu của dải ô hoặc dải ô bao gồm từng cột hoặc từng hàng được kéo dài bởi dải ô ban đầu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataSourceFormula()

Trả về DataSourceFormula cho ô đầu tiên trong dải ô hoặc null nếu ô không chứa công thức nguồn dữ liệu.

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

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

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

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

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

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

Cầu thủ trả bóng

DataSourceFormula — DataSourceFormula cho ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataSourceFormulas()

Trả về DataSourceFormula cho các ô trong dải ô.

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

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

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

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

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

Cầu thủ trả bóng

DataSourceFormula[] – Một mảng DataSourceFormula.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataSourcePivotTables()

Lấy tất cả bảng tổng hợp nguồn dữ liệu giao cắt với dải ô.

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

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

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

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

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

Cầu thủ trả bóng

DataSourcePivotTable[] – Danh sách các bảng tổng hợp nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataSourceTables()

Lấy tất cả bảng nguồn dữ liệu giao với dải ô.

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

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

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

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

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

Cầu thủ trả bóng

DataSourceTable[] – Danh sách các bảng nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataSourceUrl()

Trả về một URL cho dữ liệu trong dải ô này. URL này có thể được dùng để tạo biểu đồ và truy vấn.

Code.gs

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

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

piechart.html

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

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

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

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

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

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

Cầu thủ trả bóng

String – URL cho dải ô này dưới dạng nguồn dữ liệu có thể được truyền đến các API khác, chẳng hạn như biểu đồ.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataTable()

Trả về dữ liệu bên trong đối tượng này dưới dạng DataTable.

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

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

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

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

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

Cầu thủ trả bóng

DataTable – dữ liệu dưới dạng bảng dữ liệu.

---

getDataTable(firstRowIsHeader)

Trả về dữ liệu bên trong dải ô này dưới dạng DataTable.

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

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

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

Tham số

Tên	Loại	Mô tả
firstRowIsHeader	Boolean	Liệu có coi hàng đầu tiên là tiêu đề hay không.

Cầu thủ trả bóng

DataTable — Dữ liệu dưới dạng bảng dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataValidation()

Trả về quy tắc xác thực dữ liệu cho ô trên cùng bên trái trong dải ô. Nếu quy trình xác thực dữ liệu chưa hoàn tất đã được đặt trên ô, phương thức này sẽ trả về null.

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

Cầu thủ trả bóng

DataValidation — Quy tắc xác thực dữ liệu cho ô trên cùng bên trái trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDataValidations()

Trả về quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô. Nếu chưa xác thực dữ liệu đặt trên một ô cho trước, phương thức này sẽ trả về null cho vị trí của ô đó trong mảng.

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

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

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

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

Cầu thủ trả bóng

DataValidation[][] — Mảng hai chiều gồm các quy tắc xác thực dữ liệu được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDeveloperMetadata()

Lấy siêu dữ liệu nhà phát triển liên kết với dải ô này.

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

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

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

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

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

Cầu thủ trả bóng

DeveloperMetadata[] — Siêu dữ liệu nhà phát triển được liên kết với dải ô này.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDisplayValue()

Trả về giá trị hiển thị của ô trên cùng bên trái trong dải ô. Giá trị là String. Giá trị hiển thị có tính đến định dạng ngày, giờ và đơn vị tiền tệ, bao gồm các định dạng được chế độ cài đặt ngôn ngữ của bảng tính tự động áp dụng. Ô trống trả về giá trị rỗng .

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

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

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

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

Cầu thủ trả bóng

String — Giá trị xuất hiện trong ô này.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getDisplayValues()

Trả về lưới hình chữ nhật chứa các giá trị của dải ô này.

Trả về một mảng hai chiều gồm các giá trị được hiển thị, được lập chỉ mục theo hàng, sau đó là theo cột. Chiến lược phát hành đĩa đơn là các đối tượng String. Giá trị hiển thị có tính đến ngày, giờ và định dạng đơn vị tiền tệ, bao gồm cả các định dạng được ngôn ngữ của bảng tính áp dụng tự động cài đặt. Các ô trống được biểu thị bằng một chuỗi trống trong mảng. Hãy nhớ rằng khi một chỉ mục dải ô bắt đầu từ 1, 1, mảng JavaScript được lập chỉ mục từ [0][0].

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

Cầu thủ trả bóng

String[][] – Một mảng giá trị hai chiều.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFilter()

Trả về bộ lọc trên trang tính chứa dải ô này hoặc null nếu không có bộ lọc trên trang tính trang tính.

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

Cầu thủ trả bóng

Filter – Bộ lọc.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontColorObject()

Trả về màu phông chữ của ô ở góc trên cùng bên trái của dải ô.

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

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

Cầu thủ trả bóng

Color – Màu phông chữ của ô trên cùng bên trái trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontColorObjects()

Trả về màu phông chữ của các ô trong dải ô.

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

var results = range.getFontColorObjects();

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

Cầu thủ trả bóng

Color[][] – Một mảng màu phông chữ hai chiều được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontFamilies()

Trả về bộ phông chữ của các ô trong dải ô.

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

var results = range.getFontFamilies();

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

Cầu thủ trả bóng

String[][] – Một mảng hai chiều gồm các bộ phông chữ liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontFamily()

Trả về bộ phông chữ của ô ở góc trên cùng bên trái của dải ô.

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

Logger.log(range.getFontFamily());

Cầu thủ trả bóng

String — Bộ phông chữ của ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontLine()

Lấy kiểu đường kẻ của ô ở góc trên cùng bên trái của dải ô ('underline', 'line-through' hoặc 'none').

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

Logger.log(range.getFontLine());

Cầu thủ trả bóng

String — Dòng phông chữ.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontLines()

Lấy kiểu đường kẻ của ô trong dải ô ('underline', 'line-through' hoặc 'none').

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

var results = range.getFontLines();

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

Cầu thủ trả bóng

String[][] – Một mảng các dòng phông chữ hai chiều được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontSize()

Trả về kích thước phông chữ theo kích thước điểm của ô ở góc trên cùng bên trái của dải ô.

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

Logger.log(range.getFontSize());

Cầu thủ trả bóng

Integer — Cỡ chữ theo cỡ chữ.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontSizes()

Trả về kích thước phông chữ của các ô trong dải ô.

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

var results = range.getFontSizes();

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

Cầu thủ trả bóng

Integer[][] – Một mảng hai chiều kích thước phông chữ của văn bản được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontStyle()

Trả về kiểu phông chữ ('italic' hoặc 'normal') của ô ở trên cùng bên trái góc của dải ô.

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

Logger.log(range.getFontStyle());

Cầu thủ trả bóng

String – Kiểu phông chữ của văn bản trong ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontStyles()

Trả về kiểu phông chữ của các ô trong dải ô.

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

var results = range.getFontStyles();

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

Cầu thủ trả bóng

String[][] – Một mảng hai chiều gồm kiểu phông chữ của văn bản được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontWeight()

Trả về độ đậm phông chữ (bình thường/in đậm) của ô ở góc trên cùng bên trái của dải ô.

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

Logger.log(range.getFontWeight());

Cầu thủ trả bóng

String – Độ đậm phông chữ của văn bản trong ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontWeights()

Trả về độ đậm phông chữ của các ô trong dải ô.

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

var results = range.getFontWeights();

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

Cầu thủ trả bóng

String[][] – Một mảng hai chiều gồm độ đậm phông chữ của văn bản được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFormula()

Trả về công thức (ký hiệu A1) cho ô trên cùng bên trái của dải ô hoặc một chuỗi trống nếu ô trống hoặc không chứa công thức.

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

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

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

Cầu thủ trả bóng

String – Công thức của ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFormulaR1C1()

Trả về công thức (ký hiệu R1C1) cho một ô đã cho hoặc null nếu không có.

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

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

Cầu thủ trả bóng

String — Công thức trong ký hiệu R1C1.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFormulas()

Trả về công thức (ký hiệu A1) cho các ô trong dải ô. Các mục nhập trong mảng 2D có chuỗi trống cho các ô không có công thức.

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

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

Cầu thủ trả bóng

String[][] — Một mảng công thức hai chiều ở định dạng chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFormulasR1C1()

Trả về công thức (ký hiệu R1C1) cho các ô trong dải ô. Các mục nhập trong mảng 2D có null cho các ô không có công thức.

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

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

Cầu thủ trả bóng

String[][] — Một mảng công thức hai chiều trong ký hiệu R1C1.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getGridId()

Trả về mã nhận dạng lưới của trang tính mẹ của dải ô. Mã nhận dạng là các giá trị int không âm ngẫu nhiên.

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

Logger.log(range.getGridId());

Cầu thủ trả bóng

Integer — Mã nhận dạng lưới của trang tính mẹ.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getHeight()

Trả về chiều cao của dải ô.

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

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

Cầu thủ trả bóng

Integer – Chiều cao của dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getHorizontalAlignment()

Trả về căn chỉnh văn bản theo chiều ngang (trái/giữa/phải) của ô ở trên cùng bên trái góc của dải ô.

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

Logger.log(range.getHorizontalAlignment());

Cầu thủ trả bóng

String – Căn chỉnh theo chiều ngang của văn bản trong ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getHorizontalAlignments()

Trả về vị trí căn chỉnh theo chiều ngang của các ô trong dải ô.

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

var results = range.getHorizontalAlignments();

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

Cầu thủ trả bóng

String[][] – Một mảng hai chiều sắp xếp văn bản theo chiều ngang được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getLastColumn()

Trả về vị trí cột kết thúc.

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

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

Cầu thủ trả bóng

Integer — Vị trí cột kết thúc của dải ô trong bảng tính.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getLastRow()

Trả về vị trí hàng kết thúc.

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

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

Cầu thủ trả bóng

Integer — Vị trí hàng kết thúc của dải ô trong bảng tính.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getMergedRanges()

Trả về một mảng gồm các đối tượng Range đại diện cho các ô đã hợp nhất hoàn toàn trong dải ô hiện tại hoặc chứa ít nhất một ô trong dải ô hiện tại.

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

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

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

Cầu thủ trả bóng

Range[] – Một mảng gồm các đối tượng Range, đại diện cho các ô đã hợp nhất chồng chéo dải ô.

---

getNextDataCell(direction)

Bắt đầu từ ô trong cột và hàng đầu tiên của dải ô, trả về ô tiếp theo trong hướng đã cho là cạnh của một dải ô liền kề có dữ liệu trong đó hoặc ô ở cạnh của bảng tính theo hướng đó. Điều này tương đương với việc nhập Ctrl+[arrow key] vào trình chỉnh sửa.

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

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

Tham số

Tên	Loại	Mô tả
direction	Direction	Hướng tìm ô cạnh của khu vực lưu trữ dữ liệu tiếp theo.

Cầu thủ trả bóng

Range — Ô cạnh vùng dữ liệu hoặc ô ở cạnh của bảng tính.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getNote()

Trả về ghi chú liên kết với dải ô cho sẵn.

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

Logger.log(range.getNote());

Cầu thủ trả bóng

String — Ghi chú liên kết với ô đã cho.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getNotes()

Trả về các ghi chú liên kết với các ô trong dải ô.

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

var results = range.getNotes();

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

Cầu thủ trả bóng

String[][] — Một mảng ghi chú hai chiều được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getNumColumns()

Trả về số lượng cột trong dải ô này.

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

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

Cầu thủ trả bóng

Integer — Số cột trong dải ô này.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getNumRows()

Trả về số lượng hàng trong dải ô này.

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

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

Cầu thủ trả bóng

Integer — Số hàng trong dải ô này.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getNumberFormat()

Lấy định dạng số hoặc ngày của ô trên cùng bên trái của dải ô cho sẵn. Định dạng được trả về các mẫu được mô tả trong API Trang tính .

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

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

Cầu thủ trả bóng

String — Định dạng số của ô trên cùng bên trái của dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getNumberFormats()

Trả về định dạng số hoặc ngày tháng cho các ô trong dải ô. Mẫu định dạng được trả về là được mô tả trong tài liệu về API Trang tính.

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

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

Cầu thủ trả bóng

String[][] – Một mảng hai chiều gồm các định dạng số.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getRichTextValue()

Trả về giá trị Văn bản đa dạng thức cho ô trên cùng bên trái của dải ô hoặc null nếu ô giá trị không phải là văn bản.

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

Cầu thủ trả bóng

RichTextValue — Giá trị văn bản đa dạng thức của ô trên cùng bên trái trong dải ô hoặc null nếu ô giá trị không phải là văn bản.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getRichTextValues()

Trả về giá trị Văn bản đa dạng thức cho các ô trong dải ô.

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

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

Cầu thủ trả bóng

RichTextValue[][] — Một mảng hai chiều gồm các giá trị Văn bản đa dạng thức.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getRow()

Trả về vị trí hàng cho dải ô này. Giống hệt với getRowIndex().

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

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

Cầu thủ trả bóng

Integer – Vị trí hàng của dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getRowIndex()

Trả về vị trí hàng cho dải ô này. Giống hệt với getRow().

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

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

Cầu thủ trả bóng

Integer – Vị trí hàng của dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getRow()

---

getSheet()

Trả về trang tính chứa dải ô này.

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

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

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

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

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

Cầu thủ trả bóng

Sheet — Trang tính chứa dải ô này.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getTextDirection()

Trả về hướng văn bản cho ô trên cùng bên trái của dải ô. Trả về null nếu ô hướng văn bản được xác định bằng tính năng tự động phát hiện.

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

Cầu thủ trả bóng

TextDirection — Hướng văn bản của ô trên cùng bên trái trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getTextDirections()

Trả về hướng văn bản cho các ô trong dải ô. Các mục nhập trong mảng 2D là null cho các ô sử dụng tính năng tự động phát hiện.

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

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

Cầu thủ trả bóng

TextDirection[][] – Một mảng hai chiều chứa hướng văn bản.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getTextRotation()

Trả về chế độ cài đặt xoay văn bản cho ô trên cùng bên trái của dải ô.

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

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

Cầu thủ trả bóng

TextRotation — Chế độ cài đặt xoay văn bản.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getTextRotations()

Trả về chế độ cài đặt xoay văn bản cho các ô trong dải ô.

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

var results = range.getTextRotations();

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

Cầu thủ trả bóng

TextRotation[][] – Một mảng hai chiều xoay văn bản được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getTextStyle()

Trả về kiểu văn bản cho ô trên cùng bên trái của dải ô.

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

Cầu thủ trả bóng

TextStyle — Kiểu văn bản của ô trên cùng bên trái trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getTextStyles()

Trả về kiểu văn bản cho các ô trong dải ô.

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

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

Cầu thủ trả bóng

TextStyle[][] – Một mảng hai chiều của kiểu văn bản.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getValue()

Trả về giá trị của ô trên cùng bên trái trong dải ô. Giá trị có thể thuộc loại Number, Boolean, Date hoặc String tuỳ thuộc vào giá trị của ô. Hết pin các ô trả về một chuỗi trống.

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

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

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

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

Cầu thủ trả bóng

Object — Giá trị trong ô này.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getValues()

Trả về lưới hình chữ nhật chứa các giá trị của dải ô này.

Trả về một mảng các giá trị hai chiều, được lập chỉ mục theo hàng, sau đó là theo cột. Các giá trị có thể là thuộc loại Number, Boolean, Date hoặc String, tuỳ thuộc vào giá trị của ô. Các ô trống được biểu thị bằng một chuỗi trống trong mảng. Hãy nhớ rằng trong khi chỉ mục dải ô bắt đầu từ 1, 1, mảng JavaScript được lập chỉ mục từ [0][0].

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

Trong ứng dụng web, giá trị Date không phải là tham số hợp pháp. Không thể trả lại getValues() dữ liệu cho một ứng dụng web nếu dải ô chứa một ô có giá trị Date. Thay vào đó, hãy biến đổi tất cả các giá trị được truy xuất từ trang tính tới một JavaScript nguyên gốc được hỗ trợ như Number, Boolean hoặc String.

Cầu thủ trả bóng

Object[][] – Một mảng giá trị hai chiều.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getVerticalAlignment()

Trả về căn chỉnh dọc (trên cùng/ở giữa/dưới cùng) của ô ở góc trên cùng bên trái của dải ô.

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

Logger.log(range.getVerticalAlignment());

Cầu thủ trả bóng

String — Căn chỉnh theo chiều dọc của văn bản trong ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getVerticalAlignments()

Trả về căn chỉnh dọc của các ô trong dải ô.

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

var results = range.getVerticalAlignments();

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

Cầu thủ trả bóng

String[][] — Một mảng hai chiều sắp xếp văn bản theo chiều dọc được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getWidth()

Trả về chiều rộng của dải ô trong cột.

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

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

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

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

Cầu thủ trả bóng

Integer — Số cột trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getWrap()

Trả về xem văn bản trong ô có được xuống dòng tự động hay không. Để có chiến lược tổng hợp chi tiết hơn, hãy sử dụng getWrapStrategy().

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

Logger.log(range.getWrap());

Cầu thủ trả bóng

Boolean — Liệu văn bản trong ô này có bị xuống dòng hay không.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getWrapStrategies()

Trả về chiến lược xuống dòng tự động cho các ô trong dải ô.

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

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

Cầu thủ trả bóng

WrapStrategy[][] – Một mảng hai chiều của các chiến lược gói văn bản.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getWrapStrategy()

Trả về chiến lược xuống dòng tự động cho ô trên cùng bên trái của dải ô.

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

Cầu thủ trả bóng

WrapStrategy — Chiến lược xuống dòng tự động của ô trên cùng bên trái trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getWraps()

Trả về xem văn bản trong ô có được xuống dòng hay không. Để có chiến lược tổng hợp chi tiết hơn, hãy sử dụng getWrapStrategies().

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

var results = range.getVerticalAlignments();

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

Cầu thủ trả bóng

Boolean[][] — Một mảng hai chiều sắp xếp văn bản theo chiều dọc được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

insertCells(shiftDimension)

Chèn các ô trống vào dải ô này. Các ô mới giữ lại mọi định dạng có trong các ô trước đó chiếm dải ô này. Dữ liệu hiện có trong trang tính cùng với phương diện được cung cấp là dịch chuyển ra khỏi dải ô được chèn.

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

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

Tham số

Tên	Loại	Mô tả
shiftDimension	Dimension	Phương diện mà theo đó, bạn sẽ chuyển dữ liệu hiện có.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

insertCheckboxes()

Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng true cho các ô đã đánh dấu và Bỏ đánh dấu false. Đặt giá trị của tất cả các ô trong dải ô thành false.

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

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

insertCheckboxes(checkedValue)

Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng một giá trị tuỳ chỉnh cho trạng thái đã đánh dấu và chuỗi trống để bỏ đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành chuỗi trống.

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

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

Tham số

Tên	Loại	Mô tả
checkedValue	Object	Giá trị được đánh dấu để xác thực dữ liệu của hộp đánh dấu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

insertCheckboxes(checkedValue, uncheckedValue)

Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình bằng các giá trị tuỳ chỉnh cho ô đã đánh dấu và các trạng thái chưa đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành giá trị tuỳ chỉnh không đánh dấu.

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

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

Tham số

Tên	Loại	Mô tả
checkedValue	Object	Giá trị được đánh dấu để xác thực dữ liệu của hộp đánh dấu.
uncheckedValue	Object	Giá trị không được chọn cho việc xác thực dữ liệu hộp đánh dấu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

isBlank()

Trả về true nếu dải ô hoàn toàn trống.

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

Logger.log(range.isBlank());

Cầu thủ trả bóng

Boolean – true nếu dải ô trống; false.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

isChecked()

Trả về xem liệu tất cả các ô trong dải ô có trạng thái hộp đánh dấu là "đã đánh dấu" hay không. Trả về null nếu một số ô được đánh dấu và các ô còn lại không có hộp đánh dấu hoặc nếu một số ô không có hộp đánh dấu xác thực dữ liệu.

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

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

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

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

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

Cầu thủ trả bóng

Boolean — true, nếu tất cả các ô trong dải ô được đánh dấu, false nếu tất cả các ô trong đã bỏ chọn dải ô hoặc null nếu có bất kỳ ô nào chưa được bỏ chọn hoặc không có xác thực dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

isEndColumnBounded()

Xác định xem điểm cuối của dải ô có liên kết với một cột cụ thể hay không. Ví dụ: đối với trường dải ô A1:B10 hoặc B:B, được liên kết với các cột ở cuối dải ô, phương thức trả về true; cho các dải ô 3:7 hoặc A1:5, chỉ được giới hạn vào các hàng cụ thể ở cuối dải ô, phương thức này sẽ trả về false.

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

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

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

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

Cầu thủ trả bóng

Boolean — true nếu điểm kết thúc của dải ô được liên kết với một cột cụ thể; false nếu không.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

isEndRowBounded()

Xác định xem điểm cuối của dải ô có liên kết với một hàng cụ thể hay không. Ví dụ: đối với trường dải ô A1:B10 hoặc 3:7, được liên kết với các hàng ở cuối dải ô, phương thức trả về true; cho các dải ô B:B hoặc A1:C (chỉ được ràng buộc) vào các cột cụ thể ở cuối dải ô, phương thức này sẽ trả về false.

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

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

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

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

Cầu thủ trả bóng

Boolean — true nếu điểm kết thúc của dải ô được liên kết với một hàng cụ thể; false nếu không.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

isPartOfMerge()

Trả về true nếu các ô trong dải ô hiện tại chồng chéo lên bất kỳ ô đã hợp nhất nào.

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

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

// True if any of the cells in A1:B3 is included in a merge.
var isPartOfMerge = range.isPartOfMerge();

Cầu thủ trả bóng

Boolean – true nếu dải ô chồng chéo với bất kỳ ô đã hợp nhất nào, nếu không sẽ trả về false.

---

isStartColumnBounded()

Xác định xem điểm bắt đầu của dải ô có được liên kết với một cột cụ thể hay không. Ví dụ: đối với trường dải ô A1:B10 hoặc B:B, được liên kết với các cột ở đầu dải ô, phương thức này trả về true; cho dải ô 3:7, chỉ được liên kết với một hàng tại đầu dải ô, phương thức này sẽ trả về false.

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

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

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

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

Cầu thủ trả bóng

Boolean — true nếu điểm bắt đầu của dải ô được liên kết với một cột cụ thể; false nếu không.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

isStartRowBounded()

Xác định xem điểm bắt đầu của dải ô có được liên kết với một hàng cụ thể hay không. Ví dụ: đối với trường dải ô A1:B10 hoặc 3:7, được liên kết với các hàng ở đầu dải ô, phương thức trả về true; cho phạm vi B:B, chỉ được ràng buộc với một thuộc tính cụ thể ở đầu dải ô, phương thức này sẽ trả về false.

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

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

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

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

Cầu thủ trả bóng

Boolean — true nếu điểm bắt đầu của dải ô được liên kết với một hàng cụ thể; false nếu không.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

merge()

Hợp nhất các ô trong dải ô với nhau thành một khối duy nhất.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

mergeAcross()

Hợp nhất các ô trong dải ô trên các cột của dải ô.

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

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

mergeVertically()

Hợp nhất các ô trong dải ô với nhau.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

moveTo(target)

Cắt và dán (cả định dạng và giá trị) từ dải ô này vào dải ô đích.

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

Tham số

Tên	Loại	Mô tả
target	Range	Một dải ô mục tiêu để sao chép dải ô này; chỉ vị trí ô trên cùng bên trái là phù hợp.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

offset(rowOffset, columnOffset)

Trả về một dải ô mới được bù trừ từ dải ô này theo số hàng và cột cho trước (có thể mang giá trị âm). Dải ô mới có cùng kích thước với dải ô ban đầu.

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

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

Tham số

Tên	Loại	Mô tả
rowOffset	Integer	Số hàng giảm xuống tính từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các hàng lên từ ô trên cùng bên trái của dải ô.
columnOffset	Integer	Số cột bên phải từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các cột bên trái từ ô trên cùng bên trái của dải ô.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

---

offset(rowOffset, columnOffset, numRows)

Trả về một dải ô mới tương ứng với dải ô hiện tại có điểm trên bên trái được bù trừ từ dải ô hiện tại theo hàng và cột đã cho và theo chiều cao đã cho tính theo ô.

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

var cell = sheet.getRange("A1");

// newCell references B2:B3
var newRange = cell.offset(1, 1, 2);

Tham số

Tên	Loại	Mô tả
rowOffset	Integer	Số hàng giảm xuống tính từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các hàng lên từ ô trên cùng bên trái của dải ô.
columnOffset	Integer	Số cột bên phải từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các cột bên trái từ ô trên cùng bên trái của dải ô.
numRows	Integer	Chiều cao theo hàng của dải ô mới.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

---

offset(rowOffset, columnOffset, numRows, numColumns)

Trả về một dải ô mới tương ứng với dải ô hiện tại có điểm trên bên trái được bù trừ từ dải ô hiện tại theo hàng và cột đã cho và với chiều cao và chiều rộng đã cho ô.

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

var cell = sheet.getRange("A1");

// newCell references B2:C3
var newRange = cell.offset(1, 1, 2, 2);

Tham số

Tên	Loại	Mô tả
rowOffset	Integer	Số hàng giảm xuống tính từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các hàng lên từ ô trên cùng bên trái của dải ô.
columnOffset	Integer	Số cột bên phải từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các cột bên trái từ ô trên cùng bên trái của dải ô.
numRows	Integer	Chiều cao theo hàng của dải ô mới.
numColumns	Integer	Chiều rộng trong các cột của dải ô mới.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

---

protect()

Tạo một đối tượng có thể bảo vệ dải ô không bị chỉnh sửa, ngoại trừ những người dùng đã quyền. Cho đến khi tập lệnh thực sự thay đổi danh sách trình chỉnh sửa cho dải ô (bằng cách gọi Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) hoặc đặt một chế độ cài đặt mới cho Protection.setDomainEdit(editable)), thì quyền này cũng phản ánh các quyền của bảng tính, điều này có nghĩa là dải ô vẫn không được bảo vệ. Nếu dải ô là đã được bảo vệ, phương thức này sẽ tạo một dải ô được bảo vệ mới chồng chéo với dải ô hiện có. Nếu một ô được bảo vệ bởi nhiều dải ô được bảo vệ và dải ô bất kỳ trong số đó ngăn một người dùng cụ thể chỉnh sửa ô thì người dùng đó không được phép chỉnh sửa ô.

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Cầu thủ trả bóng

Protection – Đối tượng đại diện cho các chế độ cài đặt bảo vệ.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

randomize()

Sắp xếp ngẫu nhiên thứ tự của các hàng trong dải ô cho sẵn.

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

// Randomizes the range
range.randomize();

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

removeCheckboxes()

Xoá tất cả hộp đánh dấu khỏi dải ô. Xoá thông tin xác thực dữ liệu của từng ô, và sẽ xoá thêm giá trị nếu ô chứa giá trị đã đánh dấu hoặc bỏ đánh dấu.

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

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

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

removeDuplicates()

Xóa các hàng trong dải ô này có chứa các giá trị trùng lặp với các giá trị trong bất kỳ hàng trước đó. Các hàng có giá trị giống hệt nhau nhưng khác kiểu chữ, định dạng hoặc công thức đều được coi là trùng lặp. Phương thức này cũng xoá các hàng trùng lặp bị ẩn khỏi chế độ xem (đối với do bộ lọc). Nội dung nằm ngoài phạm vi này sẽ không bị xoá.

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

// Remove duplicate rows in the range.
range.removeDuplicates();

Cầu thủ trả bóng

Range — Dải ô thu được sau khi xoá các giá trị trùng lặp. Kích thước của phạm vi được giảm đi hàng cho mỗi hàng bị xóa.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

removeDuplicates(columnsToCompare)

Xóa các hàng trong dải ô này có chứa giá trị trùng lặp trong các cột được chỉ định giá trị bất kỳ hàng nào trước đó. Các hàng có giá trị giống hệt nhau nhưng kiểu chữ, định dạng hoặc công thức bị coi là trùng lặp. Phương thức này cũng loại bỏ các hàng trùng lặp bị ẩn khỏi chế độ xem (ví dụ: do bộ lọc). Nội dung nằm ngoài phạm vi này sẽ không bị xoá.

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

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2,4]);

Tham số

Tên	Loại	Mô tả
columnsToCompare	Integer[]	Các cột cần phân tích để tìm giá trị trùng lặp. Nếu không có cột nào được cung cấp thì tất cả các cột sẽ được phân tích để tìm trùng lặp.

Cầu thủ trả bóng

Range — Dải ô thu được sau khi xoá các giá trị trùng lặp. Kích thước của phạm vi được giảm đi hàng cho mỗi hàng bị xóa.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setBackground(color)

Đặt màu nền của tất cả các ô trong dải ô trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

var range = sheet.getRange("B2:D5");
range.setBackground("red");

Tham số

Tên	Loại	Mô tả
color	String	Mã màu trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white'); một Giá trị null đặt lại màu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setBackgroundObject(color)

Đặt màu nền của tất cả các ô trong dải ô.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

Tham số

Tên	Loại	Mô tả
color	Color	Màu nền cần đặt; Giá trị null được đặt lại màu nền.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setBackgroundObjects(color)

Thiết lập một lưới hình chữ nhật có màu nền (phải khớp với kích thước của dải ô này).

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

Tham số

Tên	Loại	Mô tả
color	Color[][]	Một mảng màu hai chiều; Các giá trị của null đã đặt lại màu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setBackgroundRGB(red, green, blue)

Đặt nền thành màu đã cho bằng cách sử dụng các giá trị RGB (bao gồm các số nguyên từ 0 đến 255).

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

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

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

Tham số

Tên	Loại	Mô tả
red	Integer	Giá trị màu đỏ trong ký hiệu RGB.
green	Integer	Giá trị màu xanh lục trong ký hiệu RGB.
blue	Integer	Giá trị màu xanh dương trong ký hiệu RGB.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setBackgrounds(color)

Thiết lập một lưới hình chữ nhật có màu nền (phải khớp với kích thước của dải ô này). Màu sắc nằm trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

Tham số

Tên	Loại	Mô tả
color	String[][]	Một mảng màu hai chiều trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white'); Các giá trị null đã đặt lại màu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setBorder(top, left, bottom, right, vertical, horizontal)

Đặt thuộc tính đường viền. Các giá trị hợp lệ là true (bật), false (tắt) và null (không thay đổi).

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

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

Tham số

Tên	Loại	Mô tả
top	Boolean	true cho đường viền, false để không thay đổi, null để không thay đổi.
left	Boolean	true cho đường viền, false để không thay đổi, null để không thay đổi.
bottom	Boolean	true cho đường viền, false để không thay đổi, null để không thay đổi.
right	Boolean	true cho đường viền, false để không thay đổi, null để không thay đổi.
vertical	Boolean	true cho đường viền dọc bên trong, false để không thay đổi, null để không thay đổi.
horizontal	Boolean	true cho đường viền ngang bên trong, false cho đường viền không có, null để không thay đổi.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

Đặt thuộc tính đường viền bằng màu và/hoặc kiểu. Các giá trị hợp lệ là true (bật), false (tắt) và null (không thay đổi). Đối với màu sắc, hãy sử dụng Màu trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);

Tham số

Tên	Loại	Mô tả
top	Boolean	true cho đường viền, false để không thay đổi, null để không thay đổi.
left	Boolean	true cho đường viền, false để không thay đổi, null để không thay đổi.
bottom	Boolean	true cho đường viền, false để không thay đổi, null để không thay đổi.
right	Boolean	true cho đường viền, false để không thay đổi, null để không thay đổi.
vertical	Boolean	true cho đường viền dọc bên trong, false để không thay đổi, null để không thay đổi.
horizontal	Boolean	true cho đường viền ngang bên trong, false cho đường viền không có, null để không thay đổi.
color	String	Một màu trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white'), null cho màu mặc định (đen).
style	BorderStyle	Kiểu cho đường viền, null cho kiểu mặc định (cố định).

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setDataValidation(rule)

Đặt một quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô.

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Tham số

Tên	Loại	Mô tả
rule	DataValidation	Quy tắc xác thực dữ liệu cần đặt hoặc null để xoá quy tắc xác thực dữ liệu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setDataValidations(rules)

Đặt quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô. Phương thức này lấy dữ liệu hai chiều mảng xác thực dữ liệu, được lập chỉ mục theo hàng rồi theo cột. Các chiều của mảng phải tương ứng với nhau cho kích thước phạm vi.

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Tham số

Tên	Loại	Mô tả
rules	DataValidation[][]	Mảng hai chiều gồm các quy tắc xác thực dữ liệu cần thiết lập; Giá trị null xoá quy tắc xác thực dữ liệu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontColor(color)

Đặt màu phông chữ trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

var cell = sheet.getRange("B2");
cell.setFontColor("red");

Tham số

Tên	Loại	Mô tả
color	String	Màu phông chữ trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white'); một Giá trị null đặt lại màu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontColorObject(color)

Đặt màu phông chữ của dải ô đã cho.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

Tham số

Tên	Loại	Mô tả
color	Color	Màu phông chữ cần đặt; giá trị null sẽ đặt lại màu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontColorObjects(colors)

Thiết lập một lưới hình chữ nhật có màu phông chữ (phải khớp với kích thước của dải ô này).

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

Tham số

Tên	Loại	Mô tả
colors	Color[][]	Một mảng màu hai chiều; Các giá trị của null sẽ đặt lại màu phông chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontColors(colors)

Thiết lập một lưới hình chữ nhật có màu phông chữ (phải khớp với kích thước của dải ô này). Các màu hiện có Ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

Tham số

Tên	Loại	Mô tả
colors	Object[][]	Một mảng màu hai chiều trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white'); Các giá trị null đã đặt lại màu.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontFamilies(fontFamilies)

Thiết lập một lưới hình chữ nhật của bộ phông chữ (phải khớp với kích thước của dải ô này). Ví dụ về bộ phông chữ là "vi" hoặc "WIDTH".

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

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

Tham số

Tên	Loại	Mô tả
fontFamilies	Object[][]	Một mảng hai chiều gồm các họ phông chữ; Các giá trị của null đã đặt lại bộ phông chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontFamily(fontFamily)

Đặt bộ phông chữ, chẳng hạn như "vi" hoặc "WIDTH".

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

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

Tham số

Tên	Loại	Mô tả
fontFamily	String	Bộ phông chữ cần đặt; giá trị null sẽ đặt lại bộ phông chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontLine(fontLine)

Đặt kiểu dòng phông chữ của dải ô đã cho ('underline', 'line-through' hoặc 'none').

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

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

Tham số

Tên	Loại	Mô tả
fontLine	String	Kiểu dòng phông chữ, 'underline', 'line-through' hoặc 'none'; một giá trị null đặt lại kiểu dòng phông chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontLines(fontLines)

Thiết lập một lưới hình chữ nhật cho các kiểu đường kẻ (phải khớp với kích thước của dải ô này).

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

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

Tham số

Tên	Loại	Mô tả
fontLines	Object[][]	Một mảng hai chiều của các kiểu dòng phông chữ ('underline', 'line-through' hoặc 'none'); Các giá trị null sẽ đặt lại kiểu dòng phông chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontSize(size)

Đặt kích thước phông chữ, trong đó kích thước là kích thước điểm sẽ sử dụng.

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

var cell = sheet.getRange("B2");
cell.setFontSize(20);

Tham số

Tên	Loại	Mô tả
size	Integer	Cỡ chữ theo cỡ chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontSizes(sizes)

Thiết lập một lưới hình chữ nhật có kích thước phông chữ (phải khớp với kích thước của dải ô này). Kích thước tính theo .

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

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

Tham số

Tên	Loại	Mô tả
sizes	Object[][]	Một mảng kích thước hai chiều.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontStyle(fontStyle)

Đặt kiểu phông chữ cho dải ô đã cho ('italic' hoặc 'normal').

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

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

Tham số

Tên	Loại	Mô tả
fontStyle	String	Kiểu phông chữ 'italic' hoặc 'normal'; một null sẽ đặt lại kiểu phông chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontStyles(fontStyles)

Thiết lập một lưới hình chữ nhật cho các kiểu phông chữ (phải khớp với kích thước của dải ô này).

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

Tham số

Tên	Loại	Mô tả
fontStyles	Object[][]	Một mảng hai chiều của kiểu phông chữ, 'italic' hoặc 'normal'; Các giá trị null sẽ đặt lại kiểu phông chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontWeight(fontWeight)

Đặt độ đậm phông chữ cho dải ô nhất định (bình thường/in đậm).

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

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

Tham số

Tên	Loại	Mô tả
fontWeight	String	Độ đậm phông chữ, 'bold' hoặc 'normal'; một null sẽ đặt lại độ đậm phông chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFontWeights(fontWeights)

Thiết lập một lưới hình chữ nhật có độ đậm phông chữ (phải khớp với kích thước của dải ô này). Ví dụ về độ đậm phông chữ là "in đậm".

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

Tham số

Tên	Loại	Mô tả
fontWeights	Object[][]	Một mảng hai chiều về độ đậm phông chữ, 'bold' hoặc 'normal'; Các giá trị null sẽ đặt lại độ đậm phông chữ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFormula(formula)

Cập nhật công thức cho dải ô này. Công thức đã cho phải nằm trong ký hiệu A1.

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

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

Tham số

Tên	Loại	Mô tả
formula	String	Một chuỗi đại diện cho công thức cần đặt cho ô.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFormulaR1C1(formula)

Cập nhật công thức cho dải ô này. Công thức đã cho phải ở dạng ký hiệu R1C1.

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

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

Tham số

Tên	Loại	Mô tả
formula	String	Công thức chuỗi.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFormulas(formulas)

Thiết lập một lưới hình chữ nhật cho các công thức (phải khớp với kích thước của dải ô này). Các công thức đã cho phải ở trong ký hiệu A1. Phương thức này lấy một mảng công thức hai chiều, được lập chỉ mục theo hàng, rồi theo cột. Kích thước mảng phải tương ứng với kích thước dải ô.

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

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

Tham số

Tên	Loại	Mô tả
formulas	String[][]	Một mảng chuỗi hai chiều của công thức.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setFormulasR1C1(formulas)

Thiết lập một lưới hình chữ nhật cho các công thức (phải khớp với kích thước của dải ô này). Các công thức đã cho phải ở trong ký hiệu R1C1.

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

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Tham số

Tên	Loại	Mô tả
formulas	String[][]	Một mảng công thức hai chiều ở định dạng R1C1.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setHorizontalAlignment(alignment)

Thiết lập cách căn chỉnh ngang (từ trái sang phải) cho dải ô cho sẵn (trái/giữa/phải).

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

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

Tham số

Tên	Loại	Mô tả
alignment	String	Cách căn chỉnh, 'left', 'center' hoặc 'normal'; một Giá trị null đặt lại căn chỉnh.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setHorizontalAlignments(alignments)

Thiết lập lưới hình chữ nhật căn chỉnh ngang. xem setHorizontalAlignment(alignment)

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

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

Tham số

Tên	Loại	Mô tả
alignments	Object[][]	Một mảng căn chỉnh hai chiều, 'left', 'center' hoặc 'normal'; giá trị null sẽ đặt lại căn chỉnh.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• setHorizontalAlignment(alignment)

---

setNote(note)

Đặt ghi chú thành giá trị đã cho.

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

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

Tham số

Tên	Loại	Mô tả
note	String	Giá trị ghi chú cần đặt cho dải ô; giá trị null sẽ xoá ghi chú đó.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setNotes(notes)

Thiết lập một lưới hình chữ nhật ghi chú (phải khớp với kích thước của dải ô này).

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

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

Tham số

Tên	Loại	Mô tả
notes	Object[][]	Một mảng ghi chú hai chiều; null giá trị sẽ xoá ghi chú.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• setNote(note)

---

setNumberFormat(numberFormat)

Đặt định dạng số hoặc ngày thành chuỗi định dạng cho sẵn. Dưới đây là các mẫu định dạng được chấp nhận được mô tả trong tài liệu về API Trang tính.

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

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

Tham số

Tên	Loại	Mô tả
numberFormat	String	Chuỗi định dạng số.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setNumberFormats(numberFormats)

Đặt một lưới hình chữ nhật có định dạng số hoặc ngày (phải khớp với kích thước của phạm vi này). Chiến lược phát hành đĩa đơn các giá trị là chuỗi mẫu định dạng như được mô tả trong Tài liệu về API Trang tính.

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

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

Tham số

Tên	Loại	Mô tả
numberFormats	Object[][]	Một mảng hai chiều gồm các định dạng số.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setRichTextValue(value)

Đặt giá trị Văn bản đa dạng thức cho các ô trong dải ô.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

Tham số

Tên	Loại	Mô tả
value	RichTextValue	Giá trị văn bản đa dạng thức mà bạn muốn.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setRichTextValues(values)

Thiết lập một lưới hình chữ nhật chứa các giá trị Văn bản đa dạng thức.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Tham số

Tên	Loại	Mô tả
values	RichTextValue[][]	Các giá trị Văn bản đa dạng thức mà bạn muốn.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setShowHyperlink(showHyperlink)

Thiết lập xem dải ô có hiển thị siêu liên kết hay không.

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

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

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

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

Tham số

Tên	Loại	Mô tả
showHyperlink	Boolean	Liệu có hiển thị siêu liên kết hay không.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setTextDirection(direction)

Thiết lập hướng văn bản cho các ô trong dải ô. Nếu hướng được chỉ định là null, hướng được suy ra rồi đặt.

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Tham số

Tên	Loại	Mô tả
direction	TextDirection	Hướng văn bản mong muốn; nếu null, hướng được suy luận trước cài đặt.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setTextDirections(directions)

Thiết lập một lưới hình chữ nhật chứa hướng văn bản. Nếu hướng được chỉ định là null, thì hướng được suy ra rồi đặt.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

Tham số

Tên	Loại	Mô tả
directions	TextDirection[][]	Hướng văn bản mong muốn; nếu một hướng được chỉ định là null thì suy luận trước khi cài đặt.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setTextRotation(degrees)

Thiết lập chế độ xoay văn bản cho các ô trong dải ô. Giá trị đầu vào tương ứng với góc giữa hướng văn bản chuẩn và hướng mong muốn. Giá trị nhập bằng 0 cho biết văn bản được đặt theo hướng chuẩn.

Để hướng văn bản từ trái sang phải, các góc dương là ngược chiều kim đồng hồ, còn từ phải sang trái thì xoay theo chiều kim đồng hồ.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

Tham số

Tên	Loại	Mô tả
degrees	Integer	Góc mong muốn giữa hướng chuẩn và hướng mong muốn. Đối với văn bản từ trái sang phải, các góc dương sẽ ngược chiều kim đồng hồ.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setTextRotation(rotation)

Thiết lập chế độ xoay văn bản cho các ô trong dải ô.

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

Tham số

Tên	Loại	Mô tả
rotation	TextRotation	Chế độ cài đặt xoay văn bản mong muốn.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setTextRotations(rotations)

Thiết lập một lưới hình chữ nhật xoay văn bản.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

Tham số

Tên	Loại	Mô tả
rotations	TextRotation[][]	Chế độ cài đặt xoay văn bản mong muốn.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setTextStyle(style)

Đặt kiểu văn bản cho các ô trong dải ô.

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Tham số

Tên	Loại	Mô tả
style	TextStyle	Kiểu văn bản mong muốn.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setTextStyles(styles)

Thiết lập lưới hình chữ nhật chứa kiểu văn bản.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

Tham số

Tên	Loại	Mô tả
styles	TextStyle[][]	Kiểu văn bản mong muốn.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setValue(value)

Đặt giá trị cho dải ô. Giá trị có thể là số, chuỗi, boolean hoặc ngày. Nếu sự kiện bắt đầu với '=' thì nó được hiểu là một công thức.

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

var cell = sheet.getRange("B2");
cell.setValue(100);

Tham số

Tên	Loại	Mô tả
value	Object	Giá trị cho dải ô.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setValues(values)

Thiết lập một lưới hình chữ nhật chứa các giá trị (phải khớp với kích thước của dải ô này). Nếu một giá trị bắt đầu bằng =, biến này được hiểu là một công thức.

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

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

Tham số

Tên	Loại	Mô tả
values	Object[][]	Một mảng giá trị hai chiều.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setVerticalAlignment(alignment)

Đặt căn chỉnh dọc (trên cùng xuống dưới) cho dải ô cho trước (trên/giữa/dưới cùng).

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

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

Tham số

Tên	Loại	Mô tả
alignment	String	Cách căn chỉnh, 'top', 'middle' hoặc 'bottom'; một Giá trị null đặt lại căn chỉnh.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setVerticalAlignments(alignments)

Thiết lập một lưới hình chữ nhật căn chỉnh dọc (phải khớp với kích thước của dải ô này).

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

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

Tham số

Tên	Loại	Mô tả
alignments	Object[][]	Một mảng căn chỉnh hai chiều, có thể là 'top' hoặc 'middle' hoặc 'bottom'; giá trị null sẽ đặt lại căn chỉnh.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• setVerticalAlignment(alignment)

---

setVerticalText(isVertical)

Đặt xem có xếp chồng văn bản cho các ô trong dải ô hay không. Nếu văn bản bị xếp chồng theo chiều dọc, thì chế độ xoay văn bản độ sẽ bị bỏ qua.

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

Tham số

Tên	Loại	Mô tả
isVertical	Boolean	Liệu có xếp chồng văn bản hay không.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setWrap(isWrapEnabled)

Đặt xuống dòng tự động của dải ô đã cho.

Các ô đã bật tính năng bao bọc (mặc định) sẽ đổi kích thước để hiển thị toàn bộ nội dung. Ô được xuống dòng đã tắt chế độ hiển thị nhiều nhất có thể trong ô mà không đổi kích thước hoặc xuất hiện nhiều dòng.

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

var cell = sheet.getRange("B2");
cell.setWrap(true);

Tham số

Tên	Loại	Mô tả
isWrapEnabled	Boolean	Có gói văn bản hay không.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setWrapStrategies(strategies)

Thiết lập một lưới hình chữ nhật cho các chiến lược bao bọc.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

Tham số

Tên	Loại	Mô tả
strategies	WrapStrategy[][]	Chiến lược xuống dòng mong muốn.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setWrapStrategy(strategy)

Đặt chiến lược xuống dòng tự động cho các ô trong dải ô.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Tham số

Tên	Loại	Mô tả
strategy	WrapStrategy	Chiến lược xuống dòng mong muốn.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

setWraps(isWrapEnabled)

Thiết lập một lưới hình chữ nhật cho các chính sách xuống dòng tự động (phải khớp với kích thước của dải ô này). Ô có đã bật tính năng bao bọc (mặc định) để đổi kích thước để hiển thị toàn bộ nội dung. Đã tắt tính năng xuống dòng tự động hiển thị nhiều nhất có thể trong ô mà không cần đổi kích thước hoặc xuất hiện nhiều dòng.

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

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

Tham số

Tên	Loại	Mô tả
isWrapEnabled	Object[][]	Mảng hai chiều gồm các biến gói xác định xem có gói biến hay không trong một ô hoặc không.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• setWrap(isWrapEnabled)

---

shiftColumnGroupDepth(delta)

Thay đổi chiều sâu nhóm cột của dải ô theo số lượng đã chỉ định.

Điều này có tác dụng tạo, sửa đổi hoặc xoá các nhóm giao nhau với dải ô. Đối với delta dương, các nhóm được tạo và/hoặc sửa đổi; đối với delta phủ định, các nhóm bị huỷ và/hoặc sửa đổi.

Việc này không có hiệu lực khi giảm độ sâu của nhóm xuống dưới 0 hoặc trên 8.

Nếu column group control position là BEFORE, tuỳ chọn này sẽ tạo ra một lỗi khi cố gắng chuyển chiều sâu của hàng đầu tiên.

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

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

Tham số

Tên	Loại	Mô tả
delta	Integer	Số tiền dùng để thay đổi chiều sâu của nhóm cột trong phạm vi này.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Gửi

Error – khi cố gắng thay đổi độ sâu của cột đầu tiên khi vị trí điều khiển là GroupControlTogglePosition.BEFORE

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

shiftRowGroupDepth(delta)

Thay đổi chiều sâu nhóm hàng của dải ô theo số lượng đã chỉ định.

Điều này có tác dụng tạo, sửa đổi hoặc xoá các nhóm giao nhau với dải ô. Đối với delta dương, các nhóm được tạo và/hoặc sửa đổi; đối với delta phủ định, các nhóm bị huỷ và/hoặc sửa đổi.

Việc này không có hiệu lực khi giảm độ sâu của nhóm xuống dưới 0 hoặc trên 8.

Nếu row group control position là BEFORE, thao tác này sẽ tạo ra lỗi khi cố gắng chuyển chiều sâu của hàng đầu tiên.

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

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Tham số

Tên	Loại	Mô tả
delta	Integer	Số lượng theo đó để thay đổi chiều sâu của nhóm hàng của phạm vi này.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Gửi

Error – khi cố gắng thay đổi độ sâu của hàng đầu tiên khi chế độ điều khiển vị trí là GroupControlTogglePosition.BEFORE

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

sort(sortSpecObj)

Sắp xếp các ô trong dải ô đã cho, theo cột và thứ tự được chỉ định.

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

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

Tham số

Tên	Loại	Mô tả
sortSpecObj	Object	Cột để sắp xếp theo.

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

splitTextToColumns()

Chia một cột văn bản thành nhiều cột dựa trên dấu phân tách được phát hiện tự động.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

splitTextToColumns(delimiter)

Chia một cột văn bản thành nhiều cột bằng cách sử dụng chuỗi được chỉ định làm dấu phân tách tuỳ chỉnh.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Tham số

Tên	Loại	Mô tả
delimiter	String	Dấu phân cách tuỳ chỉnh cần phân tách.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

splitTextToColumns(delimiter)

Chia một cột văn bản thành nhiều cột dựa trên dấu phân tách được chỉ định.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Tham số

Tên	Loại	Mô tả
delimiter	TextToColumnsDelimiter	Dấu phân cách đặt trước để phân tách.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

trimWhitespace()

Cắt bỏ khoảng trắng (chẳng hạn như dấu cách, thẻ hoặc dòng mới) ở mọi ô trong dải ô này. Xóa tất cả khoảng trắng từ đầu và cuối văn bản của mỗi ô, đồng thời giảm mọi thứ tự theo sau các ký tự khoảng trắng còn lại thành một khoảng trắng.

Lưu ý: Nếu văn bản được rút gọn kết quả bắt đầu bằng dấu "+" hoặc '=' thì văn bản vẫn ở dạng giá trị chuỗi và không được hiểu là công thức.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

uncheck()

Thay đổi trạng thái của các hộp đánh dấu trong dải ô thành "đã bỏ chọn". Bỏ qua các ô trong dải ô hiện không chứa giá trị đã đánh dấu hoặc bỏ đánh dấu đã định cấu hình.

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

Cầu thủ trả bóng

Range — Dải ô này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Các phương thức ngừng hoạt động

getFontColor()

Không dùng nữa. Được thay thế bằng getFontColorObject()

Trả về màu phông chữ của ô ở góc trên cùng bên trái của dải ô, trong ký hiệu CSS (như dưới dạng '#ffffff' hoặc 'white').

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

Logger.log(range.getFontColor());

Cầu thủ trả bóng

String – Màu phông chữ trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

---

getFontColors()

Không dùng nữa. Được thay thế bằng getFontColorObjects()

Trả về màu phông chữ của các ô trong dải ô theo ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

var results = range.getFontColors();

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

Cầu thủ trả bóng

String[][] – Một mảng màu phông chữ hai chiều được liên kết với các ô trong dải ô.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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