Trang này được dịch bởi Cloud Translation API.

Class Range

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

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`activate()`	`Range`	Đặt dải ô đã chỉ định làm `active range`, với ô trên cùng bên trái trong dải ô làm `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 có khoá được chỉ định vào dải ô.
`addDeveloperMetadata(key, visibility)`	`Range`	Thêm siêu dữ liệu nhà phát triển có khoá và chế độ hiển thị được chỉ định vào dải ô.
`addDeveloperMetadata(key, value)`	`Range`	Thêm siêu dữ liệu nhà phát triển có 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 có khoá, giá trị và chế độ hiển thị được chỉ định vào dải ô.
`applyColumnBanding()`	`Banding`	Áp dụng giao diện mặc định cho dải ô.
`applyColumnBanding(bandingTheme)`	`Banding`	Áp dụng một giao diện phân dải cột đã chỉ định cho dải ô.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Áp dụng một giao diện phân dải cột được chỉ định cho dải ô có chế độ cài đặt tiêu đề và chân trang được chỉ định.
`applyRowBanding()`	`Banding`	Áp dụng giao diện mặc định cho dải ô.
`applyRowBanding(bandingTheme)`	`Banding`	Áp dụng một giao diện phân dải hàng đã chỉ định cho dải ô.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Áp dụng một giao diện phân dải hàng đã chỉ định cho dải ô có chế độ cài đặt tiêu đề và chân trang đã chỉ định.
`autoFill(destination, series)`	`void`	Điền dữ liệu vào `destinationRange` dựa trên dữ liệu trong phạm vi này.
`autoFillToNeighbor(series)`	`void`	Tính toán một dải ô để điền dữ liệu mới dựa trên các ô lân cận và tự động điền dải ô đó bằng các giá trị mới dựa trên dữ liệu có trong dải ô này.
`breakApart()`	`Range`	Phân tách mọi ô có nhiều cột trong dải ô thành các ô 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 các 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 lựa chọn nâng cao đã cho.
`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 nằm hoàn toàn trong phạm vi.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Sao chép định dạng của dải ô vào vị trí đã cho.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Sao chép định dạng của dải ô vào vị trí đã cho.
`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 cố định ở ô đầu tiên trong dải ô 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 cố định ở ô đầu tiên trong dải ô này.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Trả về một DeveloperMetadataFinderApi để tìm siêu dữ liệu nhà phát triển trong phạm vi của dải ô này.
`createFilter()`	`Filter`	Tạo một bộ lọc và áp dụng bộ lọc đó cho dải ô đã chỉ định trên trang tính.
`createPivotTable(sourceData)`	`PivotTable`	Tạo một bảng tổng hợp trống từ `sourceData` đã chỉ định, được cố định tại ô đầu tiên trong dải ô này.
`createTextFinder(findText)`	`TextFinder`	Tạo một công cụ tìm văn bản cho dải ô, 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 bị thu gọn có dải ô hoặc nút bật/tắt điều khiển giao với dải ô này.
`getA1Notation()`	`String`	Trả về nội dung mô tả chuỗi của dải ô, theo 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ả các dải ô được áp dụng cho mọi ô trong phạm vi 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 cho dải ô này.
`getDataRegion()`	`Range`	Trả về bản sao của dải ô được mở rộng theo 4 hướng chính `Direction` để bao gồm tất cả các ô liền kề có 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 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ả các bảng tổng hợp nguồn dữ liệu giao với dải ô.
`getDataSourceTables()`	`DataSourceTable[]`	Lấy tất cả cá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. Bạn có thể dùng URL này để 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 trong phạm vi 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ề các 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 của nhà phát triển được 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 giá trị hình chữ nhật cho dải ô này.
`getFilter()`	`Filter`	Trả về bộ lọc trên trang tính mà dải ô này thuộc về hoặc `null` nếu không có bộ lọc nào trên trang tính.
`getFontColorObject()`	`Color`	Trả về màu chữ của ô ở góc trên cùng bên trái của dải ô.
`getFontColorObjects()`	`Color[][]`	Trả về màu chữ của các ô trong dải ô.
`getFontFamilies()`	`String[][]`	Trả về họ phông chữ của các ô trong dải ô.
`getFontFamily()`	`String`	Trả về họ 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 các ô trong dải ô (`'underline'`, `'line-through'` hoặc `'none'`).
`getFontSize()`	`Integer`	Trả về cỡ chữ (tính bằng điểm) của ô ở góc trên cùng bên trái của dải ô.
`getFontSizes()`	`Integer[][]`	Trả về cỡ chữ của các ô trong dải ô.
`getFontStyle()`	`String`	Trả về kiểu phông chữ (`'italic'` hoặc `'normal'`) của ô ở góc trên cùng bên trái của dải ô.
`getFontStyles()`	`String[][]`	Trả về kiểu chữ của các ô trong dải ô.
`getFontWeight()`	`String`	Trả về độ đậm (thường/đậm) của phông chữ trong ô ở góc trên cùng bên trái của dải ô.
`getFontWeights()`	`String[][]`	Trả về độ đậm của 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 ô nhất định 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ã 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ề chế độ căn chỉnh ngang của văn bản (trái/giữa/phải) trong ô ở góc trên cùng bên trái của dải ô.
`getHorizontalAlignments()`	`String[][]`	Trả về chế độ căn chỉnh ngang của các ô trong dải ô.
`getLastColumn()`	`Integer`	Trả về vị trí cột cuối.
`getLastRow()`	`Integer`	Trả về vị trí hàng cuối.
`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 nằm 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ừ ô ở cột và hàng đầu tiên của dải ô, trả về ô tiếp theo theo 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.
`getNotes()`	`String[][]`	Trả về ghi chú liên kết với các ô trong dải ô.
`getNumColumns()`	`Integer`	Trả về số cột trong dải ô này.
`getNumRows()`	`Integer`	Trả về số 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 trong dải ô đã cho.
`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 mà dải ô này thuộc về.
`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 giá trị hình chữ nhật cho dải ô này.
`getVerticalAlignment()`	`String`	Trả về chế độ căn chỉnh theo chiều 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ề chế độ căn chỉnh theo chiều dọc của các ô trong dải ô.
`getWidth()`	`Integer`	Trả về chiều rộng của dải ô theo số cột.
`getWrap()`	`Boolean`	Trả về việc văn bản trong ô có được xuống dòng hay không.
`getWrapStrategies()`	`WrapStrategy[][]`	Trả về chiến lược ngắt dòng cho các ô trong dải ô.
`getWrapStrategy()`	`WrapStrategy`	Trả về chiến lược ngắt dòng cho ô trên cùng bên trái của dải ô.
`getWraps()`	`Boolean[][]`	Trả về việc văn bản trong cá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 ô đã đánh dấu và `false` cho ô chưa đánh dấu.
`insertCheckboxes(checkedValue)`	`Range`	Chèn hộp đánh dấu vào từng ô trong dải ô, được định cấu hình với một giá trị tuỳ chỉnh cho ô đã đánh dấu và chuỗi trống cho ô chưa đá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 trạng thái đã đánh dấu và 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 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 cuối dải ô có được liên kết với một cột cụ thể hay không.
`isEndRowBounded()`	`Boolean`	Xác định xem cuối dải ô có đượ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 lên bất kỳ ô nào được hợp nhất.
`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 ô 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 ô.
`moveTo(target)`	`void`	Cắt và dán (cả định dạng và giá trị) từ dải ô này sang 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ố lượng hàng và cột đã cho (có thể là số âm).
`offset(rowOffset, columnOffset, numRows)`	`Range`	Trả về một dải ô mới có liên quan đến dải ô hiện tại, có điểm trên cùng bên trái được bù trừ từ dải ô hiện tại theo số hàng và cột đã cho, đồng thời có chiều cao đã cho tính bằng số ô.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Trả về một dải ô mới có liên quan đến dải ô hiện tại, có điểm trên cùng bên trái được bù trừ từ dải ô hiện tại theo số hàng và cột đã cho, đồng thời có chiều cao và chiều rộng đã cho theo số ô.
`protect()`	`Protection`	Tạo một đối tượng có thể bảo vệ dải ô khỏi bị chỉnh sửa, ngoại trừ những người dùng có quyền.
`randomize()`	`Range`	Sắp xếp ngẫu nhiên thứ tự của các hàng trong dải ô đã cho.
`removeCheckboxes()`	`Range`	Xoá tất cả hộp đánh dấu khỏi dải ô.
`removeDuplicates()`	`Range`	Xoá các hàng trong phạm vi này có chứa các giá trị trùng lặp với giá trị trong bất kỳ hàng nào trước đó.
`removeDuplicates(columnsToCompare)`	`Range`	Xoá các hàng trong dải ô này có chứa các giá trị trong các cột được chỉ định là bản sao của các giá trị trong 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 ô ở ký hiệu CSS (chẳng hạn như `'#ffffff'` hoặc `'white'`).
`setBackgroundObject(color)`	`Range`	Đặt màu nền cho tất cả các ô trong dải ô.
`setBackgroundObjects(color)`	`Range`	Đặt một lưới hình chữ nhật gồm cá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 (số nguyên từ 0 đến 255, bao gồm cả hai giá trị này).
`setBackgrounds(color)`	`Range`	Đặt một lưới hình chữ nhật gồm cá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 theo 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ữ theo ký hiệu CSS (chẳng hạn như `'#ffffff'` hoặc `'white'`).
`setFontColorObject(color)`	`Range`	Đặt màu phông chữ cho dải ô đã cho.
`setFontColorObjects(colors)`	`Range`	Đặt một lưới hình chữ nhật gồm cá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`	Đặt một lưới hình chữ nhật gồm cá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`	Đặt một lưới hình chữ nhật gồm các 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ư "Arial" hoặc "Helvetica".
`setFontLine(fontLine)`	`Range`	Đặt kiểu đường kẻ của phông chữ cho dải ô đã cho (`'underline'`, `'line-through'` hoặc `'none'`).
`setFontLines(fontLines)`	`Range`	Đặt một lưới hình chữ nhật gồm 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 cỡ chữ, trong đó cỡ chữ là cỡ chữ tính bằng điểm cần sử dụng.
`setFontSizes(sizes)`	`Range`	Đặt một lưới hình chữ nhật gồm các cỡ 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`	Đặt một lưới hình chữ nhật gồm 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 của phông chữ cho dải ô đã cho (bình thường/đậm).
`setFontWeights(fontWeights)`	`Range`	Đặt một lưới hình chữ nhật gồm các độ đậm của 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`	Đặt một lưới công thức hình chữ nhật (phải khớp với kích thước của dải ô này).
`setFormulasR1C1(formulas)`	`Range`	Đặt một lưới công thức hình chữ nhật (phải khớp với kích thước của dải ô này).
`setHorizontalAlignment(alignment)`	`Range`	Đặt chế độ căn chỉnh ngang (từ trái sang phải) cho dải ô đã cho (trái/giữa/phải).
`setHorizontalAlignments(alignments)`	`Range`	Đặt một lưới hình chữ nhật gồm các chế độ căn chỉnh ngang.
`setNote(note)`	`Range`	Đặt ghi chú thành giá trị đã cho.
`setNotes(notes)`	`Range`	Đặt một lưới hình chữ nhật gồm các nốt (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.
`setNumberFormats(numberFormats)`	`Range`	Đặt một lưới hình chữ nhật gồm các định dạng số hoặc ngày (phải khớp với kích thước của dải ô 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`	Đặt một lưới hình chữ nhật gồm các giá trị Văn bản đa dạng thức.
`setShowHyperlink(showHyperlink)`	`Range`	Đặt xem dải ô có hiển thị siêu liên kết hay không.
`setTextDirection(direction)`	`Range`	Đặt hướng văn bản cho các ô trong dải ô.
`setTextDirections(directions)`	`Range`	Đặt một lưới ô hình chữ nhật gồm các hướng văn bản.
`setTextRotation(degrees)`	`Range`	Đặt chế độ xoay văn bản cho các ô trong dải ô.
`setTextRotation(rotation)`	`Range`	Đặt chế độ xoay văn bản cho các ô trong dải ô.
`setTextRotations(rotations)`	`Range`	Đặt một lưới hình chữ nhật gồm các hướng xoay văn bản.
`setTextStyle(style)`	`Range`	Đặt kiểu văn bản cho các ô trong dải ô.
`setTextStyles(styles)`	`Range`	Đặt một lưới hình chữ nhật gồm các kiểu văn bản.
`setValue(value)`	`Range`	Đặt giá trị cho dải ô.
`setValues(values)`	`Range`	Đặt một lưới giá trị hình chữ nhật (phải khớp với kích thước của dải ô này).
`setVerticalAlignment(alignment)`	`Range`	Đặt chế độ căn chỉnh theo chiều dọc (từ trên xuống dưới) cho phạm vi đã cho (trên cùng/giữa/dưới cùng).
`setVerticalAlignments(alignments)`	`Range`	Đặt một lưới hình chữ nhật gồm các chế độ căn chỉnh theo chiều 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 chế độ xuống dòng của ô cho dải ô đã cho.
`setWrapStrategies(strategies)`	`Range`	Đặt một lưới hình chữ nhật gồm các chiến lược bao bọc.
`setWrapStrategy(strategy)`	`Range`	Đặt chiến lược ngắt dòng cho các ô trong dải ô.
`setWraps(isWrapEnabled)`	`Range`	Đặt một lưới hình chữ nhật gồm các chính sách ngắt dò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 của nhóm cột trong dải ô theo số lượng được chỉ định.
`shiftRowGroupDepth(delta)`	`Range`	Thay đổi chiều sâu của nhóm hàng trong dải ô theo số lượng được 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 cách được tự động phát hiện.
`splitTextToColumns(delimiter)`	`void`	Phân tách một cột văn bản thành nhiều cột bằng cách sử dụng chuỗi đã chỉ định làm dấu phân cá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 cách đã chỉ định.
`trimWhitespace()`	`Range`	Xoá khoảng trắng (chẳng hạn như dấu cách, dấu tab hoặc dòng mới) trong mọi ô thuộc dải ô này.
`uncheck()`	`Range`	Thay đổi trạng thái của các hộp đánh dấu trong phạm vi thành "chưa đánh dấu".

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

