Class Sheet

Truy cập và sửa đổi các trang trong bảng tính. Các thao tác thường dùng là đổi tên trang tính và truy cập vào các đối tượng dải ô trong trang tính.

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`activate()`	`Sheet`	Kích hoạt trang tính này.
`addDeveloperMetadata(key)`	`Sheet`	Thêm siêu dữ liệu nhà phát triển có khoá được chỉ định vào trang tính.
`addDeveloperMetadata(key, visibility)`	`Sheet`	Thêm siêu dữ liệu nhà phát triển có khoá và chế độ hiển thị được chỉ định vào trang tính.
`addDeveloperMetadata(key, value)`	`Sheet`	Thêm siêu dữ liệu nhà phát triển có khoá và giá trị được chỉ định vào trang tính.
`addDeveloperMetadata(key, value, visibility)`	`Sheet`	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 trang tính.
`appendRow(rowContents)`	`Sheet`	Thêm một hàng vào cuối vùng dữ liệu hiện tại trong trang tính.
`asDataSourceSheet()`	`DataSourceSheet\|null`	Trả về trang tính dưới dạng `DataSourceSheet` nếu trang tính thuộc loại `SheetType.DATASOURCE` hoặc `null` trong trường hợp ngược lại.
`autoResizeColumn(columnPosition)`	`Sheet`	Đặt chiều rộng của cột đã cho cho phù hợp với nội dung của cột đó.
`autoResizeColumns(startColumn, numColumns)`	`Sheet`	Đặt chiều rộng của tất cả các cột bắt đầu từ vị trí cột đã cho để vừa với nội dung của chúng.
`autoResizeRows(startRow, numRows)`	`Sheet`	Đặt chiều cao của tất cả các hàng bắt đầu từ vị trí hàng đã cho để phù hợp với nội dung của chúng.
`clear()`	`Sheet`	Xoá nội dung và thông tin định dạng khỏi trang tính.
`clear(options)`	`Sheet`	Xoá nội dung và/hoặc định dạng của trang tính, như được chỉ định bằng các lựa chọn nâng cao đã cho.
`clearConditionalFormatRules()`	`void`	Xoá tất cả quy tắc định dạng có điều kiện khỏi trang tính.
`clearContents()`	`Sheet`	Xoá nội dung trong trang tính, nhưng vẫn giữ lại thông tin định dạng.
`clearFormats()`	`Sheet`	Xoá định dạng của trang tính, nhưng vẫn giữ lại nội dung.
`clearNotes()`	`Sheet`	Xoá tất cả ghi chú trên trang tính.
`collapseAllColumnGroups()`	`Sheet`	Thu gọn tất cả các nhóm cột trên trang tính.
`collapseAllRowGroups()`	`Sheet`	Thu gọn tất cả các nhóm hàng trên trang tính.
`copyTo(spreadsheet)`	`Sheet`	Sao chép trang tính vào một bảng tính nhất định. Bảng tính này có thể là bảng tính giống với nguồn.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Trả về một `DeveloperMetadataFinder` để tìm siêu dữ liệu nhà phát triển trong phạm vi của trang tính này.
`createTextFinder(findText)`	`TextFinder`	Tạo một trình tìm văn bản cho trang tính, có thể tìm và thay thế văn bản trong trang tính.
`deleteColumn(columnPosition)`	`Sheet`	Xoá cột ở vị trí cột đã cho.
`deleteColumns(columnPosition, howMany)`	`void`	Xoá một số cột bắt đầu từ vị trí cột đã cho.
`deleteRow(rowPosition)`	`Sheet`	Xoá hàng ở vị trí hàng đã cho.
`deleteRows(rowPosition, howMany)`	`void`	Xoá một số hàng bắt đầu từ vị trí hàng đã cho.
`expandAllColumnGroups()`	`Sheet`	Mở rộng tất cả các nhóm cột trên trang tính.
`expandAllRowGroups()`	`Sheet`	Mở rộng tất cả các nhóm hàng trên trang tính.
`expandColumnGroupsUpToDepth(groupDepth)`	`Sheet`	Mở rộng tất cả các nhóm cột đến độ sâu đã cho và thu gọn tất cả các nhóm cột khác.
`expandRowGroupsUpToDepth(groupDepth)`	`Sheet`	Mở rộng tất cả các nhóm hàng lên đến độ sâu đã cho và thu gọn tất cả các nhóm hàng khác.
`getActiveCell()`	`Range`	Trả về ô đang hoạt động trong trang tính này.
`getActiveRange()`	`Range`	Trả về dải ô đã chọn trong trang tính đang hoạt động hoặc `null` nếu không có dải ô đang hoạt động.
`getActiveRangeList()`	`RangeList\|null`	Trả về danh sách các dải ô đang hoạt động trong trang tính đang hoạt động hoặc `null` nếu không có dải ô nào đang hoạt động.
`getBandings()`	`Banding[]`	Trả về tất cả các dải màu trong trang tính này.
`getCharts()`	`EmbeddedChart[]`	Trả về một mảng biểu đồ trên trang tính này.
`getColumnGroup(columnIndex, groupDepth)`	`Group\|null`	Trả về nhóm cột tại chỉ mục và chiều sâu nhóm đã cho.
`getColumnGroupControlPosition()`	`GroupControlTogglePosition`	Trả về `GroupControlTogglePosition` cho tất cả các nhóm cột trên trang tính.
`getColumnGroupDepth(columnIndex)`	`Integer`	Trả về độ sâu nhóm của cột tại chỉ mục đã cho.
`getColumnWidth(columnPosition)`	`Integer`	Lấy chiều rộng tính bằng pixel của cột đã cho.
`getConditionalFormatRules()`	`ConditionalFormatRule[]`	Lấy tất cả các quy tắc định dạng có điều kiện trong trang tính này.
`getCurrentCell()`	`Range\|null`	Trả về ô hiện tại trong trang tính đang hoạt động hoặc `null` nếu không có ô hiện tại.
`getDataRange()`	`Range`	Trả về một `Range` tương ứng với các phương diện có dữ liệu.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Lấy tất cả công thức nguồn dữ liệu.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Lấy tất cả bảng tổng hợp nguồn dữ liệu.
`getDataSourceTables()`	`DataSourceTable[]`	Lấy tất cả các bảng nguồn dữ liệu.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Lấy tất cả siêu dữ liệu của nhà phát triển được liên kết với trang tính này.
`getDrawings()`	`Drawing[]`	Trả về một mảng các bản vẽ trên trang tính.
`getFilter()`	`Filter\|null`	Trả về bộ lọc trong trang tính này hoặc `null` nếu không có bộ lọc.
`getFormUrl()`	`String\|null`	Trả về URL của biểu mẫu gửi câu trả lời đến trang tính này hoặc `null` nếu trang tính này không có biểu mẫu được liên kết.
`getFrozenColumns()`	`Integer`	Trả về số lượng cột được cố định.
`getFrozenRows()`	`Integer`	Trả về số hàng được cố định.
`getImages()`	`OverGridImage[]`	Trả về tất cả hình ảnh nằm ngoài lưới trên trang tính.
`getIndex()`	`Integer`	Lấy vị trí của trang trong bảng tính mẹ.
`getLastColumn()`	`Integer`	Trả về vị trí của cột cuối cùng có nội dung.
`getLastRow()`	`Integer`	Trả về vị trí của hàng cuối cùng có nội dung.
`getMaxColumns()`	`Integer`	Trả về số lượng cột hiện tại trong trang tính, bất kể nội dung.
`getMaxRows()`	`Integer`	Trả về số lượng hàng hiện tại trong trang tính, bất kể nội dung.
`getName()`	`String`	Trả về tên của trang tính.
`getNamedRanges()`	`NamedRange[]`	Lấy tất cả các dải ô có tên trong trang tính này.
`getParent()`	`Spreadsheet`	Trả về `Spreadsheet` chứa trang tính này.
`getPivotTables()`	`PivotTable[]`	Trả về tất cả bảng tổng hợp trên trang tính này.
`getProtections(type)`	`Protection[]`	Lấy một mảng các đối tượng đại diện cho tất cả dải ô được bảo vệ trong trang tính hoặc một mảng có một phần tử đại diện cho chế độ bảo vệ trên chính trang tính đó.
`getRange(row, column)`	`Range`	Trả về dải ô có ô trên cùng bên trái tại toạ độ đã cho.
`getRange(row, column, numRows)`	`Range`	Trả về dải ô có ô trên cùng bên trái tại toạ độ đã cho và có số hàng đã cho.
`getRange(row, column, numRows, numColumns)`	`Range`	Trả về dải ô có ô trên cùng bên trái tại toạ độ đã cho với số lượng hàng và cột đã cho.
`getRange(a1Notation)`	`Range`	Trả về dải ô như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1.
`getRangeList(a1Notations)`	`RangeList`	Trả về tập hợp `RangeList` biểu thị các dải ô trong cùng một trang tính do danh sách không trống gồm ký hiệu A1 hoặc ký hiệu R1C1 chỉ định.
`getRowGroup(rowIndex, groupDepth)`	`Group\|null`	Trả về nhóm hàng tại chỉ mục và chiều sâu nhóm đã cho.
`getRowGroupControlPosition()`	`GroupControlTogglePosition`	Trả về `GroupControlTogglePosition` cho tất cả các nhóm hàng trên trang tính.
`getRowGroupDepth(rowIndex)`	`Integer`	Trả về độ sâu nhóm của hàng tại chỉ mục đã cho.
`getRowHeight(rowPosition)`	`Integer`	Lấy chiều cao tính bằng pixel của hàng đã cho.
`getSelection()`	`Selection`	Trả về `Selection` hiện tại trong bảng tính.
`getSheetId()`	`Integer`	Trả về mã nhận dạng của trang tính do đối tượng này đại diện.
`getSheetName()`	`String`	Trả về tên trang tính.
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	Trả về lưới giá trị hình chữ nhật cho dải ô này, bắt đầu từ toạ độ đã cho.
`getSlicers()`	`Slicer[]`	Trả về một mảng các bộ chọn trên trang tính.
`getTabColorObject()`	`Color\|null`	Lấy màu thẻ trang tính hoặc `null` nếu thẻ trang tính không có màu.
`getType()`	`SheetType`	Trả về loại trang tính.
`hasHiddenGridlines()`	`Boolean`	Trả về `true` nếu đường kẻ ô của trang tính bị ẩn; nếu không thì trả về `false`.
`hideColumn(column)`	`void`	Ẩn cột hoặc các cột trong dải ô đã cho.
`hideColumns(columnIndex)`	`void`	Ẩn một cột tại chỉ mục đã cho.
`hideColumns(columnIndex, numColumns)`	`void`	Ẩn một hoặc nhiều cột liên tiếp bắt đầu từ chỉ mục đã cho.
`hideRow(row)`	`void`	Ẩn các hàng trong dải ô đã cho.
`hideRows(rowIndex)`	`void`	Ẩn hàng ở chỉ mục đã cho.
`hideRows(rowIndex, numRows)`	`void`	Ẩn một hoặc nhiều hàng liên tiếp bắt đầu từ chỉ mục đã cho.
`hideSheet()`	`Sheet`	Ẩn trang tính này.
`insertChart(chart)`	`void`	Thêm một biểu đồ mới vào trang tính này.
`insertColumnAfter(afterPosition)`	`Sheet`	Chèn một cột sau vị trí cột đã cho.
`insertColumnBefore(beforePosition)`	`Sheet`	Chèn một cột trước vị trí cột đã cho.
`insertColumns(columnIndex)`	`void`	Chèn một cột trống vào trang tính ở vị trí được chỉ định.
`insertColumns(columnIndex, numColumns)`	`void`	Chèn một hoặc nhiều cột trống liên tiếp vào một trang tính, bắt đầu từ vị trí được chỉ định.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Chèn một số cột nhất định sau vị trí cột đã cho.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Chèn một số cột trước vị trí cột đã cho.
`insertImage(blobSource, column, row)`	`OverGridImage`	Chèn `BlobSource` dưới dạng hình ảnh vào tài liệu tại một hàng và cột nhất định.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	Chèn `BlobSource` dưới dạng hình ảnh vào tài liệu tại một hàng và cột nhất định, với độ lệch pixel.
`insertImage(url, column, row)`	`OverGridImage`	Chèn hình ảnh vào tài liệu tại một hàng và cột nhất định.
`insertImage(url, column, row, offsetX, offsetY)`	`OverGridImage`	Chèn hình ảnh vào tài liệu tại một hàng và cột nhất định, với độ lệch tính bằng pixel.
`insertRowAfter(afterPosition)`	`Sheet`	Chèn một hàng sau vị trí hàng đã cho.
`insertRowBefore(beforePosition)`	`Sheet`	Chèn một hàng trước vị trí hàng đã cho.
`insertRows(rowIndex)`	`void`	Chèn một hàng trống vào trang tính ở vị trí được chỉ định.
`insertRows(rowIndex, numRows)`	`void`	Chèn một hoặc nhiều hàng trống liên tiếp vào một trang tính, bắt đầu từ vị trí được chỉ định.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Chèn một số hàng sau vị trí hàng đã cho.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Chèn một số hàng trước vị trí hàng đã cho.
`insertSlicer(range, anchorRowPos, anchorColPos)`	`Slicer`	Thêm một bộ cắt mới vào trang tính này.
`insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)`	`Slicer`	Thêm một bộ cắt mới vào trang tính này.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Trả về việc người dùng có ẩn cột đã cho hay không.
`isRightToLeft()`	`Boolean`	Trả về `true` nếu bố cục trang tính này là từ phải sang trái.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Trả về liệu hàng đã cho có bị ẩn bởi một bộ lọc (không phải chế độ xem bộ lọc) hay không.
`isRowHiddenByUser(rowPosition)`	`Boolean`	Trả về liệu người dùng có ẩn hàng đã cho hay không.
`isSheetHidden()`	`Boolean`	Trả về `true` nếu trang tính hiện đang bị ẩn.
`moveColumns(columnSpec, destinationIndex)`	`void`	Di chuyển các cột được chọn theo dải ô đã cho đến vị trí được biểu thị bằng `destinationIndex`.
`moveRows(rowSpec, destinationIndex)`	`void`	Di chuyển các hàng được chọn theo dải ô đã cho đến vị trí được chỉ định bằng `destinationIndex`.
`newChart()`	`EmbeddedChartBuilder`	Trả về một trình tạo để tạo biểu đồ mới cho trang tính này.
`protect()`	`Protection`	Tạo một đối tượng có thể bảo vệ trang tính khỏi bị chỉnh sửa, trừ những người dùng có quyền.
`removeChart(chart)`	`void`	Xoá biểu đồ khỏi trang tính mẹ.
`setActiveRange(range)`	`Range`	Đặt dải ô được chỉ định làm `active range` trong trang tính đang hoạt động, với ô trên cùng bên trái trong dải ô làm `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Đặt danh sách dải ô đã chỉ định làm `active ranges` trong trang tính đang hoạt động.
`setActiveSelection(range)`	`Range`	Đặt vùng chọn đang hoạt động cho trang tính này.
`setActiveSelection(a1Notation)`	`Range`	Đặt vùng chọn đang hoạt động, như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1.
`setColumnGroupControlPosition(position)`	`Sheet`	Đặt vị trí của nút bật/tắt điều khiển nhóm cột trên trang tính.
`setColumnWidth(columnPosition, width)`	`Sheet`	Đặt chiều rộng của cột đã cho theo pixel.
`setColumnWidths(startColumn, numColumns, width)`	`Sheet`	Đặt chiều rộng của các cột đã cho theo pixel.
`setConditionalFormatRules(rules)`	`void`	Thay thế tất cả các quy tắc định dạng có điều kiện hiện có trong trang tính bằng các quy tắc đầu vào.
`setCurrentCell(cell)`	`Range`	Đặt ô được chỉ định làm `current cell`.
`setFrozenColumns(columns)`	`void`	Cố định số lượng cột đã cho.
`setFrozenRows(rows)`	`void`	Cố định số hàng đã cho.
`setHiddenGridlines(hideGridlines)`	`Sheet`	Ẩn hoặc hiện đường lưới của trang tính.
`setName(name)`	`Sheet`	Đặt tên cho trang tính.
`setRightToLeft(rightToLeft)`	`Sheet`	Đặt hoặc huỷ đặt bố cục trang tính từ phải sang trái.
`setRowGroupControlPosition(position)`	`Sheet`	Đặt vị trí của nút bật/tắt điều khiển nhóm hàng trên trang tính.
`setRowHeight(rowPosition, height)`	`Sheet`	Đặt chiều cao hàng của hàng đã cho theo pixel.
`setRowHeights(startRow, numRows, height)`	`Sheet`	Đặt chiều cao của các hàng đã cho theo pixel.
`setRowHeightsForced(startRow, numRows, height)`	`Sheet`	Đặt chiều cao của các hàng đã cho theo pixel.
`setTabColor(color)`	`Sheet`	Đặt màu thẻ trang tính.
`setTabColorObject(color)`	`Sheet`	Đặt màu thẻ trang tính.
`showColumns(columnIndex)`	`void`	Hiện cột tại chỉ mục đã cho.
`showColumns(columnIndex, numColumns)`	`void`	Hiện một hoặc nhiều cột liên tiếp bắt đầu từ chỉ mục đã cho.
`showRows(rowIndex)`	`void`	Hiện hàng tại chỉ mục đã cho.
`showRows(rowIndex, numRows)`	`void`	Hiện một hoặc nhiều hàng liên tiếp bắt đầu từ chỉ mục đã cho.
`showSheet()`	`Sheet`	Hiển thị trang tính.
`sort(columnPosition)`	`Sheet`	Sắp xếp trang tính theo cột, theo thứ tự tăng dần.
`sort(columnPosition, ascending)`	`Sheet`	Sắp xếp trang tính theo cột.
`unhideColumn(column)`	`void`	Hiện cột trong dải ô đã cho.
`unhideRow(row)`	`void`	Hiện hàng trong dải ô đã cho.
`updateChart(chart)`	`void`	Cập nhật biểu đồ trên trang tính này.

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
`getSheetProtection()`	`PageProtection`	Trả về một thực thể `PageProtection` mô tả các quyền đối với trang tính hiện tại.
`getTabColor()`	`String\|null`	Lấy màu thẻ trang tính hoặc `null` nếu thẻ trang tính không có màu.
`setSheetProtection(permissions)`	`void`	Đặt quyền cho trang tính hiện tại.

Tài liệu chi tiết

`activate()`

Kích hoạt trang tính này. Không làm thay đổi chính trang tính, mà chỉ thay đổi khái niệm của thành phần mẹ về trang tính đang hoạt động.

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

Cầu thủ trả bóng

Sheet – Trang tính mới được kích hoạt.

`addDeveloperMetadata(key)`

Thêm siêu dữ liệu nhà phát triển có khoá được chỉ định vào trang tí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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

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

Tham 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

Sheet – Trang tính này, để liên kết.

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

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

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

Tham 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`	Khả năng hiển thị của siêu dữ liệu nhà phát triển mới.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

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

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

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