Phương thức	Kiểu 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 ô, theo ký hiệu CSS (chẳng hạn như `'#ffffff'` hoặc `'white'`).
`getFontColors()`	`String[][]`	Trả về màu phông chữ của các ô trong dải ô ở ký hiệu CSS (chẳng hạn như `'#ffffff'` hoặc `'white'`).

Tài liệu chi tiết

`activate()`

Đặt dải ô đã chỉ định làm active range, với ô trên cùng bên trái trong dải ô làm current cell.

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

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

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

`activateAsCurrentCell()`

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

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

Nếu ô được chỉ định không có trong bất kỳ dải ô hiện có nào, thì lựa chọn hiện có sẽ bị xoá và ô đó sẽ 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 thì sẽ xảy ra một ngoại lệ.

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

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

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

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 có khoá đượ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 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());

Thông số

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

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`addDeveloperMetadata(key, visibility)`

Thêm siêu dữ liệu nhà phát triển có khoá và chế độ hiển thị đượ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 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());

Thông số

Tên	Loại	Mô tả
`key`	`String`	Khoá 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Thông số

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

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 có khoá, giá trị và chế độ hiển thị đượ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 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());

Thông số

Tên	Loại	Mô tả
`key`	`String`	Khoá cho siêu dữ liệu nhà phát triển mới.
`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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`applyColumnBanding()`

Áp dụng giao diện mặc định cho dải ô. Theo mặc định, tính năng tạo dải màu có màu 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 – Hệ thống phân loại mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`applyColumnBanding(bandingTheme)`

Áp dụng một giao diện phân dải cột đã chỉ định cho dải ô. Theo mặc định, tính năng phân 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(),
);

Thông số

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

Cầu thủ trả bóng

Banding – Hệ thống phân loại mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

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

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

Thông số

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

Cầu thủ trả bóng

Banding – Hệ thống phân loại mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`applyRowBanding()`

Áp dụng giao diện mặc định cho dải ô. Theo mặc định, tính năng tạo dải màu có màu 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 màu.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`applyRowBanding(bandingTheme)`

Áp dụng một giao diện phân dải hàng đã chỉ định cho dải ô. Theo mặc định, tính năng tạo dải màu có màu 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);

Thông 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 – Hệ thống phân loại mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

Áp dụng một giao diện phân dải hàng đã chỉ định cho dải ô có chế độ cài đặt tiêu đề và chân trang đã 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);

Thông 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 `true`, màu tiêu đề của giao diện phân dải sẽ được áp dụng cho hàng đầu tiên.
`showFooter`	`Boolean`	Nếu `true`, màu chân trang của chủ đề phân dải sẽ được áp dụng cho hàng cuối cùng.

Cầu thủ trả bóng

Banding – Hệ thống phân loại mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 phạm vi này. Các giá trị mới cũng được xác định theo loại series đã chỉ định. Dải ô đích phải chứa dải ô này và chỉ kéo dài dải ô theo một hướng. Ví dụ: mã sau đây sẽ điền A1:A20 bằng một chuỗi các số tăng dần dựa trên các giá trị hiện tại trong A1:A4:

const sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
const sourceRange = sheet.getRange('A1:A4');
// The range to fill with values.
const 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);

Thông số

Tên	Loại	Mô tả
`destination`	`Range`	Dải ô cần được tự động điền giá trị. Dải ô đích đến phải chứa dải ô này và chỉ mở rộng theo một hướng (lên, xuống, trái hoặc phải).
`series`	`AutoFillSeries`	Loại chuỗi autoFill cần được dùng để tính toán các giá trị mới. Ảnh hưởng của chuỗi này sẽ khác nhau tuỳ thuộc vào loại và lượng dữ liệu nguồn.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`autoFillToNeighbor(series)`

Tính toán một dải ô để điền dữ liệu mới dựa trên các ô lân cận và tự động điền dải ô đó bằng 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 bằng loại series đã chỉ định.

Dải ô đích được tính toán sẽ xem xét dữ liệu xung quanh để xác định vị trí cần chèn các giá trị mới: nếu có dữ liệu ở ngay bên trái hoặc bên phải của một cột đang được tự động điền, thì các giá trị mới sẽ chỉ mở rộng đến 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 các ngày, thì 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 sẽ "dính" vào các ô chứa giá trị trong cột A.

const sheet = SpreadsheetApp.getActiveSheet();

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

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

Thông số

Tên	Loại	Mô tả
`series`	`AutoFillSeries`	Loại chuỗi autoFill cần được dùng để tính toán các giá trị mới. Ảnh hưởng của chuỗi này sẽ khác nhau tuỳ thuộc vào loại và lượng dữ liệu nguồn.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`breakApart()`

Phân tách mọi ô có nhiều cột trong dải ô thành các ô riêng lẻ.

Việc 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Chủ sở hữu bảng tính luôn có thể chỉnh sửa các 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`check()`

Thay đổi trạng thái của các 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 chưa đánh dấu nào được đị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'.
const range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.

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

const range = sheet.getRange('A1:D10');
range.clear();

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 lựa chọn nâng cao đã cho. Theo mặc định, tất cả dữ liệu sẽ 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
});

Thông số

Tên	Loại	Mô tả
`options`	`Object`	Một đố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`	Xác định xem có chỉ xoá nhận xét hay không.
`contentsOnly`	`Boolean`	Có xoá chỉ nội dung hay không.
`formatOnly`	`Boolean`	Có xoá chỉ định dạng hay không; lưu ý rằng việc xoá định dạng cũng sẽ xoá các quy tắc xác thực dữ liệu.
`validationsOnly`	`Boolean`	Có xoá chỉ các quy tắc xác thực dữ liệu hay không.
`skipFilteredRows`	`Boolean`	Có nên tránh xoá các hàng đã lọc hay không.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.

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

const range = sheet.getRange('A1:D10');
range.clearContent();

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.
const range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 cho ô hoặc các ô trong dải ô, nhưng không đặt lại bất kỳ quy tắc định dạng số nào.

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

const range = sheet.getRange('A1:D10');
range.clearFormat();

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`clearNote()`

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

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

const range = sheet.getRange('A1:D10');
range.clearNote();

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`collapseGroups()`

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

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

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

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô vào vị trí đã cho. Nếu đích đến lớn hơn hoặc nhỏ hơn phạm vi nguồn, thì nguồn sẽ được lặp lại hoặc cắt bớt cho phù hợp. Xin lưu ý rằng phương thức này 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().

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

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

Thông số

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Xem thêm

getGridId()

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

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

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

Thông số

Tên	Loại	Mô tả
`sheet`	`Sheet`	Trang đích.
`column`	`Integer`	Cột đầu tiên của dải ô đích.
`columnEnd`	`Integer`	Cột cuối của phạm vi đích.
`row`	`Integer`	Hàng bắt đầu của phạm vi đích.
`rowEnd`	`Integer`	Hàng cuối của phạm vi đích.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 đều được sao chép.

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

Thông số

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A:E').copyTo(
    sheet.getRange('F1'),
    SpreadsheetApp.CopyPasteType.PASTE_VALUES,
    false,
);

Thông số

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 đều được sao chép, nhưng bạn có thể ghi đè bằng cách sử dụng các đối số nâng cao.

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

Thông số

Tên	Loại	Mô tả
`destination`	`Range`	Dải ô đích để sao chép; chỉ có vị trí ô trên cùng bên trái là có liên quan.
`options`	`Object`	Một đố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`	cho biết rằng bạn chỉ nên sao chép định dạng
`contentsOnly`	`Boolean`	chỉ định rằng chỉ nội dung được sao chép

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 phạm vi nguồn, thì nguồn sẽ được lặp lại hoặc cắt bớt cho phù hợp.

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

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

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

Thông số

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Xem thêm

getGridId()

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

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

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

Thông số

Tên	Loại	Mô tả
`sheet`	`Sheet`	Trang đích.
`column`	`Integer`	Cột đầu tiên của dải ô đích.
`columnEnd`	`Integer`	Cột cuối của phạm vi đích.
`row`	`Integer`	Hàng bắt đầu của phạm vi đích.
`rowEnd`	`Integer`	Hàng cuối của phạm vi đích.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 cố định ở ô đầu tiên trong dải ô này.

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

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

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

Thông số

Tên	Loại	Mô tả
`dataSource`	`DataSource`	Nguồn dữ liệu để 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 cố định ở ô đầu tiên trong dải ô này.

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

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

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

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`createDeveloperMetadataFinder()`

Trả về một DeveloperMetadataFinderApi để tìm siêu dữ liệu nhà phát triển trong phạm vi của dải ô này. Siêu dữ liệu chỉ nằm trong phạm vi của dải ô nếu hoàn toàn nằm trong dải ô đó. Ví dụ: siêu dữ liệu được liên kết với hàng "3:3" không nằm trong phạm vi của dải ô "A1:D5" nhưng nằm trong phạm vi của dải ô "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 – Bộ tìm siêu dữ liệu nhà phát triển để tìm kiếm siêu dữ liệu trong phạm vi của dải ô này.

`createFilter()`

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

const ss = SpreadsheetApp.getActiveSheet();
const 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() {
  const filter = range.getFilter();
  const criteria =
      SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
  filter.setColumnFilterCriteria(2, criteria);
}

Sử dụng phương thức này để tạo bộ lọc cho các trang Grid, đây là loại trang mặc định. Trang tính dạng lưới là những trang tính không được kết nối với cơ sở dữ liệu. Để tạo các loại bộ lọc khác, hãy tham khảo những thông tin 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 được 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 được 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 đã chỉ định, được cố định tại ô đầu tiên 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');

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

Thông 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 tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`createTextFinder(findText)`

Tạo một công cụ tìm văn bản cho dải ô, có thể tìm và thay thế văn bản trong dải ô này.

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

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

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

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

Thông số

Tên	Loại	Mô tả
`findText`	`String`	Văn bản cần tì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 cùng với phương diện được cung cấp sẽ được chuyển về phía dải ô đã xoá.

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

const range = sheet.getRange('A1:D10');
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Thông số

Tên	Loại	Mô tả
`shiftDimension`	`Dimension`	Phương diện mà bạn muốn dịch chuyển dữ liệu hiện có.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`expandGroups()`

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

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

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

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getA1Notation()`

Trả về nội dung mô tả chuỗi của dải ô, theo ký hiệu A1.

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

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

Cầu thủ trả bóng

String – Nội dung mô tả chuỗi của dải ô ở ký hiệu A1.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô.

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô.

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

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

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

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getBandings()`

Trả về tất cả các dải ô được áp dụng cho mọi ô 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');

// 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 (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Cầu thủ trả bóng

Banding[] – Tất cả các dải màu được áp dụng cho mọi ô trong phạm vi này.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô.

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

const 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
const cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Thông số

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

Cầu thủ trả bóng

Range – Một dải ô chứa một ô duy nhất tại toạ độ đã chỉ định.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getColumn()`

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

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 theo 4 hướng chính Direction để bao gồm tất cả các ô liền kề có 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 đường chéo), thì chính dải ô đó sẽ được trả về. Việc này tương tự như việc chọn dải ô và nhập Ctrl+A trong trình chỉnh sửa.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 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 dải ô 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ư một bảng. Dải ô mở rộng bao gồm tất cả các ô liền kề có dữ liệu trong đó theo phương diện được chỉ định, bao gồm cả ranh giới bảng. Nếu dải ô ban đầu được bao quanh bởi các ô trống dọc theo phương diện đã chỉ định, thì dải ô đó sẽ được trả về. Phương thức này tương tự như việc chọn dải ô và nhập Ctrl+Space cho cột hoặc Shift+Space cho hàng trong trình chỉnh sửa.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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(),
);

Thông số

Tên	Loại	Mô tả
`dimension`	`Dimension`	Phương diện để mở rộng dải ô.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 của ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getDataSourcePivotTables()`

Lấy tất cả các bảng tổng hợp 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 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getDataSourceTables()`

Lấy tất cả cá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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Bạn có thể dùng URL này để tạo biểu đồ và truy vấn.

Code.gs

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

  const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 trong phạm vi này dưới dạng DataTable.

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

// Calling this method with "true" sets the first line to be the title of the
// axes
const 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.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Title Here')
                  .build();

Thông số

Tên	Loại	Mô tả
`firstRowIsHeader`	`Boolean`	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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 bạn chưa thiết lập quy trình xác thực dữ liệu trên ô, thì phương thức này sẽ trả về null.

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getDataValidations()`

Trả về các quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô. Nếu bạn chưa đặt chế độ xác thực dữ liệu cho một ô nhất định, thì 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.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

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

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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ột 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getDeveloperMetadata()`