Tham 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

Sheet – Trang tính này, để liên kết.

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

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

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

Tham 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`	Khả năng hiển thị của siêu dữ liệu nhà phát triển mới.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`appendRow(rowContents)`

Thêm một hàng vào cuối vùng dữ liệu hiện tại trong trang tính. Nếu nội dung của một ô bắt đầu bằng =, thì nội dung đó sẽ được hiểu là một công thức.

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

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

Tham số

Tên	Loại	Mô tả
`rowContents`	`Object[]`	Một mảng các giá trị cần chèn sau hàng cuối cùng trong trang tính.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`asDataSourceSheet()`

Trả về trang tính dưới dạng DataSourceSheet nếu trang tính thuộc loại SheetType.DATASOURCE hoặc null trong trường hợp ngược lại.

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

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

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

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

Cầu thủ trả bóng

DataSourceSheet|null – Trang tính 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

`autoResizeColumn(columnPosition)`

Đặt chiều rộng của cột đã cho cho phù hợp với nội dung của cột đó.

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

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

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

Tham số

Tên	Loại	Mô tả
`columnPosition`	`Integer`	Vị trí của cột đã cho cần thay đổi kích thước.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`autoResizeColumns(startColumn, numColumns)`

Đặt chiều rộng của tất cả các cột bắt đầu từ vị trí cột đã cho để vừa với nội dung của chúng.

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

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

Tham số

Tên	Loại	Mô tả
`startColumn`	`Integer`	Cột bắt đầu cần tự động đổi kích thước.
`numColumns`	`Integer`	Số lượng cột cần tự động đổi kích thước.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`autoResizeRows(startRow, numRows)`

Đặt chiều cao của tất cả các hàng bắt đầu từ vị trí hàng đã cho để phù hợp với nội dung của chúng.

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

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

Tham số

Tên	Loại	Mô tả
`startRow`	`Integer`	Hàng bắt đầu để tự động đổi kích thước.
`numRows`	`Integer`	Số hàng cần tự động đổi kích thước.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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á nội dung và thông tin định dạng khỏi trang tính.

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

Cầu thủ trả bóng

Sheet – Trang tính đã được 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

`clear(options)`

Xoá nội dung và/hoặc định dạng của trang tính, như được chỉ định bằng các lựa chọn nâng cao đã cho.

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

Tham số

Tên	Loại	Mô tả
`options`	`Object`	Một bản đồ JavaScript chứa các lựa chọn nâng cao, được liệt kê bên dưới.

Thông số nâng cao

Tên	Loại	Mô tả
`contentsOnly`	`Boolean`	Có xoá nội dung hay không.
`formatOnly`	`Boolean`	Xác định xem có xoá định dạng hay không.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`clearConditionalFormatRules()`

Xoá tất cả quy tắc định dạng có điều kiện khỏi trang tính. Tương đương với việc gọi setConditionalFormatRules(rules) bằng một mảng trống làm dữ liệu đầu vào.

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

Ủ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

`clearContents()`

Xoá nội dung trong trang tính, nhưng vẫn giữ lại thông tin định dạng.

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

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`clearFormats()`

Xoá định dạng của trang tính, nhưng vẫn giữ lại nội dung.

Định dạng đề cập đến cách dữ liệu được định dạng theo các lựa chọn được phép trong trình đơn "Định dạng" (ví dụ: in đậm, in nghiêng, định dạng có điều kiện) chứ không phải chiều rộng hoặc chiều cao của ô.

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

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`clearNotes()`

Xoá tất cả ghi chú trên trang tính.

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

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`collapseAllColumnGroups()`

Thu gọn tất cả các nhóm cột trên trang tính.

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

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

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`collapseAllRowGroups()`

Thu gọn tất cả các nhóm hàng trên trang tính.

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

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

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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(spreadsheet)`