Lấy siêu dữ liệu của nhà phát triển được 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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à tiền tệ, bao gồm cả các định dạng được áp dụng tự động theo chế độ cài đặt ngôn ngữ của bảng tính. Các ô trống sẽ 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 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ị hiển thị trong ô này.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getDisplayValues()`

Trả về lưới giá trị hình chữ nhật cho 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 đó theo cột. Các giá trị là đối tượng String. Giá trị hiển thị có tính đến định dạng ngày, giờ và tiền tệ, bao gồm cả các định dạng được áp dụng tự động theo chế độ cài đặt ngôn ngữ của bảng tính. Các ô trống được biểu thị bằng một chuỗi trống trong mảng. Hãy nhớ rằng mặc dù chỉ mục phạm vi bắt đầu từ 1, 1, nhưng 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.
const values =
    SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFilter()`

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

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

Cầu thủ trả bóng

Filter – Bộ lọc.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontColorObject()`

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontColorObjects()`

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

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

const results = range.getFontColorObjects();

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontFamilies()`

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

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

const results = range.getFontFamilies();

for (const i in results) {
  for (const 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ữ được liên kết với các ô trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontFamily()`

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

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

Logger.log(range.getFontLine());

Cầu thủ trả bóng

String – Đường phông chữ.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontLines()`

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

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

const results = range.getFontLines();

for (const i in results) {
  for (const 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 đường viền chữ cái liên kết với các ô trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontSize()`

Trả về cỡ chữ (tính bằng điểm) của ô ở góc trên cùng bên trái của dải ô.

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

Logger.log(range.getFontSize());

Cầu thủ trả bóng

Integer – Cỡ chữ tính bằng điểm.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontSizes()`

Trả về cỡ chữ của các ô trong dải ô.

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

const results = range.getFontSizes();

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô ở góc trên cùng bên trái của dải ô.

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

Logger.log(range.getFontStyle());

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontStyles()`

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

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

const results = range.getFontStyles();

for (const i in results) {
  for (const 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 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontWeight()`

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

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

Logger.log(range.getFontWeight());

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getFontWeights()`

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

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

const results = range.getFontWeights();

for (const i in results) {
  for (const 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 độ đậm của phông chữ của văn bản được liên kết với các ô trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.

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

// This assumes you have a function in B5 that sums up
// B2:B4
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô nhất định hoặc null nếu không có.

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

const range = sheet.getRange('B5');
const formula = range.getFormulaR1C1();
Logger.log(formula);

Cầu thủ trả bóng

String – Công thức ở ký hiệu R1C1.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 trong mảng 2D là chuỗi trống đối với các ô không có công thức.

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

const range = sheet.getRange('B5:C6');
const formulas = range.getFormulas();
for (const i in formulas) {
  for (const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 trong mảng 2D là null cho những ô không có công thức.

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

const range = sheet.getRange('B5:C6');
const formulas = range.getFormulasR1C1();
for (const i in formulas) {
  for (const 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 ở ký hiệu R1C1.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getGridId()`

Trả về mã 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.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getHeight()`

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

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getHorizontalAlignment()`

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

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

Logger.log(range.getHorizontalAlignment());

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getHorizontalAlignments()`

Trả về chế độ căn chỉnh ngang của các ô trong dải ô.

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

const results = range.getHorizontalAlignments();

for (const i in results) {
  for (const 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 chế độ căn chỉnh văn bản theo chiều ngang được liên kết với các ô trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getLastColumn()`

Trả về vị trí cột cuối.

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getLastRow()`

Trả về vị trí hàng cuối.

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 nằm 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.

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

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

const mergedRanges = range.getMergedRanges();
for (let 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 lên dải ô.

`getNextDataCell(direction)`

Bắt đầu từ ô ở cột và hàng đầu tiên của dải ô, trả về ô tiếp theo theo 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] trong trình chỉnh sửa.

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

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

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getNotes()`

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

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

const results = range.getNotes();

for (const i in results) {
  for (const 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 ghi chú được liên kết với các ô trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getNumColumns()`

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

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getNumRows()`

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

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 trong dải ô đã cho. Các mẫu định dạng được trả về được mô tả trong tài liệu về Sheets API.

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

const 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 trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô. Các mẫu định dạng được trả về được mô tả trong tài liệu về API Trang tính.

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

const range = sheet.getRange('B5:C6');
const formats = range.getNumberFormats();
for (const i in formats) {
  for (const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('D4:F6');
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const values = range.getRichTextValues();

for (let i = 0; i < values.length; i++) {
  for (let 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Tương tự như getRowIndex().

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Tương tự như getRow().

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

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Xem thêm

getRow()

`getSheet()`

Trả về trang tính mà dải ô này thuộc về.

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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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ủa ô được xác định bằng tính năng tự động phát hiện.

// Get the text direction of cell B1.
const sheet = SpreadsheetApp.getActiveSheet();
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 trong mảng 2D là null đối với những ô sử dụng tính năng phát hiện tự động.

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

for (let i = 0; i < directions.length; i++) {
  for (let 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 gồm các hướng văn bản.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.
const sheet = SpreadsheetApp.getActiveSheet();

const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

const results = range.getTextRotations();

for (const i in results) {
  for (const j in results[i]) {
    const 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 gồm các hướng xoay văn bản được liên kết với các ô trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('D4:F6');
const 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const styles = range.getTextStyles();

for (let i = 0; i < styles.length; i++) {
  for (let 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 gồm các kiểu văn bản.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô. Các ô trống sẽ 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getValues()`

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

Trả về một mảng giá trị hai chiều, được lập chỉ mục theo hàng, sau đó theo cột. Các giá trị có thể 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 mặc dù chỉ mục phạm vi bắt đầu từ 1, 1, nhưng 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.
const values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);

Trong các ứng dụng web, giá trị Date không phải là một tham số hợp lệ. getValues() không trả về 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 chuyển đổi tất cả các giá trị được truy xuất từ trang tính thành một kiểu dữ liệu nguyên thuỷ được JavaScript hỗ trợ, chẳng hạn như Number, Boolean hoặc String.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getVerticalAlignment()`

Trả về chế độ căn chỉnh theo chiều 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 ô.

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

Logger.log(range.getVerticalAlignment());

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getVerticalAlignments()`

Trả về chế độ căn chỉnh theo chiều dọc của các ô trong dải ô.

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

const results = range.getVerticalAlignments();

for (const i in results) {
  for (const 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 chế độ căn chỉnh văn bản theo chiều dọc được liên kết với các ô trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getWidth()`

Trả về chiều rộng của dải ô theo số 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getWrap()`

Trả về việc văn bản trong ô có được xuống dòng hay không. Để có chiến lược ngắt dòng chi tiết hơn, hãy dùng getWrapStrategy().

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

Logger.log(range.getWrap());

Cầu thủ trả bóng

Boolean – Văn bản trong ô này có xuống dòng hay không.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getWrapStrategies()`

Trả về chiến lược ngắt dòng cho các ô trong dải ô.

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

for (let i = 0; i < strategies.length; i++) {
  for (let 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 gồm các chiến lược xuống dòng tự động.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getWrapStrategy()`

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

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

Cầu thủ trả bóng

WrapStrategy – Chiến lược ngắt dòng của ô trên cùng bên trái trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`getWraps()`

Trả về việc văn bản trong các ô có xuống dòng hay không. Để có chiến lược ngắt dòng chi tiết hơn, hãy dùng getWrapStrategies().

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

const results = range.getVerticalAlignments();

for (const i in results) {
  for (const j in results[i]) {
    const 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 gồm các chế độ căn chỉnh văn bản theo chiều dọc được liên kết với các ô trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 sẽ giữ lại mọi định dạng có trong các ô trước đây 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 sẽ được chuyển ra khỏi dải ô được chèn.

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

const range = sheet.getRange('A1:D10');
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Thông số

Tên	Loại	Mô tả
`shiftDimension`	`Dimension`	Phương diện mà bạn muốn dịch chuyển dữ liệu hiện có.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô đã đánh dấu và false cho ô chưa đánh dấu. Đặt giá trị của tất cả các ô trong dải ô thành false.

const 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 với một giá trị tuỳ chỉnh cho ô đã đánh dấu và chuỗi trống cho ô chưa đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành chuỗi trống.

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

Thông số

Tên	Loại	Mô tả
`checkedValue`	`Object`	Giá trị đã chọn cho quy tắc xác thực dữ liệu của hộp kiểm.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 trạng thái đã đánh dấu và chưa đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành giá trị tuỳ chỉnh chưa được đánh dấu.

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

Thông số

Tên	Loại	Mô tả
`checkedValue`	`Object`	Giá trị đã chọn cho quy tắc xác thực dữ liệu của hộp kiểm.
`uncheckedValue`	`Object`	Giá trị chưa được chọn để xác thực dữ liệu hộp kiểm.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.

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

Logger.log(range.isBlank());

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`isChecked()`

Trả về xem 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 đánh dấu, hoặc nếu một số ô không có tính năng xác thực dữ liệu hộp đánh dấu.

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

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

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

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

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

Cầu thủ trả bóng

Boolean – true nếu tất cả các ô trong dải ô đều được đánh dấu, false nếu tất cả các ô trong dải ô đều không được đánh dấu hoặc null nếu bất kỳ ô nào không được đánh dấu hoặc không có tính năng xác thực dữ liệu bằng hộp đánh dấu.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`isEndColumnBounded()`

Xác định xem cuối dải ô có được liên kết với một cột cụ thể hay không. Ví dụ: đối với các 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 này sẽ trả về true; đối với các dải ô 3:7 hoặc A1:5, chỉ được liên kết với 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 cuối dải ô được liên kết với một cột cụ thể; false nếu không.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`isEndRowBounded()`

Xác định xem cuối dải ô có được liên kết với một hàng cụ thể hay không. Ví dụ: đối với các 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 này sẽ trả về true; đối với các dải ô B:B hoặc A1:C chỉ được liên kết với 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 cuối dải ô được liên kết với một hàng cụ thể; false nếu không.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 lên bất kỳ ô nào được hợp nhất.

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

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

// True if any of the cells in A1:B3 is included in a merge.
const isPartOfMerge = range.isPartOfMerge();

Cầu thủ trả bóng

Boolean – true nếu dải ô trùng với bất kỳ ô nào được hợp nhất, nếu không thì 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 các 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 sẽ trả về true; đối với dải ô 3:7 (chỉ được liên kết với một hàng ở đầ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 đầu dải ô được liên kết với một cột cụ thể; false nếu không.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 các 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 này sẽ trả về true; đối với dải ô B:B (chỉ được liên kết với một cột 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 đầu dải ô được liên kết với một hàng cụ thể; false nếu không.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`merge()`

Hợp nhất các ô trong dải ô thành một khối duy nhất.

const 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô.

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

// The code below merges cells C5:E5 into one cell
const range1 = sheet.getRange('C5:E5');
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
const range2 = sheet.getRange('F5:H6');
range2.mergeAcross();

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`mergeVertically()`

Hợp nhất các ô trong dải ô.

const 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 sang dải ô đích.

// The code below moves the first 5 columns over to the 6th column
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A1:E').moveTo(sheet.getRange('F1'));

Thông số

Tên	Loại	Mô tả
`target`	`Range`	Một dải ô đích để sao chép dải ô này vào; chỉ có vị trí ô trên cùng bên trái là phù hợp.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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ố lượng hàng và cột đã cho (có thể là số âm). Phạm vi mới có cùng kích thước với phạm vi ban đầu.

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

const cell = sheet.getRange('A1');

// newCell references B2
const newCell = cell.offset(1, 1);

Thông số

Tên	Loại	Mô tả
`rowOffset`	`Integer`	Số hàng tính từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị số hàng tính từ ô trên cùng bên trái của dải ô.
`columnOffset`	`Integer`	Số cột ở bên phải ô 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 ô trên cùng bên trái của dải ô.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

`offset(rowOffset, columnOffset, numRows)`

Trả về một dải ô mới có liên quan đến dải ô hiện tại, có điểm trên cùng bên trái được bù trừ từ dải ô hiện tại theo số hàng và cột đã cho, đồng thời có chiều cao đã cho tính bằng số ô.

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

const cell = sheet.getRange('A1');

// newCell references B2:B3
const newRange = cell.offset(1, 1, 2);

Thông số

Tên	Loại	Mô tả
`rowOffset`	`Integer`	Số hàng tính từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị số hàng tính từ ô trên cùng bên trái của dải ô.
`columnOffset`	`Integer`	Số cột ở bên phải ô 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 ô trên cùng bên trái của dải ô.
`numRows`	`Integer`	Chiều cao của dải ô mới tính bằng số hàng.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

`offset(rowOffset, columnOffset, numRows, numColumns)`

Trả về một dải ô mới có liên quan đến dải ô hiện tại, có điểm trên cùng bên trái được bù trừ từ dải ô hiện tại theo số hàng và cột đã cho, đồng thời có chiều cao và chiều rộng đã cho theo số ô.

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

const cell = sheet.getRange('A1');

// newCell references B2:C3
const newRange = cell.offset(1, 1, 2, 2);

Thông số

Tên	Loại	Mô tả
`rowOffset`	`Integer`	Số hàng tính từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị số hàng tính từ ô trên cùng bên trái của dải ô.
`columnOffset`	`Integer`	Số cột ở bên phải ô 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 ô trên cùng bên trái của dải ô.
`numRows`	`Integer`	Chiều cao của dải ô mới tính bằng số hàng.
`numColumns`	`Integer`	Chiều rộng tính bằng số cột của dải ô mới.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

`protect()`

Tạo một đối tượng có thể bảo vệ dải ô khỏi bị chỉnh sửa, ngoại trừ những người dùng có quyền. Cho đến khi tập lệnh thực sự thay đổi danh sách người 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 giá trị mới cho Protection.setDomainEdit(editable)), các quyền sẽ phản ánh các quyền của chính 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 ô đã được bảo vệ, phương thức này sẽ tạo một dải ô được bảo vệ mới trùng với dải ô hiện có. Nếu một ô được bảo vệ bằng nhiều dải ô được bảo vệ và bất kỳ dải ô nào trong số đó ngăn một người dùng cụ thể chỉnh sửa ô, thì người dùng đó sẽ không được phép chỉnh sửa ô.

// Protect range A1:B10, then remove all other users from the list of editors.
const ss = SpreadsheetApp.getActive();
const range = ss.getRange('A1:B10');
const 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.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Cầu thủ trả bóng

Protection – Một đối tượng đại diện cho chế độ cài đặt bảo vệ.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('A1:C7');

// Randomizes the range
range.randomize();

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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á quy tắc xác thực dữ liệu của từng ô, đồng thời xoá giá trị của ô nếu ô đó chứa giá trị đã đánh dấu hoặc chưa đánh dấu.

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

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

const range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

const 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`removeDuplicates()`

Xoá các hàng trong phạm vi này có chứa các giá trị trùng lặp với giá trị trong bất kỳ hàng nào trước đó. Các hàng có giá trị giống hệt nhau nhưng loại chữ, định dạng hoặc công thức khác nhau thì đượ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 (ví dụ: do bộ lọc). Nội dung nằm ngoài phạm vi này sẽ không bị xoá.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B1:D7');

// Remove duplicate rows in the range.
range.removeDuplicates();

Cầu thủ trả bóng

Range – Dải ô kết quả sau khi xoá các giá trị trùng lặp. Kích thước của dải ô sẽ giảm đi một hàng cho mỗi hàng bị xoá.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`removeDuplicates(columnsToCompare)`

Xoá các hàng trong dải ô này có chứa các giá trị trong các cột được chỉ định là bản sao của các giá trị trong bất kỳ hàng nào trước đó. Các hàng có giá trị giống hệt nhau nhưng loại chữ, định dạng hoặc công thức khác nhau thì đượ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 (ví dụ: do bộ lọc). Nội dung nằm ngoài phạm vi này sẽ không bị xoá.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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]);

Thông 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 bạn không cung cấp cột nào, thì tất cả các cột sẽ được phân tích để tìm dữ liệu trùng lặp.

Cầu thủ trả bóng

Range – Dải ô kết quả sau khi xoá các giá trị trùng lặp. Kích thước của dải ô sẽ giảm đi một hàng cho mỗi hàng bị xoá.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô ở ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

const range = sheet.getRange('B2:D5');
range.setBackground('red');

Thông số

Tên	Loại	Mô tả
`color`	`String`	Mã màu theo ký hiệu CSS (chẳng hạn như `'#ffffff'` hoặc `'white'`); giá trị `null` sẽ đặt lại màu.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setBackgroundObject(color)`

Đặt màu nền cho tất cả các ô trong dải ô.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const bgColor = SpreadsheetApp.newColor()
                    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
                    .build();

const range = sheet.getRange('B2:D5');
range.setBackgroundObject(bgColor);

Thông số

Tên	Loại	Mô tả
`color`	`Color`	Màu nền cần đặt; giá trị `null` sẽ đặt lại màu nền.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setBackgroundObjects(color)`

Đặt một lưới hình chữ nhật gồm các màu nền (phải khớp với kích thước của dải ô này).

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

const colorAccent1 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                         .build();
const colorAccent2 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                         .build();
const colorAccent3 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                         .build();
const colorAccent4 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
                         .build();

const colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4],
];

const cell = sheet.getRange('B5:C6');
cell.setBackgroundObjects(colors);

Thông số

Tên	Loại	Mô tả
`color`	`Color[][]`	Một mảng màu hai chiều; các giá trị `null` sẽ đặt lại màu.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 (số nguyên từ 0 đến 255, bao gồm cả hai giá trị này).

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

const cell = sheet.getRange('B2');

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setBackgrounds(color)`

Đặt một lưới hình chữ nhật gồm cá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 được biểu thị bằng ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

const colors = [
  ['red', 'white', 'blue'],
  ['#FF0000', '#FFFFFF', '#0000FF'],  // These are the hex equivalents
];

const cell = sheet.getRange('B5:D6');
cell.setBackgrounds(colors);

Thông số

Tên	Loại	Mô tả
`color`	`String[][]`	Một mảng hai chiều gồm các màu theo ký hiệu CSS (chẳng hạn như `'#ffffff'` hoặc `'white'`); các giá trị `null` sẽ đặt lại màu.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

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

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

Thông số

Tên	Loại	Mô tả
`top`	`Boolean`	`true` cho đường viền, `false` cho không có đường viền, `null` cho không thay đổi.
`left`	`Boolean`	`true` cho đường viền, `false` cho không có đường viền, `null` cho không thay đổi.
`bottom`	`Boolean`	`true` cho đường viền, `false` cho không có đường viền, `null` cho không thay đổi.
`right`	`Boolean`	`true` cho đường viền, `false` cho không có đường viền, `null` cho không thay đổi.
`vertical`	`Boolean`	`true` cho đường viền dọc bên trong, `false` cho không có đường viền, `null` cho không có thay đổi.
`horizontal`	`Boolean`	`true` cho đường viền ngang bên trong, `false` cho không có đường viền, `null` cho không có thay đổi.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 theo 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 theo ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

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

Thông số

Tên	Loại	Mô tả
`top`	`Boolean`	`true` cho đường viền, `false` cho không có đường viền, `null` cho không thay đổi.
`left`	`Boolean`	`true` cho đường viền, `false` cho không có đường viền, `null` cho không thay đổi.
`bottom`	`Boolean`	`true` cho đường viền, `false` cho không có đường viền, `null` cho không thay đổi.
`right`	`Boolean`	`true` cho đường viền, `false` cho không có đường viền, `null` cho không thay đổi.
`vertical`	`Boolean`	`true` cho đường viền dọc bên trong, `false` cho không có đường viền, `null` cho không có thay đổi.
`horizontal`	`Boolean`	`true` cho đường viền ngang bên trong, `false` cho không có đường viền, `null` cho không có thay đổi.
`color`	`String`	Màu theo 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 (đường liền nét).

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Thông 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á xác thực dữ liệu.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 một mảng xác thực dữ liệu 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 ô.

// Set the data validation rules for Sheet1!A1:B5 to require a value from
// Sheet2!A1:A10.
const destinationRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
const sourceRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
const rules = destinationRange.getDataValidations();
for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Thông số

Tên	Loại	Mô tả
`rules`	`DataValidation[][]`	Một mảng hai chiều gồm các quy tắc xác thực dữ liệu cần đặt; giá trị `null` sẽ xoá xác thực dữ liệu.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontColor(color)`

Đặt màu phông chữ theo ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

const cell = sheet.getRange('B2');
cell.setFontColor('red');

Thông số

Tên	Loại	Mô tả
`color`	`String`	Màu phông chữ theo ký hiệu CSS (chẳng hạn như `'#ffffff'` hoặc `'white'`); giá trị `null` sẽ đặt lại màu.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontColorObject(color)`

Đặt màu phông chữ cho dải ô đã cho.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                  .build();

const cell = sheet.getRange('B2');
cell.setFontColor(color);

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontColorObjects(colors)`

Đặt một lưới hình chữ nhật gồm các màu phông chữ (phải khớp với kích thước của dải ô này).

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

const colorAccent1 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                         .build();
const colorAccent2 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                         .build();
const colorAccent3 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                         .build();
const colorAccent4 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
                         .build();

const colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4],
];

const cell = sheet.getRange('B5:C6');
cell.setFontColorObjects(colors);

Thông số

Tên	Loại	Mô tả
`colors`	`Color[][]`	Một mảng màu hai chiều; giá trị `null` sẽ đặt lại màu phông chữ.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontColors(colors)`

Đặt một lưới hình chữ nhật gồm cá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 này ở ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

const colors = [
  ['red', 'white', 'blue'],
  ['#FF0000', '#FFFFFF', '#0000FF'],  // These are the hex equivalents
];

const cell = sheet.getRange('B5:D6');
cell.setFontColors(colors);

Thông số

Tên	Loại	Mô tả
`colors`	`Object[][]`	Một mảng hai chiều gồm các màu theo ký hiệu CSS (chẳng hạn như `'#ffffff'` hoặc `'white'`); các giá trị `null` sẽ đặt lại màu.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontFamilies(fontFamilies)`

Đặt một lưới hình chữ nhật gồm các bộ phông chữ (phải khớp với kích thước của dải ô này). Ví dụ về các họ phông chữ là "Arial" hoặc "Helvetica".

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

const fonts = [
  ['Arial', 'Helvetica', 'Verdana'],
  ['Courier New', 'Arial', 'Helvetica'],
];

const cell = sheet.getRange('B2:D3');
cell.setFontFamilies(fonts);

Thông số

Tên	Loại	Mô tả
`fontFamilies`	`Object[][]`	Một mảng hai chiều gồm các bộ phông chữ; giá trị `null` đặt lại bộ phông chữ.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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ư "Arial" hoặc "Helvetica".

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

const cell = sheet.getRange('B2');
cell.setFontFamily('Helvetica');

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontLine(fontLine)`

Đặt kiểu đường kẻ của phông chữ cho dải ô đã cho ('underline', 'line-through' hoặc 'none').

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

const cell = sheet.getRange('B2');
cell.setFontLine('line-through');

Thông số

Tên	Loại	Mô tả
`fontLine`	`String`	Kiểu đường kẻ của phông chữ, có thể là `'underline'`, `'line-through'` hoặc `'none'`; giá trị `null` sẽ đặt lại kiểu đường kẻ của phông chữ.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontLines(fontLines)`

Đặt một lưới hình chữ nhật gồm các kiểu đường kẻ (phải khớp với kích thước của dải ô này).

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

// The size of the two-dimensional array must match the size of the range.
const fontLines = [['underline', 'line-through', 'none']];

const range = sheet.getRange('B2:D2');
range.setFontLines(fontLines);

Thông số

Tên	Loại	Mô tả
`fontLines`	`Object[][]`	Một mảng hai chiều gồm các kiểu đường kẻ của phông chữ (`'underline'`, `'line-through'` hoặc `'none'`); các giá trị `null` sẽ đặt lại kiểu đường kẻ của phông chữ.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontSize(size)`

Đặt cỡ chữ, trong đó cỡ chữ là cỡ chữ tính bằng điểm cần sử dụng.

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

const cell = sheet.getRange('B2');
cell.setFontSize(20);

Thông số

Tên	Loại	Mô tả
`size`	`Integer`	Cỡ chữ tính bằng điểm.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontSizes(sizes)`

Đặt một lưới hình chữ nhật gồm các cỡ chữ (phải khớp với kích thước của dải ô này). Kích thước tính bằng điểm.

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

// The size of the two-dimensional array must match the size of the range.
const fontSizes = [[16, 20, 24]];

const range = sheet.getRange('B2:D2');
range.setFontSizes(fontSizes);

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

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

const cell = sheet.getRange('B2');
cell.setFontStyle('italic');

Thông số

Tên	Loại	Mô tả
`fontStyle`	`String`	Kiểu phông chữ, có thể là `'italic'` hoặc `'normal'`; giá trị `null` sẽ đặt lại kiểu phông chữ.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontStyles(fontStyles)`

Đặt một lưới hình chữ nhật gồm các kiểu phông chữ (phải khớp với kích thước của dải ô này).

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

// The size of the two-dimensional array must match the size of the range.
const fontStyles = [['italic', 'normal']];

const range = sheet.getRange('B2:C2');
range.setFontStyles(fontStyles);

Thông số

Tên	Loại	Mô tả
`fontStyles`	`Object[][]`	Một mảng hai chiều gồm các kiểu phông chữ, có thể là `'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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontWeight(fontWeight)`

Đặt độ đậm của phông chữ cho dải ô đã cho (bình thường/đậm).

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

const cell = sheet.getRange('B2');
cell.setFontWeight('bold');

Thông số

Tên	Loại	Mô tả
`fontWeight`	`String`	Độ đậm của phông chữ, có thể là `'bold'` hoặc `'normal'`; giá trị `null` sẽ đặt lại độ đậm của phông chữ.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFontWeights(fontWeights)`

Đặt một lưới hình chữ nhật gồm các độ đậm của phông chữ (phải khớp với kích thước của dải ô này). Ví dụ về trọng lượng phông chữ là "đậm".

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

// The size of the two-dimensional array must match the size of the range.
const fontStyles = [['bold', 'bold', 'normal']];

const range = sheet.getRange('B2:D2');
range.setFontWeights(fontStyles);

Thông số

Tên	Loại	Mô tả
`fontWeights`	`Object[][]`	Một mảng hai chiều gồm các độ đậm phông chữ, có thể là `'bold'` hoặc `'normal'`; các giá trị `null` sẽ đặt lại độ đậm phông chữ.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ở ký hiệu A1.

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

const cell = sheet.getRange('B5');
cell.setFormula('=SUM(B3:B4)');

Thông số

Tên	Loại	Mô tả
`formula`	`String`	Một chuỗi biểu thị công thức cần đặt cho ô.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ở ký hiệu R1C1.

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

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

Thông số

Tên	Loại	Mô tả
`formula`	`String`	Một công thức chuỗi.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFormulas(formulas)`

Đặt một lưới công thức hình chữ nhật (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 ở 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, sau đó theo cột. Kích thước mảng phải tương ứng với kích thước dải ô.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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.
const formulas = [
  ['=SUM(B2:B4)', '=SUM(C2:C4)', '=SUM(D2:D4)'],
  ['=AVERAGE(B2:B4)', '=AVERAGE(C2:C4)', '=AVERAGE(D2:D4)'],
];

const cell = sheet.getRange('B5:D6');
cell.setFormulas(formulas);

Thông số

Tên	Loại	Mô tả
`formulas`	`String[][]`	Một mảng chuỗi hai chiều gồm các công thức.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setFormulasR1C1(formulas)`

Đặt một lưới công thức hình chữ nhật (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 ở ký hiệu R1C1.

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

// This creates formulas for a row of sums, followed by a row of averages.
const sumOfRowsAbove = '=SUM(R[-3]C[0]:R[-1]C[0])';
const averageOfRowsAbove = '=AVERAGE(R[-4]C[0]:R[-2]C[0])';

// The size of the two-dimensional array must match the size of the range.
const formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove],
];

const cell = sheet.getRange('B5:D6');
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setHorizontalAlignment(alignment)`

Đặt chế độ căn chỉnh ngang (từ trái sang phải) cho dải ô đã cho (trái/giữa/phải).

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

const cell = sheet.getRange('B2');
cell.setHorizontalAlignment('center');

Thông số

Tên	Loại	Mô tả
`alignment`	`String`	Vị trí căn chỉnh, có thể là `'left'`, `'center'` hoặc `'normal'`; giá trị `null` sẽ đặt lại vị trí căn chỉnh.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setHorizontalAlignments(alignments)`

Đặt một lưới hình chữ nhật gồm các chế độ căn chỉnh ngang. xem setHorizontalAlignment(alignment)

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

// The size of the two-dimensional array must match the size of the range.
const horizontalAlignments = [['left', 'right', 'center']];

const range = sheet.getRange('B2:D2');
range.setHorizontalAlignments(horizontalAlignments);

Thông số

Tên	Loại	Mô tả
`alignments`	`Object[][]`	Một mảng căn chỉnh hai chiều, có thể là `'left'`, `'center'` hoặc `'normal'`; giá trị `null` sẽ đặt lại chế độ căn chỉnh.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.

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

const cell = sheet.getRange('B2');
cell.setNote('This is a note');

Thông số

Tên	Loại	Mô tả
`note`	`String`	Giá trị nốt nhạc cần đặt cho phạm vi; giá trị `null` sẽ xoá nốt nhạc.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setNotes(notes)`

Đặt một lưới hình chữ nhật gồm các nốt (phải khớp với kích thước của dải ô này).

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

// The size of the two-dimensional array must match the size of the range.
const notes = [
  ['it goes', 'like this', 'the fourth, the fifth'],
  ['the minor fall', 'and the', 'major lift'],
];

const cell = sheet.getRange('B2:D3');
cell.setNotes(notes);

Thông số

Tên	Loại	Mô tả
`notes`	`Object[][]`	Một mảng hai chiều gồm các ghi chú; giá trị `null` sẽ xoá ghi chú.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Các mẫu định dạng được chấp nhận được mô tả trong tài liệu về Sheets API.

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

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

Thông số

Tên	Loại	Mô tả
`numberFormat`	`String`	Một chuỗi định dạng số.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 gồm các định dạng số hoặc ngày (phải khớp với kích thước của dải ô này). Các giá trị này là chuỗi mẫu định dạng như được mô tả trong tài liệu về Sheets API.

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

// The size of the two-dimensional array must match the size of the range.
const formats = [['0.000', '0,000,000', '$0.00']];

const range = sheet.getRange('B2:D2');
range.setNumberFormats(formats);

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const richText = SpreadsheetApp.newRichTextValue()
                     .setText('Hello world')
                     .setTextStyle(0, 5, bold)
                     .build();
range.setRichTextValue(richText);

Thông số

Tên	Loại	Mô tả
`value`	`RichTextValue`	Giá trị Văn bản đa dạng thức mong muốn.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setRichTextValues(values)`

Đặt một lưới hình chữ nhật gồm 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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:A2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
const richTextA1 = SpreadsheetApp.newRichTextValue()
                       .setText('This cell is bold')
                       .setTextStyle(bold)
                       .build();
const richTextA2 = SpreadsheetApp.newRichTextValue()
                       .setText('bold words, italic words')
                       .setTextStyle(0, 11, bold)
                       .setTextStyle(12, 24, italic)
                       .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Thông số

Tên	Loại	Mô tả
`values`	`RichTextValue[][]`	Giá trị Văn bản đa dạng thức mong muốn.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setShowHyperlink(showHyperlink)`

Đặt 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);

Thông số

Tên	Loại	Mô tả
`showHyperlink`	`Boolean`	Có hiện siêu liên kết hay không.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setTextDirection(direction)`

Đặt hướng văn bản cho các ô trong dải ô. Nếu hướng được chỉ định là null, thì hướng sẽ được suy luận rồi đặt.

// Sets right-to-left text direction for the range.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Thông 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 khi đặt.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setTextDirections(directions)`

Đặt một lưới ô hình chữ nhật gồm các hướng văn bản. Nếu hướng được chỉ định là null, thì hướng sẽ được suy luận rồi đặt.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextDirections());

Thông số

Tên	Loại	Mô tả
`directions`	`TextDirection[][]`	Hướng văn bản mong muốn; nếu hướng được chỉ định là `null`, thì hướng đó sẽ được suy luận trước khi thiết lập.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setTextRotation(degrees)`

Đặt chế độ xoay văn bản cho các ô trong dải ô. Đầu vào tương ứng với góc giữa hướng văn bản tiêu chuẩn và hướng mong muốn. Đầu vào bằng 0 cho biết văn bản được đặt thành hướng tiêu chuẩn.

Đối với hướng văn bản từ trái sang phải, các góc dương theo hướng ngược chiều kim đồng hồ, trong khi đối với hướng văn bản từ phải sang trái, các góc dương theo hướng chiều kim đồng hồ.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setTextRotation(45);

Thông số

Tên	Loại	Mô tả
`degrees`	`Integer`	Góc mong muốn giữa hướng tiêu 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 nằm theo hướng ngược chiều kim đồng hồ.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setTextRotation(rotation)`

Đặt 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.
const sheet = SpreadsheetApp.getActiveSheet();

const rotation = sheet.getRange('A1').getTextRotation();

sheet.getRange('B2:D4').setTextRotation(rotation);

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setTextRotations(rotations)`

Đặt một lưới hình chữ nhật gồm các hướng xoay văn bản.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextRotations());

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('C5:D6');
const style =
    SpreadsheetApp.newTextStyle().setFontSize(15).setUnderline(true).build();
range.setTextStyle(style);

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setTextStyles(styles)`

Đặt một lưới hình chữ nhật gồm các kiểu văn bản.

// Sets text styles for cells in range A1:B2
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const otherStyle = SpreadsheetApp.newTextStyle()
                       .setBold(true)
                       .setUnderline(true)
                       .setItalic(true)
                       .setForegroundColor('#335522')
                       .setFontSize(44)
                       .build();
range.setTextStyles([
  [bold, otherStyle],
  [otherStyle, bold],
]);

Thông số

Tên	Loại	Mô tả
`styles`	`TextStyle[][]`	Kiểu chữ mong muốn.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 bắt đầu bằng '=', thì giá trị này được hiểu là một công thức.

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

const cell = sheet.getRange('B2');
cell.setValue(100);

Thông số

Tên	Loại	Mô tả
`value`	`Object`	Giá trị cho phạm vi.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setValues(values)`

Đặt một lưới giá trị hình chữ nhật (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 =, thì giá trị đó sẽ được hiểu là một công thức.

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

// The size of the two-dimensional array must match the size of the range.
const values = [['2.000', '1,000,000', '$2.99']];

const range = sheet.getRange('B2:D2');
range.setValues(values);

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setVerticalAlignment(alignment)`

Đặt chế độ căn chỉnh theo chiều dọc (từ trên xuống dưới) cho phạm vi đã cho (trên cùng/giữa/dưới cùng).

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

const cell = sheet.getRange('B2');
cell.setVerticalAlignment('middle');

Thông số

Tên	Loại	Mô tả
`alignment`	`String`	Vị trí căn chỉnh, có thể là `'top'`, `'middle'` hoặc `'bottom'`; giá trị `null` sẽ đặt lại vị trí căn chỉnh.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setVerticalAlignments(alignments)`

Đặt một lưới hình chữ nhật gồm các chế độ căn chỉnh theo chiều dọc (phải khớp với kích thước của dải ô này).

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

// The size of the two-dimensional array must match the size of the range.
const alignments = [['top', 'middle', 'bottom']];

const range = sheet.getRange('B2:D2');
range.setVerticalAlignments(alignments);

Thông số

Tên	Loại	Mô tả
`alignments`	`Object[][]`	Một mảng căn chỉnh hai chiều, có thể là `'top'`, `'middle'` hoặc `'bottom'`; giá trị `null` sẽ đặt lại chế độ căn chỉnh.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 được xếp chồng theo chiều dọc, thì chế độ cài đặt xoay văn bản theo độ sẽ bị bỏ qua.

// Sets all cell's in range B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setVerticalText(true);

Thông số

Tên	Loại	Mô tả
`isVertical`	`Boolean`	Có xếp chồng văn bản hay không.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setWrap(isWrapEnabled)`

Đặt chế độ xuống dòng của ô cho dải ô đã cho.

Các ô có chế độ xuống dòng được bật (theo mặc định) sẽ thay đổi kích thước để hiển thị toàn bộ nội dung. Các ô có tính năng ngắt dòng bị tắt sẽ hiển thị nhiều nhất có thể trong ô mà không cần đổi kích thước hoặc chạy thành nhiều dòng.

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

const cell = sheet.getRange('B2');
cell.setWrap(true);

Thông số

Tên	Loại	Mô tả
`isWrapEnabled`	`Boolean`	Có xuống dòng tự động hay không.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setWrapStrategies(strategies)`

Đặt một lưới hình chữ nhật gồm các chiến lược bao bọc.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setWrapStrategies(range1.getWrapStrategies());

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setWrapStrategy(strategy)`

Đặt chiến lược ngắt dòng cho các ô trong dải ô.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Thông 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 – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`setWraps(isWrapEnabled)`

Đặt một lưới hình chữ nhật gồm các chính sách ngắt dòng (phải khớp với kích thước của dải ô này). Các ô có chế độ xuống dòng được bật (mặc định) sẽ thay đổi kích thước để hiển thị toàn bộ nội dung. Các ô không bật tính năng xuống dòng sẽ hiển thị nhiều nội dung nhất có thể trong ô mà không cần đổi kích thước hoặc chạy thành nhiều dòng.

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

// The size of the two-dimensional array must match the size of the range.
const wraps = [[true, true, false]];

const range = sheet.getRange('B2:D2');
range.setWraps(wraps);

Thông số

Tên	Loại	Mô tả
`isWrapEnabled`	`Object[][]`	Một mảng hai chiều gồm các biến xuống dòng giúp xác định xem có xuống dòng văn bản trong một ô hay không.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 của nhóm cột trong dải ô theo số lượng được chỉ định.

Điều này có tác dụng tạo, sửa đổi hoặc xoá các nhóm giao với dải ô. Đối với các delta dương, các nhóm được tạo và/hoặc sửa đổi; đối với các delta âm, các nhóm bị huỷ và/hoặc sửa đổi.

Điều này không có hiệu lực khi bạn giảm độ sâu nhóm xuống dưới 0 hoặc trên 8.

Nếu column group control position là BEFORE, thao tác này sẽ gây ra lỗi khi bạn tìm cách thay đổi độ sâu của hàng đầu tiên.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const 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);

Thông số

Tên	Loại	Mô tả
`delta`	`Integer`	Số lượng mà bạn muốn 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 – Phạm vi 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`shiftRowGroupDepth(delta)`

Thay đổi chiều sâu của nhóm hàng trong dải ô theo số lượng được chỉ định.

Điều này không có hiệu lực khi bạn giảm độ sâu 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ẽ gây ra lỗi khi bạn tìm cách thay đổi độ sâu của hàng đầu tiên.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const 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);

Thông số

Tên	Loại	Mô tả
`delta`	`Integer`	Số lượng mà bạn muốn thay đổi chiều sâu của nhóm hàng trong phạm vi này.

Cầu thủ trả bóng

Range – Phạm vi 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 vị trí điều khiển là GroupControlTogglePosition.BEFORE

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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},
]);

Thông số

Tên	Loại	Mô tả
`sortSpecObj`	`Object`	Các cột để sắp xếp.

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 cách được tự động phát hiện.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns();

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`splitTextToColumns(delimiter)`

Phân tách một cột văn bản thành nhiều cột bằng cách sử dụng chuỗi đã chỉ định làm dấu phân cá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|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns('#');

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Thông số

Tên	Loại	Mô tả
`delimiter`	`String`	Dấu phân cách tuỳ chỉnh để phân tách.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 cách đã chỉ định.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Thông số

Tên	Loại	Mô tả
`delimiter`	`TextToColumnsDelimiter`	Dấu phân cách đặt sẵn để phân tách.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`trimWhitespace()`

Xoá khoảng trắng (chẳng hạn như dấu cách, dấu tab hoặc dòng mới) trong mọi ô thuộc dải ô này. Xoá tất cả khoảng trắng ở đầu và cuối văn bản của mỗi ô, đồng thời giảm mọi chuỗi ký tự khoảng trắng còn lại thành một dấu cách duy nhất.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

range.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 phạm vi thành "chưa đánh dấu". Bỏ qua các ô trong phạm vi hiện không chứa giá trị đã đánh dấu hoặc chưa đánh dấu được đị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'.
const range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

Cầu thủ trả bóng

Range – Phạm vi này, để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô, theo ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

Logger.log(range.getFontColor());

Cầu thủ trả bóng

String – Màu phông chữ theo ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 ô ở ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white').

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

const results = range.getFontColors();

for (const i in results) {
  for (const 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 màu phông chữ được liên kết với các ô trong dải ô.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Class Range Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Phương thức

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

Tài liệu chi tiết

activate()

Cầu thủ trả bóng

activateAsCurrentCell()

Cầu thủ trả bóng

Ủy quyền

addDeveloperMetadata(key)

Thông số

Cầu thủ trả bóng

Ủy quyền

addDeveloperMetadata(key, visibility)

Thông số

Cầu thủ trả bóng

Ủy quyền

addDeveloperMetadata(key, value)

Thông số

Cầu thủ trả bóng

Ủy quyền

addDeveloperMetadata(key, value, visibility)

Thông số

Cầu thủ trả bóng

Ủy quyền

applyColumnBanding()

Cầu thủ trả bóng

Ủy quyền

applyColumnBanding(bandingTheme)

Thông số

Cầu thủ trả bóng

Ủy quyền

applyColumnBanding(bandingTheme, showHeader, showFooter)

Thông số

Cầu thủ trả bóng

Ủy quyền

applyRowBanding()

Cầu thủ trả bóng

Ủy quyền

applyRowBanding(bandingTheme)

Thông số

Cầu thủ trả bóng

Ủy quyền

applyRowBanding(bandingTheme, showHeader, showFooter)

Thông số

Cầu thủ trả bóng

Ủy quyền

autoFill(destination, series)

Thông số

Ủy quyền

autoFillToNeighbor(series)

Thông số

Ủy quyền

breakApart()

Cầu thủ trả bóng

Ủy quyền

canEdit()

Cầu thủ trả bóng

Ủy quyền

check()

Cầu thủ trả bóng

Ủy quyền

clear()

Cầu thủ trả bóng

Ủy quyền

clear(options)

Thông số

Thông số nâng cao

Cầu thủ trả bóng

Ủy quyền

clearContent()

Cầu thủ trả bóng

Ủy quyền

clearDataValidations()

Cầu thủ trả bóng

Ủy quyền

clearFormat()

Cầu thủ trả bóng

Ủy quyền

clearNote()

Class Range

`activate()`

`activateAsCurrentCell()`

`addDeveloperMetadata(key)`

`addDeveloperMetadata(key, visibility)`

`addDeveloperMetadata(key, value)`

`addDeveloperMetadata(key, value, visibility)`

`applyColumnBanding()`

`applyColumnBanding(bandingTheme)`

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

`applyRowBanding()`

`applyRowBanding(bandingTheme)`

`applyRowBanding(bandingTheme, showHeader, showFooter)`

`autoFill(destination, series)`

`autoFillToNeighbor(series)`

`breakApart()`

`canEdit()`

`check()`

`clear()`

`clear(options)`

`clearContent()`

`clearDataValidations()`

`clearFormat()`

`clearNote()`

`collapseGroups()`

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

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

`copyTo(destination)`

`copyTo(destination, copyPasteType, transposed)`

`copyTo(destination, options)`

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

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

`createDataSourcePivotTable(dataSource)`

`createDataSourceTable(dataSource)`

`createDeveloperMetadataFinder()`

`createFilter()`

`createPivotTable(sourceData)`

`createTextFinder(findText)`

`deleteCells(shiftDimension)`

`expandGroups()`

`getA1Notation()`

`getBackground()`

`getBackgroundObject()`

`getBackgroundObjects()`

`getBackgrounds()`