Sao chép trang tính vào một bảng tính nhất định. Bảng tính này có thể là bảng tính giống với nguồn. Trang tính được sao chép có tên là "Bản sao của [tên gốc]".

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

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

Tham số

Tên	Loại	Mô tả
`spreadsheet`	`Spreadsheet`	Bảng tính để sao chép trang tính này vào, có thể là cùng một bảng tính với nguồn.

Cầu thủ trả bóng

Sheet – Trang tính mới, để liên kết.

Ủ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 DeveloperMetadataFinder để tìm siêu dữ liệu nhà phát triển trong phạm vi của trang tính này. Siêu dữ liệu nằm trong phạm vi của một trang tính cụ thể nếu được liên kết với chính trang tính đó hoặc được liên kết với một hàng, cột hoặc dải ô trên trang tí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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

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

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

Cầu thủ trả bóng

DeveloperMetadataFinder – Công cụ 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 trang tính này.

`createTextFinder(findText)`

Tạo một trình tìm văn bản cho trang tính, có thể tìm và thay thế văn bản trong trang tính.

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

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

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

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

Tham 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 trang tính.

`deleteColumn(columnPosition)`

Xoá cột ở vị trí cột đã cho.

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

Tham số

Tên	Loại	Mô tả
`columnPosition`	`Integer`	Vị trí của cột, bắt đầu từ 1 cho cột đầu tiên.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`deleteColumns(columnPosition, howMany)`

Xoá một số cột bắt đầu từ vị trí cột đã cho.

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

Tham số

Tên	Loại	Mô tả
`columnPosition`	`Integer`	Vị trí của cột đầu tiên cần xoá.
`howMany`	`Integer`	Số cột cần 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

`deleteRow(rowPosition)`

Xoá hàng ở vị trí hàng đã cho.

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

Tham số

Tên	Loại	Mô tả
`rowPosition`	`Integer`	Vị trí của hàng, bắt đầu từ 1 cho hàng đầu tiên.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`deleteRows(rowPosition, howMany)`

Xoá một số hàng bắt đầu từ vị trí hàng đã cho.

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

Tham số

Tên	Loại	Mô tả
`rowPosition`	`Integer`	Vị trí của hàng đầu tiên cần xoá.
`howMany`	`Integer`	Số hàng cần 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

`expandAllColumnGroups()`

Mở rộng tất cả các nhóm cột trên trang tính. Phương thức này yêu cầu ít nhất một nhóm cột.

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

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

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`expandAllRowGroups()`

Mở rộng tất cả các nhóm hàng trên trang tính. Phương thức này yêu cầu ít nhất một nhóm hàng.

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

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

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`expandColumnGroupsUpToDepth(groupDepth)`

Mở rộng tất cả các nhóm cột đến độ sâu đã cho và thu gọn tất cả các nhóm cột khác.

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

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

Tham số

Tên	Loại	Mô tả
`groupDepth`	`Integer`	Chiều sâu nhóm tối đa để mở rộng các nhóm cột.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`expandRowGroupsUpToDepth(groupDepth)`

Mở rộng tất cả các nhóm hàng lên đến độ sâu đã cho và thu gọn tất cả các nhóm hàng khác.

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

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

Tham số

Tên	Loại	Mô tả
`groupDepth`	`Integer`	Chiều sâu nhóm tối đa để mở rộng các nhóm hàng.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`getActiveCell()`

Trả về ô đang hoạt động trong trang tính này.

Lưu ý: Bạn nên sử dụng getCurrentCell() để trả về ô được đánh dấu hiện tại.

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

Cầu thủ trả bóng

Range – Ô đang hoạt động hiện tạ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

`getActiveRange()`

Trả về dải ô đã chọn trong trang tính đang hoạt động hoặc null nếu không có dải ô đang hoạt động. Nếu bạn chọn nhiều dải ô, phương thức này sẽ chỉ trả về dải ô được chọn gần đây nhất.

Thuật ngữ "phạm vi hoạt động" đề cập đến phạm vi mà người dùng đã chọn trong trang tính đang hoạt động, nhưng trong một hàm tuỳ chỉnh, thuật ngữ này đề cập đến ô đang được tính toán lại một cách chủ động.

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

Cầu thủ trả bóng

Range – Phạm vi hoạ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

Xem thêm

setActiveRange(range)

`getActiveRangeList()`

Trả về danh sách các dải ô đang hoạt động trong trang tính đang hoạt động hoặc null nếu không có dải ô nào đang hoạt động.

Nếu bạn chọn một dải ô duy nhất, thì thao tác này sẽ hoạt động như một lệnh gọi getActiveRange().

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

Cầu thủ trả bóng

RangeList|null – Danh sách các dải ô đang hoạ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

Xem thêm

setActiveRangeList(rangeList)

`getBandings()`

Trả về tất cả các dải màu trong trang tính 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

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

Cầu thủ trả bóng

Banding[] – Tất cả các dải tần trong trang tính 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

`getCharts()`

Trả về một mảng biểu đồ trên trang tính này.

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

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

Cầu thủ trả bóng

EmbeddedChart[] – Một mảng 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

`getColumnGroup(columnIndex, groupDepth)`

Trả về nhóm cột tại chỉ mục và chiều sâu nhóm đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`columnIndex`	`Integer`	Chỉ mục cột của nút bật/tắt điều khiển nhóm hoặc chỉ mục trong nhóm.
`groupDepth`	`Integer`	Độ sâu của nhóm.

Cầu thủ trả bóng

Group|null – Nhóm cột ở chỉ mục và độ sâu điều khiển, hoặc đưa ra một ngoại lệ nếu nhóm không tồn tạ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

`getColumnGroupControlPosition()`

Trả về GroupControlTogglePosition cho tất cả các nhóm cột trên trang tính.

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

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

Cầu thủ trả bóng

GroupControlTogglePosition – true nếu nút bật/tắt điều khiển nhóm cột xuất hiện sau nhóm trên trang tính này và 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

`getColumnGroupDepth(columnIndex)`

Trả về độ sâu nhóm của cột tại chỉ mục đã cho.

Độ sâu của nhóm cho biết số lượng nhóm trùng lặp với cột. Số lượng này có thể từ 0 đến 8.

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

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

Tham số

Tên	Loại	Mô tả
`columnIndex`	`Integer`	Chỉ mục của cột.

Cầu thủ trả bóng

Integer – Chiều sâu nhóm của cột tại chỉ mục đã 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

`getColumnWidth(columnPosition)`

Lấy chiều rộng tính bằng pixel của cột đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`columnPosition`	`Integer`	Vị trí của cột cần kiểm tra.

Cầu thủ trả bóng

Integer – Chiều rộng của cột tính bằng pixel.

Ủ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

`getConditionalFormatRules()`

Lấy tất cả các quy tắc định dạng có điều kiện trong trang tính này.

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

Cầu thủ trả bóng

ConditionalFormatRule[] – Một mảng gồm tất cả các quy tắc trong trang 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

`getCurrentCell()`

Trả về ô hiện tại trong trang tính đang hoạt động hoặc null nếu không có ô hiện tại. Ô hiện tại là ô có tiêu điểm trong giao diện người dùng của Google Trang tính và được đánh dấu bằng một đường viền tối. Không bao giờ có nhiều hơn một ô hiện tại. Khi người dùng chọn một hoặc nhiều dải ô, một trong các ô trong lựa chọn đó là ô hiện tại.

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

Cầu thủ trả bóng

Range|null – Ô hiện tạ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

`getDataRange()`

Trả về một Range tương ứng với các phương diện có dữ liệu.

Chức năng này tương đương với việc tạo một Dải ô được giới hạn bởi A1 và (Sheet.getLastColumn(), Sheet.getLastRow()).

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

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

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

Cầu thủ trả bóng

Range – Một dải ô bao gồm tất cả dữ liệu 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

`getDataSourceFormulas()`

Lấy tất cả công thức nguồn dữ liệu.

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

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

// Gets an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

// Lo gs the first data source formulain the array.
console.log(dataSourceFormulas[0].getFormula());

Cầu thủ trả bóng

DataSourceFormula[] – Danh sách các công thức 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

`getDataSourcePivotTables()`

Lấy tất cả bảng tổng hợp 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 an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.getDataSourcePivotTables();

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

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.

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

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

// Gets an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

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

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

`getDeveloperMetadata()`

Lấy tất cả siêu dữ liệu của nhà phát triển được liên kết với trang tính 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

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

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

Cầu thủ trả bóng

DeveloperMetadata[] – Siêu dữ liệu nhà phát triển được liên kết với trang tính 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

`getDrawings()`

Trả về một mảng các bản vẽ trên trang tí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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

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

Cầu thủ trả bóng

Drawing[] – Danh sách các bản vẽ trên trang tính 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

`getFilter()`

Trả về bộ lọc trong trang tính này hoặc null nếu không có bộ lọc.

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

Cầu thủ trả bóng

Filter|null – 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

`getFormUrl()`

Trả về URL của biểu mẫu gửi câu trả lời đến trang tính này hoặc null nếu trang tính này không có biểu mẫu được liên kết. Gây ra một ngoại lệ nếu người dùng không có quyền chỉnh sửa bảng tính.

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

Cầu thủ trả bóng

String|null – URL của biểu mẫu đặt câu trả lời vào trang tính này hoặc null nếu trang tính này không có biểu mẫu được liên kết.

Ủ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

`getFrozenColumns()`

Trả về số lượng cột được cố định.

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

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

Cầu thủ trả bóng

Integer – Số lượng cột được cố đị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

`getFrozenRows()`

Trả về số hàng được cố định.

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

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

Cầu thủ trả bóng

Integer – Số hàng được cố đị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

`getImages()`

Trả về tất cả hình ảnh nằm ngoài lưới trên trang tính.

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

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

// Gets the over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use
// ss.getImages() instead.
const images = sheet.getImages();

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

Cầu thủ trả bóng

OverGridImage[] – Một mảng gồm các hình ảnh đè lên lướ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

`getIndex()`

Lấy vị trí của trang trong bảng tính mẹ. Bắt đầu từ 1.

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

Cầu thủ trả bóng

Integer – Vị trí của trang trong bảng 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

`getLastColumn()`

Trả về vị trí của cột cuối cùng có nội dung.

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

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

Cầu thủ trả bóng

Integer – Cột cuối cùng của trang tính có chứa nội dung.

Ủ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í của hàng cuối cùng có nội dung.

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

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

Cầu thủ trả bóng

Integer – Hàng cuối cùng của trang tính có chứa nội dung.

Ủ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

`getMaxColumns()`

Trả về số lượng cột hiện tại trong trang tính, bất kể nội dung.

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

Cầu thủ trả bóng

Integer – Chiều rộng tối đa của trang 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

`getMaxRows()`

Trả về số lượng hàng hiện tại trong trang tính, bất kể nội dung.

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

Cầu thủ trả bóng

Integer – Chiều cao tối đa của trang 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

`getName()`

Trả về tên của trang tính.

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

Cầu thủ trả bóng

String – Tên của trang 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

`getNamedRanges()`

Lấy tất cả các dải ô có tên trong trang tính này.

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

Cầu thủ trả bóng

NamedRange[] – Một mảng gồm tất cả các dải ô có tên trong trang 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

`getParent()`

Trả về Spreadsheet chứa trang tính này.

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

Cầu thủ trả bóng

Spreadsheet – Bảng 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

`getPivotTables()`

Trả về tất cả bảng tổng hợp trên trang tính 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

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

Cầu thủ trả bóng

PivotTable[] – Các bảng tổng hợp trên trang tính 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

`getProtections(type)`

Lấy một mảng các đối tượng đại diện cho tất cả dải ô được bảo vệ trong trang tính hoặc một mảng có một phần tử đại diện cho chế độ bảo vệ trên chính trang tính đó.

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

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

Tham số

Tên	Loại	Mô tả
`type`	`ProtectionType`	Loại khu vực được bảo vệ, có thể là `SpreadsheetApp.ProtectionType.RANGE` hoặc `SpreadsheetApp.ProtectionType.SHEET`.

Cầu thủ trả bóng

Protection[] – Một mảng các đối tượng đại diện cho tất cả các dải ô được bảo vệ trong trang tính hoặc một mảng có một phần tử đại diện cho chính chế độ bảo vệ trên trang 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

`getRange(row, column)`

Trả về dải ô có ô trên cùng bên trái tại toạ độ đã cho.

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

Tham số

Tên	Loại	Mô tả
`row`	`Integer`	Chỉ mục hàng của ô cần trả về; chỉ mục hàng bắt đầu từ 1.
`column`	`Integer`	Chỉ mục cột của ô cần trả về; chỉ mục cột bắt đầu từ 1.

Cầu thủ trả bóng

Range – Một dải ô chỉ chứa ô 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

`getRange(row, column, numRows)`

Trả về dải ô có ô trên cùng bên trái tại toạ độ đã cho và có số hàng đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`row`	`Integer`	Chỉ mục hàng bắt đầu của dải ô; chỉ mục hàng bắt đầu từ 1.
`column`	`Integer`	Chỉ mục cột của dải ô; chỉ mục cột bắt đầu từ 1.
`numRows`	`Integer`	Số hàng sẽ trả về.

Cầu thủ trả bóng

Range – Một dải ô chứa một cột dữ liệu duy nhất với số hàng được 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

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

Trả về dải ô có ô trên cùng bên trái tại toạ độ đã cho với số lượng hàng và cột đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`row`	`Integer`	Chỉ mục hàng bắt đầu của dải ô; chỉ mục hàng bắt đầu từ 1.
`column`	`Integer`	Chỉ mục cột bắt đầu của dải ô; chỉ mục cột bắt đầu bằng 1.
`numRows`	`Integer`	Số hàng sẽ trả về.
`numColumns`	`Integer`	Số lượng cột sẽ trả về.

Cầu thủ trả bóng

Range – Một phạm vi tương ứng với khu vực được 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

`getRange(a1Notation)`

Trả về dải ô như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1.

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

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

Tham số

Tên	Loại	Mô tả
`a1Notation`	`String`	Dải ô cần trả về, được chỉ định theo ký hiệu A1 hoặc ký hiệu R1C1.

Cầu thủ trả bóng

Range – Phạm vi tại vị trí được 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

`getRangeList(a1Notations)`

Trả về tập hợp RangeList biểu thị các dải ô trong cùng một trang tính do danh sách không trống gồm ký hiệu A1 hoặc ký hiệu R1C1 chỉ định.

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

Tham số

Tên	Loại	Mô tả
`a1Notations`	`String[]`	Danh sách các dải ô cần trả về, được chỉ định theo ký hiệu A1 hoặc ký hiệu R1C1.

Cầu thủ trả bóng

RangeList – Danh sách phạm vi tại vị trí được 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

`getRowGroup(rowIndex, groupDepth)`

Trả về nhóm hàng tại chỉ mục và chiều sâu nhóm đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`rowIndex`	`Integer`	Chỉ mục hàng của nút bật/tắt điều khiển nhóm hoặc chỉ mục trong nhóm.
`groupDepth`	`Integer`	Độ sâu của nhóm.

Cầu thủ trả bóng

Group|null – Nhóm hàng ở chỉ mục và độ sâu của bộ điều khiển, hoặc gửi một ngoại lệ nếu nhóm không tồn tạ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

`getRowGroupControlPosition()`

Trả về GroupControlTogglePosition cho tất cả các nhóm hàng trên trang tính.

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

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

Cầu thủ trả bóng

GroupControlTogglePosition — true nếu nút bật/tắt điều khiển nhóm hàng xuất hiện sau nhóm trên trang tính này và false trong trường hợp khá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

`getRowGroupDepth(rowIndex)`

Trả về độ sâu nhóm của hàng tại chỉ mục đã cho.

Độ sâu của nhóm cho biết số lượng nhóm trùng lặp với hàng. Giá trị này có thể nằm trong khoảng từ 0 đến 8.

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

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

Tham số

Tên	Loại	Mô tả
`rowIndex`	`Integer`	Chỉ mục của hàng.

Cầu thủ trả bóng

Integer – Chiều sâu nhóm của hàng tại chỉ mục đã 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

`getRowHeight(rowPosition)`

Lấy chiều cao tính bằng pixel của hàng đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`rowPosition`	`Integer`	Vị trí của hàng cần kiểm tra.

Cầu thủ trả bóng

Integer – Chiều cao của hàng tính bằng pixel.

Ủ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

`getSelection()`

Trả về Selection hiện tại trong bảng tính.

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

Cầu thủ trả bóng

Selection – Lựa chọn hiện tạ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

`getSheetId()`

Trả về mã nhận dạng của trang tính do đối tượng này đại diện.

Đây là mã nhận dạng riêng biệt của trang tính trong bảng tính. Mã nhận dạng là một số nguyên tăng đơn điệu được chỉ định tại thời điểm tạo trang tính, độc lập với vị trí của trang tính. Điều này rất hữu ích khi kết hợp với các phương thức như Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) lấy tham số gridId thay vì một thực thể Sheet.

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

Logger.log(sheet.getSheetId());

Cầu thủ trả bóng

Integer – Mã nhận dạng duy nhất của trang tính 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

`getSheetName()`

Trả về tên trang tính.

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

Logger.log(sheet.getSheetName());

Cầu thủ trả bóng

String – Tên của trang 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

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

Trả về lưới giá trị hình chữ nhật cho dải ô này, bắt đầu từ toạ độ đã cho. Giá trị -1 được cung cấp dưới dạng vị trí hàng hoặc cột tương đương với việc lấy hàng hoặc cột cuối cùng có dữ liệu trong trang tính.

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

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

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

Tham số

Tên	Loại	Mô tả
`startRow`	`Integer`	Vị trí của hàng bắt đầu.
`startColumn`	`Integer`	Vị trí của cột bắt đầu.
`numRows`	`Integer`	Số hàng sẽ trả về giá trị.
`numColumns`	`Integer`	Số cột sẽ trả về giá trị.

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

`getSlicers()`

Trả về một mảng các bộ chọn trên trang tí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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

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

Cầu thủ trả bóng

Slicer[] – Danh sách các bộ lọc trên trang tính 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

`getTabColorObject()`

Lấy màu thẻ trang tính hoặc null nếu thẻ trang tính không có màu.

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

Cầu thủ trả bóng

Color|null – Màu của thẻ trang tính hoặc null nếu thẻ trang tính không có 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

`getType()`

Trả về loại trang tính.

Loại trang tính mặc định là SheetType.GRID. Một trang tính chứa một đối tượng được nhúng duy nhất, chẳng hạn như EmbeddedChart, là một trang tính SheetType.OBJECT.

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

Cầu thủ trả bóng

SheetType – Loại trang 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

`hasHiddenGridlines()`

Trả về true nếu đường kẻ ô của trang tính bị ẩn; nếu không thì trả về false. Theo mặc định, đường lưới sẽ hiển thị.

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

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

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

Cầu thủ trả bóng

Boolean – true nếu đường lưới bị ẩn; 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

`hideColumn(column)`

Ẩn cột hoặc các cột trong dải ô đã cho.

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

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

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

Tham số

Tên	Loại	Mô tả
`column`	`Range`	Dải ô cột cầ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

`hideColumns(columnIndex)`

Ẩn một cột tại chỉ mục đã cho. Sử dụng chỉ mục 1 cho phương thức này.

Để ẩn nhiều cột bằng chỉ mục, hãy dùng hideColumns(columnIndex, numColumns).

Để ẩn nhiều cột bằng một dải ô, hãy sử dụng hideColumn().

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

Tham số

Tên	Loại	Mô tả
`columnIndex`	`Integer`	Chỉ mục của cột cầ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

`hideColumns(columnIndex, numColumns)`

Ẩn một hoặc nhiều cột liên tiếp bắt đầu từ chỉ mục đã cho. Sử dụng chỉ mục 1 cho phương thức này.

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

Tham số

Tên	Loại	Mô tả
`columnIndex`	`Integer`	Chỉ mục bắt đầu của các cột cần ẩn.
`numColumns`	`Integer`	Số cột cầ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

`hideRow(row)`

Ẩn các hàng trong dải ô đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`row`	`Range`	Dải ô hàng cầ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

`hideRows(rowIndex)`

Ẩn hàng ở chỉ mục đã cho.

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

Tham số

Tên	Loại	Mô tả
`rowIndex`	`Integer`	Chỉ mục của hàng cầ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

`hideRows(rowIndex, numRows)`

Ẩn một hoặc nhiều hàng liên tiếp bắt đầu từ chỉ mục đã cho.

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

Tham số

Tên	Loại	Mô tả
`rowIndex`	`Integer`	Chỉ mục bắt đầu của các hàng cần ẩn.
`numRows`	`Integer`	Số hàng cầ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

`hideSheet()`

Ẩn trang tính này. Không có tác dụng nếu trang tính đã bị ẩn. Nếu phương thức này được gọi trên trang tính chỉ hiển thị, thì phương thức này sẽ gửi một ngoại lệ.

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

Cầu thủ trả bóng

Sheet – Trang tính hiện tạ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

`insertChart(chart)`

Thêm một biểu đồ mới vào trang tính này.

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

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

Tham số

Tên	Loại	Mô tả
`chart`	`EmbeddedChart`	Biểu đồ cần chè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

`insertColumnAfter(afterPosition)`

Chèn một cột sau vị trí cột đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`afterPosition`	`Integer`	Cột mà bạn muốn thêm cột mới vào sau đó.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`insertColumnBefore(beforePosition)`

Chèn một cột trước vị trí cột đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`beforePosition`	`Integer`	Cột mà bạn muốn thêm cột mới vào trước đó.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`insertColumns(columnIndex)`

Chèn một cột trống vào trang tính ở vị trí được chỉ định.

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

Tham số

Tên	Loại	Mô tả
`columnIndex`	`Integer`	Chỉ mục cho biết vị trí chèn cột.

Ủ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

`insertColumns(columnIndex, numColumns)`

Chèn một hoặc nhiều cột trống liên tiếp vào một trang tính, bắt đầu từ vị trí được chỉ định.

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

Tham số

Tên	Loại	Mô tả
`columnIndex`	`Integer`	Chỉ mục cho biết vị trí chèn cột.
`numColumns`	`Integer`	Số cột cần chè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

`insertColumnsAfter(afterPosition, howMany)`

Chèn một số cột nhất định sau vị trí cột đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`afterPosition`	`Integer`	Cột mà bạn muốn thêm cột mới vào sau đó.
`howMany`	`Integer`	Số cột cần chèn.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`insertColumnsBefore(beforePosition, howMany)`

Chèn một số cột trước vị trí cột đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`beforePosition`	`Integer`	Cột mà bạn muốn thêm cột mới vào trước đó.
`howMany`	`Integer`	Số cột cần chèn.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`insertImage(blobSource, column, row)`

Chèn BlobSource dưới dạng hình ảnh vào tài liệu tại một hàng và cột nhất định. Kích thước hình ảnh được truy xuất từ nội dung blob. Kích thước blob tối đa được hỗ trợ là 2 MB.

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

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

Tham số

Tên	Loại	Mô tả
`blobSource`	`BlobSource`	Blob chứa nội dung hình ảnh, loại MIME và tên (không bắt buộc).
`column`	`Integer`	Vị trí cột.
`row`	`Integer`	Vị trí hàng.

Cầu thủ trả bóng

OverGridImage – Hình ảnh được chè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

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

Chèn BlobSource dưới dạng hình ảnh vào tài liệu tại một hàng và cột nhất định, với độ lệch pixel. Kích thước hình ảnh được truy xuất từ nội dung blob. Kích thước blob tối đa được hỗ trợ là 2 MB.

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

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

Tham số

Tên	Loại	Mô tả
`blobSource`	`BlobSource`	Blob chứa nội dung hình ảnh, loại MIME và tên (không bắt buộc).
`column`	`Integer`	Vị trí cột.
`row`	`Integer`	Vị trí hàng.
`offsetX`	`Integer`	Độ lệch ngang so với góc ô, tính bằng pixel.
`offsetY`	`Integer`	Độ lệch dọc so với góc ô, tính bằng pixel.

Cầu thủ trả bóng

OverGridImage – Hình ảnh được chè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

`insertImage(url, column, row)`

Chèn hình ảnh vào tài liệu tại một hàng và cột nhất định.

URL bạn cung cấp phải có thể truy cập công khai.

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

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

Tham số

Tên	Loại	Mô tả
`url`	`String`	URL của hình ảnh.
`column`	`Integer`	Vị trí cột lưới.
`row`	`Integer`	Vị trí hàng trong lưới.

Cầu thủ trả bóng

OverGridImage – Hình ảnh được chè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

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

Chèn hình ảnh vào tài liệu tại một hàng và cột nhất định, với độ lệch tính bằng pixel.

URL bạn cung cấp phải có thể truy cập công khai.

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

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

Tham số

Tên	Loại	Mô tả
`url`	`String`	URL của hình ảnh.
`column`	`Integer`	Vị trí cột.
`row`	`Integer`	Vị trí hàng.
`offsetX`	`Integer`	Độ lệch ngang so với góc ô, tính bằng pixel.
`offsetY`	`Integer`	Độ lệch dọc so với góc ô, tính bằng pixel.

Cầu thủ trả bóng

OverGridImage – Hình ảnh được chè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

`insertRowAfter(afterPosition)`

Chèn một hàng sau vị trí hàng đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`afterPosition`	`Integer`	Hàng mà bạn muốn thêm hàng mới vào sau đó.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`insertRowBefore(beforePosition)`

Chèn một hàng trước vị trí hàng đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`beforePosition`	`Integer`	Hàng mà bạn muốn thêm hàng mới vào trước đó.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`insertRows(rowIndex)`

Chèn một hàng trống vào trang tính ở vị trí được chỉ định.

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

Tham số

Tên	Loại	Mô tả
`rowIndex`	`Integer`	Chỉ mục cho biết vị trí cần chèn một hà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

`insertRows(rowIndex, numRows)`

Chèn một hoặc nhiều hàng trống liên tiếp vào một trang tính, bắt đầu từ vị trí được chỉ định.

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

Tham số

Tên	Loại	Mô tả
`rowIndex`	`Integer`	Chỉ mục cho biết vị trí cần chèn một hàng.
`numRows`	`Integer`	Số hàng cần chè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

`insertRowsAfter(afterPosition, howMany)`

Chèn một số hàng sau vị trí hàng đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`afterPosition`	`Integer`	Hàng mà sau đó các hàng mới sẽ được thêm vào.
`howMany`	`Integer`	Số hàng cần chèn.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`insertRowsBefore(beforePosition, howMany)`

Chèn một số hàng trước vị trí hàng đã cho.

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

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

Tham số

Tên	Loại	Mô tả
`beforePosition`	`Integer`	Hàng mà bạn muốn thêm các hàng mới vào trước đó.
`howMany`	`Integer`	Số hàng cần chèn.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`insertSlicer(range, anchorRowPos, anchorColPos)`

Thêm một bộ cắt mới vào trang tính 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

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

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

Tham số

Tên	Loại	Mô tả
`range`	`Range`	Phạm vi mà bộ cắt được tạo.
`anchorRowPos`	`Integer`	Phía trên của bộ chọn lát được cố định trong hàng này.
`anchorColPos`	`Integer`	Mặt trên của bộ lọc được cố định trong cột này.

Cầu thủ trả bóng

Slicer – Bộ cắt mới chè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

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

Thêm một bộ cắt mới vào trang tính 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

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

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

Tham số

Tên	Loại	Mô tả
`range`	`Range`	Phạm vi mà bộ cắt được tạo.
`anchorRowPos`	`Integer`	Phía trên của bộ chọn lát được cố định trong hàng này.
`anchorColPos`	`Integer`	Mặt trên của bộ lọc được cố định trong cột này.
`offsetX`	`Integer`	Độ lệch ngang so với góc ô, tính bằng pixel.
`offsetY`	`Integer`	Độ lệch dọc so với góc ô, tính bằng pixel.

Cầu thủ trả bóng

Slicer – Bộ cắt mới chè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

`isColumnHiddenByUser(columnPosition)`

Trả về việc người dùng có ẩn cột đã cho hay không.

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

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

Tham số

Tên	Loại	Mô tả
`columnPosition`	`Integer`	Vị trí của cột cần kiểm tra.

Cầu thủ trả bóng

Boolean – true nếu cột bị ẩn, 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

`isRightToLeft()`

Trả về true nếu bố cục trang tính này là từ phải sang trái. Trả về false nếu trang tính sử dụng bố cục mặc định từ trái sang phả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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

Cầu thủ trả bóng

Boolean – true nếu là từ phải sang trá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

`isRowHiddenByFilter(rowPosition)`

Trả về liệu hàng đã cho có bị ẩn bởi một bộ lọc (không phải chế độ xem bộ lọc) hay không.

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

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

Tham số

Tên	Loại	Mô tả
`rowPosition`	`Integer`	Vị trí của hàng cần kiểm tra.

Cầu thủ trả bóng

Boolean – true nếu hàng bị ẩn, 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

`isRowHiddenByUser(rowPosition)`

Trả về liệu người dùng có ẩn hàng đã cho hay không.

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

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

Tham số

Tên	Loại	Mô tả
`rowPosition`	`Integer`	Vị trí của hàng cần kiểm tra.

Cầu thủ trả bóng

Boolean – true nếu hàng bị ẩn, 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

`isSheetHidden()`

Trả về true nếu trang tính hiện đang bị ẩn.

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

Cầu thủ trả bóng

Boolean – true nếu trang tính bị ẩn, 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

`moveColumns(columnSpec, destinationIndex)`

Di chuyển các cột được chọn theo dải ô đã cho đến vị trí được biểu thị bằng destinationIndex. Bản thân columnSpec không nhất thiết phải đại diện chính xác cho toàn bộ cột hoặc nhóm cột để di chuyển – nó sẽ chọn tất cả các cột mà dải ô trải dài.

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

Tham số

Tên	Loại	Mô tả
`columnSpec`	`Range`	Một dải ô trải dài trên các cột cần di chuyển.
`destinationIndex`	`Integer`	Chỉ mục mà các cột sẽ được di chuyển đến. Xin lưu ý rằng chỉ mục này dựa trên toạ độ trước khi các cột được di chuyển. Dữ liệu hiện có được chuyển sang phải để nhường chỗ cho các cột được di chuyển trong khi các cột nguồn bị xoá khỏi lưới. Do đó, dữ liệu có thể kết thúc ở một chỉ mục khác với chỉ mục được chỉ định 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

`moveRows(rowSpec, destinationIndex)`

Di chuyển các hàng được chọn theo dải ô đã cho đến vị trí được chỉ định bằng destinationIndex. Bản thân rowSpec không nhất thiết phải đại diện chính xác cho toàn bộ hàng hoặc nhóm hàng để di chuyển – nó sẽ chọn tất cả các hàng mà dải ô bao gồm.

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

Tham số

Tên	Loại	Mô tả
`rowSpec`	`Range`	Một dải ô bao gồm các hàng cần di chuyển.
`destinationIndex`	`Integer`	Chỉ mục mà các hàng sẽ được di chuyển đến. Xin lưu ý rằng chỉ mục này dựa trên toạ độ trước khi các hàng được di chuyển. Dữ liệu hiện có sẽ được chuyển xuống để có chỗ cho các hàng được di chuyển, trong khi các hàng nguồn sẽ bị xoá khỏi lưới. Do đó, dữ liệu có thể kết thúc ở một chỉ mục khác với chỉ mục được chỉ định 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

`newChart()`

Trả về một trình tạo để tạo biểu đồ mới cho trang tính này.

Ví dụ này cho thấy cách tạo biểu đồ mới:

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

Cầu thủ trả bóng

EmbeddedChartBuilder – Công cụ tạo biểu đồ mới.

`protect()`

Tạo một đối tượng có thể bảo vệ trang tính khỏi bị chỉnh sửa, 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 trang tính (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à trang tính vẫn không được bảo vệ. Nếu trang tính đã được bảo vệ, phương thức này sẽ trả về một đối tượng đại diện cho các chế độ cài đặt bảo vệ hiện có của trang tính. Một trang tính được bảo vệ có thể bao gồm các vùng không được bảo vệ.

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

// Ensure the current user is an editor before removing others. Otherwise, if
// the user's edit permission comes from a group, the script throws an exception
// upon removing the group.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Cầu thủ trả bóng

Protection – Một đối tượng đại diện cho các 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

`removeChart(chart)`

Xoá biểu đồ khỏi trang tính mẹ.

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

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

Tham số

Tên	Loại	Mô tả
`chart`	`EmbeddedChart`	Biểu đồ cần 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

`setActiveRange(range)`

Đặt dải ô được chỉ định làm active range trong trang tính đang hoạt động, với ô trên cùng bên trái trong dải ô làm current cell.

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

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

Tham số

Tên	Loại	Mô tả
`range`	`Range`	Phạm vi cần đặt làm phạm vi đang hoạt động.

Cầu thủ trả bóng

Range – Phạm vi mới được kích hoạt.

Ủ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

`setActiveRangeList(rangeList)`

Đặt danh sách dải ô đã chỉ định làm active ranges trong trang tính đang hoạt động. Phạm vi cuối cùng trong danh sách được đặt làm active range.

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

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

Tham số

Tên	Loại	Mô tả
`rangeList`	`RangeList`	Danh sách các dải ô để chọn.

Cầu thủ trả bóng

RangeList – Danh sách dải ô mới được chọ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

`setActiveSelection(range)`

Đặt vùng chọn đang hoạt động cho trang tính này.

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

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

Tham số

Tên	Loại	Mô tả
`range`	`Range`	Phạm vi cần đặt làm vùng chọn đang hoạt động.

Cầu thủ trả bóng

Range – Phạm vi mới được kích hoạt.

Ủ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

`setActiveSelection(a1Notation)`

Đặt vùng chọn đang hoạt động, như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1.

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

sheet.setActiveSelection('A1:D4');

Tham số

Tên	Loại	Mô tả
`a1Notation`	`String`	Dải ô cần đặt làm dải ô đang hoạt động, như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1.

Cầu thủ trả bóng

Range – Phạm vi mới được kích hoạt.

Ủ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

`setColumnGroupControlPosition(position)`

Đặt vị trí của nút bật/tắt điều khiển nhóm cột trên trang tính.

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

Tham số

Tên	Loại	Mô tả
`position`	`GroupControlTogglePosition`	Vị trí của nút bật/tắt điều khiển nhóm cột.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`setColumnWidth(columnPosition, width)`

Đặt chiều rộng của cột đã cho theo pixel.

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

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

Tham số

Tên	Loại	Mô tả
`columnPosition`	`Integer`	Vị trí của cột đã cho cần đặt.
`width`	`Integer`	Chiều rộng tính bằng pixel để đặt.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`setColumnWidths(startColumn, numColumns, width)`

Đặt chiều rộng của các cột đã cho theo pixel.

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

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

Tham số

Tên	Loại	Mô tả
`startColumn`	`Integer`	Vị trí cột bắt đầu cần thay đổi.
`numColumns`	`Integer`	Số cột cần thay đổi.
`width`	`Integer`	Chiều rộng tính bằng pixel để đặt.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`setConditionalFormatRules(rules)`

Thay thế tất cả các quy tắc định dạng có điều kiện hiện có trong trang tính bằng các quy tắc đầu vào. Các quy tắc được đánh giá theo thứ tự nhập.

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

Tham số

Tên	Loại	Mô tả
`rules`	`ConditionalFormatRule[]`	Các quy tắc định dạng có điều kiện 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

`setCurrentCell(cell)`

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

Nếu ô được chỉ định nằm trong một dải ô đã chọn, 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 ô nào đã chọn, thì mọi 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, thao tác này sẽ tạo ra một ngoại lệ.

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

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

Tham số

Tên	Loại	Mô tả
`cell`	`Range`	Ô cần đặt làm ô hiện tại.

Cầu thủ trả bóng

Range – Ô hiện tại mới được đặt.

Ủ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

`setFrozenColumns(columns)`

Cố định số lượng cột đã cho. Nếu là 0, thì không có cột nào được cố định.

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

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

Tham số

Tên	Loại	Mô tả
`columns`	`Integer`	Số cột cần cố đị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

`setFrozenRows(rows)`

Cố định số hàng đã cho. Nếu là 0, thì không có hàng nào bị cố định.

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

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

Tham số

Tên	Loại	Mô tả
`rows`	`Integer`	Số hàng cần cố đị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

`setHiddenGridlines(hideGridlines)`

Ẩn hoặc hiện đường lưới của trang tính.

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

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

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

Tham số

Tên	Loại	Mô tả
`hideGridlines`	`Boolean`	Nếu `true`, hãy ẩn đường lưới trong trang tính này; nếu không, hãy hiện đường lưới.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`setName(name)`

Đặt tên cho trang tính.

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

Tham số

Tên	Loại	Mô tả
`name`	`String`	Tên mới của trang tính.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`setRightToLeft(rightToLeft)`

Đặt hoặc huỷ đặt bố cục trang tính từ phải sang trá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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

Tham số

Tên	Loại	Mô tả
`rightToLeft`	`Boolean`	Nếu `true`, bố cục trang tính được đặt thành từ phải sang trái, với ô A1 ở góc trên cùng bên phải. Nếu là `false`, bố cục trang tính sẽ được đặt thành từ trái sang phải theo mặc định, với ô A1 ở trên cùng bên trái.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`setRowGroupControlPosition(position)`

Đặt vị trí của nút bật/tắt điều khiển nhóm hàng trên trang tính.

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

Tham số

Tên	Loại	Mô tả
`position`	`GroupControlTogglePosition`	Vị trí của nút bật/tắt điều khiển nhóm hàng.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`setRowHeight(rowPosition, height)`

Đặt chiều cao hàng của hàng đã cho theo pixel. Theo mặc định, các hàng sẽ tăng kích thước để vừa với nội dung ô. Nếu bạn muốn buộc các hàng có chiều cao cụ thể, hãy sử dụng setRowHeightsForced(startRow, numRows, height).

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

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

Tham số

Tên	Loại	Mô tả
`rowPosition`	`Integer`	Vị trí hàng cần thay đổi.
`height`	`Integer`	Chiều cao tính bằng pixel để đặt.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`setRowHeights(startRow, numRows, height)`

Đặt chiều cao của các hàng đã cho theo pixel. Theo mặc định, các hàng sẽ tăng kích thước để vừa với nội dung ô. Nếu bạn muốn buộc các hàng có chiều cao cụ thể, hãy sử dụng setRowHeightsForced(startRow, numRows, height).

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

// Sets the first three rows to a height of 20 pixels
sheet.setRowHeights(1, 3, 20);

Tham số

Tên	Loại	Mô tả
`startRow`	`Integer`	Vị trí hàng bắt đầu cần thay đổi.
`numRows`	`Integer`	Số hàng cần thay đổi.
`height`	`Integer`	Chiều cao tính bằng pixel để đặt.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`setRowHeightsForced(startRow, numRows, height)`

Đặt chiều cao của các hàng đã cho theo pixel. Theo mặc định, các hàng sẽ tăng kích thước để vừa với nội dung ô. Khi bạn sử dụng setRowHeightsForced, các hàng sẽ buộc phải có chiều cao được chỉ định, ngay cả khi nội dung ô cao hơn chiều cao hàng.

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

// Sets the first three rows to a height of 5 pixels.
sheet.setRowHeightsForced(1, 3, 5);

Tham số

Tên	Loại	Mô tả
`startRow`	`Integer`	Vị trí hàng bắt đầu cần thay đổi.
`numRows`	`Integer`	Số hàng cần thay đổi.
`height`	`Integer`	Chiều cao tính bằng pixel để đặt.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`setTabColor(color)`

Đặt màu thẻ trang tính.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.setTabColor('ff0000');  // Set the color to red.
first.setTabColor(null);      // Unset the color.

Tham 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'`) hoặc `null` để đặt lại màu thẻ.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`setTabColorObject(color)`

Đặt màu thẻ trang tính.

// This example assumes there is a sheet named "Sheet1"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('Sheet1');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                  .build();
first.setTabColorObject(color);  // Set the color to theme accent 1.
first.setTabColorObject(null);   // Unset the color.

Tham số

Tên	Loại	Mô tả
`color`	`Color`	Màu thẻ trang tính cần đặt.

Cầu thủ trả bóng

Sheet – Trang tính này, để liên kết.

Ủ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

`showColumns(columnIndex)`

Hiện cột tại chỉ mục đã cho.

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

Tham số

Tên	Loại	Mô tả
`columnIndex`	`Integer`	Chỉ mục của cột cần hiệ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

`showColumns(columnIndex, numColumns)`

Hiện một hoặc nhiều cột liên tiếp bắt đầu từ chỉ mục đã cho.

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

Tham số

Tên	Loại	Mô tả
`columnIndex`	`Integer`	Chỉ mục bắt đầu của các cột cần bỏ ẩn.
`numColumns`	`Integer`	Số cột cần hiệ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

`showRows(rowIndex)`

Hiện hàng tại chỉ mục đã cho.

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

Tham số

Tên	Loại	Mô tả
`rowIndex`	`Integer`	Chỉ mục của hàng cần hiệ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

`showRows(rowIndex, numRows)`

Hiện một hoặc nhiều hàng liên tiếp bắt đầu từ chỉ mục đã cho.

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

Tham số

Tên	Loại	Mô tả
`rowIndex`	`Integer`	Chỉ mục bắt đầu của các hàng cần hiện.
`numRows`	`Integer`	Số hàng cần hiệ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

`showSheet()`

Hiển thị trang tính. Không có tác dụng nếu trang tính đã hiển thị.

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

Cầu thủ trả bóng

Sheet – Trang tính hiện tạ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

`sort(columnPosition)`

Sắp xếp trang tính theo cột, theo thứ tự tăng dần.

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

// Sorts the sheet by the first column, ascending
sheet.sort(1);

Tham số

Tên	Loại	Mô tả
`columnPosition`	`Integer`	Cột để sắp xếp.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`sort(columnPosition, ascending)`

Sắp xếp trang tính theo cột. Nhận một tham số để chỉ định thứ tự tăng dần hoặc giảm dần.

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

// Sorts the sheet by the first column, descending
sheet.sort(1, false);

Tham số

Tên	Loại	Mô tả
`columnPosition`	`Integer`	Cột để sắp xếp.
`ascending`	`Boolean`	`true` để sắp xếp theo thứ tự tăng dần, `false` để sắp xếp theo thứ tự giảm dần.

Cầu thủ trả bóng

Sheet – Trang này hữu ích cho việc liên kết phươ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

`unhideColumn(column)`

Hiện cột trong dải ô đã cho.

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

// This unhides the first column if it was previously hidden
const range = sheet.getRange('A1');
sheet.unhideColumn(range);

Tham số

Tên	Loại	Mô tả
`column`	`Range`	Dải ô cần hiện, nếu 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

`unhideRow(row)`

Hiện hàng trong dải ô đã cho.

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

// This unhides the first row if it was previously hidden
const range = sheet.getRange('A1');
sheet.unhideRow(range);

Tham số

Tên	Loại	Mô tả
`row`	`Range`	Dải ô cần hiện, nếu 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

`updateChart(chart)`

Cập nhật biểu đồ trên trang tính này.

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

// This code is going to loop through all the charts and change them to
// column charts
const charts = sheet.getCharts();
for (const i in charts) {
  const chart = charts[i];
  const newChart = chart.modify().setChartType(Charts.ChartType.COLUMN).build();
  sheet.updateChart(newChart);
}

Tham số

Tên	Loại	Mô tả
`chart`	`EmbeddedChart`	Biểu đồ cần cập nhật.

Ủ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

`getSheetProtection()`

Không dùng nữa. Đối với bảng tính được tạo trong phiên bản Google Trang tính mới hơn, hãy sử dụng getProtections(type). Hàm này sẽ trả về lớp Protection mạnh mẽ hơn. Mặc dù phương thức này không được dùng nữa, nhưng vẫn có sẵn để tương thích với phiên bản cũ của Trang tính

Trả về một thực thể PageProtection mô tả các quyền đối với trang tính hiện tại.

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

const permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser('user@example.com');

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
const users = permissions.getUsers();
Logger.log(users);

Cầu thủ trả bóng

PageProtection – Một đối tượng mô tả quyền truy cập vào trang 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

`getTabColor()`

Không dùng nữa. Được thay thế bằng getTabColorObject()

Lấy màu thẻ trang tính hoặc null nếu thẻ trang tính không có màu.

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

Cầu thủ trả bóng

String|null – Mã màu theo ký hiệu CSS (chẳng hạn như '#ffffff').

Ủ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

`setSheetProtection(permissions)`

Không dùng nữa. Đối với bảng tính được tạo trong phiên bản Google Trang tính mới hơn, hãy sử dụng protect(). Hàm này sẽ trả về lớp Protection mạnh mẽ hơn. Mặc dù phương thức này không được dùng nữa, nhưng vẫn có sẵn để tương thích với phiên bản cũ của Trang tính

Đặt quyền cho trang tính hiện tại.

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

const permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
const sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

Tham số

Tên	Loại	Mô tả
`permissions`	`PageProtection`	Đối tượng quyền truy cập cần đặt trên trang tính 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

Class Sheet 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

addDeveloperMetadata(key)

Tham số

Cầu thủ trả bóng

Ủy quyền

addDeveloperMetadata(key, visibility)

Tham số

Cầu thủ trả bóng

Ủy quyền

addDeveloperMetadata(key, value)

Tham số

Cầu thủ trả bóng

Ủy quyền

addDeveloperMetadata(key, value, visibility)

Tham số

Cầu thủ trả bóng

Ủy quyền

appendRow(rowContents)

Tham số

Cầu thủ trả bóng

Ủy quyền

asDataSourceSheet()

Cầu thủ trả bóng

Ủy quyền

autoResizeColumn(columnPosition)

Tham số

Cầu thủ trả bóng

Ủy quyền

autoResizeColumns(startColumn, numColumns)

Tham số

Cầu thủ trả bóng

Ủy quyền

autoResizeRows(startRow, numRows)

Tham số

Cầu thủ trả bóng

Ủy quyền

clear()

Cầu thủ trả bóng

Ủy quyền

clear(options)

Tham số

Thông số nâng cao

Cầu thủ trả bóng

Ủy quyền

clearConditionalFormatRules()

Ủy quyền

clearContents()

Cầu thủ trả bóng

Ủy quyền

clearFormats()

Cầu thủ trả bóng

Ủy quyền

clearNotes()

Cầu thủ trả bóng

Ủy quyền

collapseAllColumnGroups()

Cầu thủ trả bóng

Ủy quyền

collapseAllRowGroups()

Cầu thủ trả bóng

Ủy quyền

copyTo(spreadsheet)

Tham số

Cầu thủ trả bóng

Ủy quyền

createDeveloperMetadataFinder()

Cầu thủ trả bóng

createTextFinder(findText)

Tham số

Cầu thủ trả bóng

deleteColumn(columnPosition)

Tham số

Cầu thủ trả bóng

Ủy quyền

deleteColumns(columnPosition, howMany)

Class Sheet

`activate()`

`addDeveloperMetadata(key)`

`addDeveloperMetadata(key, visibility)`

`addDeveloperMetadata(key, value)`

`addDeveloperMetadata(key, value, visibility)`

`appendRow(rowContents)`

`asDataSourceSheet()`

`autoResizeColumn(columnPosition)`

`autoResizeColumns(startColumn, numColumns)`

`autoResizeRows(startRow, numRows)`

`clear()`

`clear(options)`

`clearConditionalFormatRules()`

`clearContents()`

`clearFormats()`

`clearNotes()`

`collapseAllColumnGroups()`

`collapseAllRowGroups()`

`copyTo(spreadsheet)`

`createDeveloperMetadataFinder()`

`createTextFinder(findText)`

`deleteColumn(columnPosition)`

`deleteColumns(columnPosition, howMany)`

`deleteRow(rowPosition)`

`deleteRows(rowPosition, howMany)`

`expandAllColumnGroups()`

`expandAllRowGroups()`

`expandColumnGroupsUpToDepth(groupDepth)`

`expandRowGroupsUpToDepth(groupDepth)`

`getActiveCell()`

`getActiveRange()`

`getActiveRangeList()`

`getBandings()`

`getCharts()`

`getColumnGroup(columnIndex, groupDepth)`

`getColumnGroupControlPosition()`

`getColumnGroupDepth(columnIndex)`

`getColumnWidth(columnPosition)`

`getConditionalFormatRules()`

`getCurrentCell()`

`getDataRange()`

`getDataSourceFormulas()`

`getDataSourcePivotTables()`