Truy cập và sửa đổi các trang tính trong bảng tính. Các thao tác phổ biến là đổi tên một trang tính và truy cập vào các đối tượng dải ô từ 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 bằng 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 bằng khoá đã chỉ định và chế độ hiển thị vào trang tính. |
addDeveloperMetadata(key, value) | Sheet | Thêm siêu dữ liệu nhà phát triển bằng 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 bằng khoá, giá trị và chế độ hiển thị đã chỉ định cho 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 | Trả về trang tính dưới dạng DataSourceSheet nếu trang tính thuộc loại SheetType.DATASOURCE hoặc null nếu không. |
autoResizeColumn(columnPosition) | Sheet | Đặt chiều rộng của cột đã cho cho vừa 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 cột. |
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 nhất định để vừa với nội dung của các hàng đó. |
clear() | Sheet | Xoá trang tính có nội dung và thông tin định dạng. |
clear(options) | Sheet | Xoá trang tính mục lục và/hoặc định dạng, như được chỉ định với các tuỳ 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á trang tính mục lục, trong khi vẫn giữ lại thông tin định dạng. |
clearFormats() | Sheet | Xoá trang tính định dạng mà vẫn giữ lại nội dung. |
clearNotes() | Sheet | Xoá trang tính chứa tất cả ghi chú. |
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, có thể là bảng tính giống với nguồn. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Trả về 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 trình tìm văn bản cho trang tính. Trình tìm kiếm này có thể tìm và thay thế văn bản trong trang tính. |
deleteColumn(columnPosition) | Sheet | Xoá cột tại 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 đến chiều sâu nhất định 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 ô nào đang hoạt động. |
getActiveRangeList() | RangeList | 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ả dải trong trang tính này. |
getCharts() | EmbeddedChart[] | Trả về một mảng các biểu đồ trên trang tính này. |
getColumnGroup(columnIndex, groupDepth) | Group | Trả về nhóm cột theo chỉ mục và chiều sâu nhóm cho trước. |
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ề chiều 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[] | Nhận tất cả quy tắc định dạng có điều kiện trong trang tính này. |
getCurrentCell() | Range | 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ề 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 về nguồn dữ liệu. |
getDataSourceTables() | DataSourceTable[] | Lấy tất cả bảng nguồn dữ liệu. |
getDeveloperMetadata() | DeveloperMetadata[] | Xem tất cả siêu dữ liệu dành cho 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 | Trả về bộ lọc trong trang tính này hoặc null nếu không có bộ lọc. |
getFormUrl() | String | Trả về URL cho biểu mẫu gửi phản hồi đến trang tính này hoặc null nếu trang tính này không có biểu mẫu nào liên kết. |
getFrozenColumns() | Integer | Trả về số lượng cột được cố định. |
getFrozenRows() | Integer | Trả về số lượng hàng được cố định. |
getImages() | OverGridImage[] | Trả về tất cả hình ảnh trong lưới trên trang tính. |
getIndex() | Integer | Lấy vị trí của trang tính trong bảng tính mẹ của trang tính đó. |
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ố cột hiện tại trong trang tính, bất kể nội dung. |
getMaxRows() | Integer | Trả về số 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ả dải ô được đặt 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 phần tử đại diện cho biện pháp 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à với số lượng 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ố 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ề bộ sưu tập RangeList đại diện cho các dải ô trong cùng một trang tính được chỉ định bởi một danh sách không trống các ký hiệu A1 hoặc ký hiệu R1C1. |
getRowGroup(rowIndex, groupDepth) | Group | Trả về nhóm hàng tại chỉ mục và chiều sâu nhóm cho trước. |
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ề chiều 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 một hàng nhất định. |
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 biểu thị. |
getSheetName() | String | Trả về tên trang tính. |
getSheetValues(startRow, startColumn, numRows, numColumns) | Object[][] | Trả về lưới hình chữ nhật của các giá trị cho dải ô này bắt đầu từ toạ độ đã cho. |
getSlicers() | Slicer[] | Trả về một mảng các bộ cắt trên trang tính. |
getTabColorObject() | Color | 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 các đường lưới của trang tính bị ẩn; nếu không sẽ trả về false . |
hideColumn(column) | void | Ẩn cột hoặc các cột trong dải ô cho trước. |
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 trước. |
hideRows(rowIndex) | void | Ẩn hàng tại 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 trong 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 trong trang tính bắt đầu tại vị trí được chỉ định. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Chèn một số cột đã cho 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 trong tài liệu ở 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 trong tài liệu ở một hàng và cột nhất định, với độ lệch pixel. |
insertImage(url, column, row) | OverGridImage | Chèn ảnh vào tài liệu ở một hàng và cột nhất định. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Chèn hình ảnh trong tài liệu ở một hàng và cột nhất định, với độ lệch 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 trong trang tính tại 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 trong một trang tính bắt đầu tại 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ố dò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 cột đã cho có bị người dùng ẩn 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ề xem liệu hàng đã cho có bị bộ lọc ẩn đi hay không (không phải chế độ xem bộ lọc). |
isRowHiddenByUser(rowPosition) | Boolean | Trả về việc liệu hàng đã cho có bị người dùng ẩn hay không. |
isSheetHidden() | Boolean | Trả về true nếu trang tính đang bị ẩn. |
moveColumns(columnSpec, destinationIndex) | void | Di chuyển các cột được chọn trong dải ô cho trước đến vị trí do destinationIndex biểu thị. |
moveRows(rowSpec, destinationIndex) | void | Di chuyển các hàng được chọn trong dải ô đã cho đến vị trí do destinationIndex biểu thị. |
newChart() | EmbeddedChartBuilder | Trả về 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, ngoại trừ những người dùng có quyền. |
removeChart(chart) | void | Xoá một 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à current cell . |
setActiveRangeList(rangeList) | RangeList | Thiết lập danh sách dải ô được chỉ định dưới dạng active ranges trong trang tính đang hoạt động. |
setActiveSelection(range) | Range | Đặt vùng lựa chọn đang hoạt động cho trang tính này. |
setActiveSelection(a1Notation) | Range | Đặt lựa chọn đang hoạt động, như chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1. |
setColumnGroupControlPosition(position) | Sheet | Đặt vị trí của nú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 tính bằng pixel. |
setColumnWidths(startColumn, numColumns, width) | Sheet | Đặt chiều rộng của các cột đã cho tính bằng pixel. |
setConditionalFormatRules(rules) | void | Thay thế tất cả quy tắc định dạng có điều kiện hiện có trong trang tính bằng quy tắc nhập dữ liệu. |
setCurrentCell(cell) | Range | Đặt ô được chỉ định làm current cell . |
setFrozenColumns(columns) | void | Cố định số cột đã cho. |
setFrozenRows(rows) | void | Cố định số hàng đã cho. |
setHiddenGridlines(hideGridlines) | Sheet | Ẩn hoặc hiển thị đường lưới của trang tính. |
setName(name) | Sheet | Đặt tên 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 điều khiển nhóm hàng trên trang tính. |
setRowHeight(rowPosition, height) | Sheet | Đặt chiều cao của hàng đã cho tính bằng pixel. |
setRowHeights(startRow, numRows, height) | Sheet | Đặt chiều cao của hàng đã cho tính bằng pixel. |
setRowHeightsForced(startRow, numRows, height) | Sheet | Đặt chiều cao của hàng đã cho tính bằng pixel. |
setTabColor(color) | Sheet | Đặt màu cho thẻ trang tính. |
setTabColorObject(color) | Sheet | Đặt màu cho 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ại 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, 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. |
Tài liệu chi tiết
activate()
Kích hoạt trang tính này. Không làm thay đổi trang tính mà chỉ thay đổi phiên bản mẹ về trang tính đang hoạt động.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.activate();
Cầu thủ trả bóng
Sheet
– Trang tính mới hoạt động.
addDeveloperMetadata(key)
Thêm siêu dữ liệu nhà phát triển bằng 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 | Nội dung mô tả |
---|---|---|
key | String | Chìa khoá cho siêu dữ liệu mới dành cho nhà phát triển. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Thêm siêu dữ liệu nhà phát triển bằng khoá đã chỉ định và chế độ hiển thị 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 | Nội dung mô tả |
---|---|---|
key | String | Chìa khoá cho siêu dữ liệu mới dành cho nhà phát triển. |
visibility | DeveloperMetadataVisibility | Chế độ hiển thị siêu dữ liệu mới dành cho nhà phát triển. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Thêm siêu dữ liệu nhà phát triển bằng 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 | Nội dung mô tả |
---|---|---|
key | String | Chìa khoá cho siêu dữ liệu mới dành cho nhà phát triển. |
value | String | Giá trị cho siêu dữ liệu mới dành cho nhà phát triển. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Thêm siêu dữ liệu nhà phát triển bằng khoá, giá trị và chế độ hiển thị đã chỉ định cho 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 | Nội dung mô tả |
---|---|---|
key | String | Chìa khoá cho siêu dữ liệu mới dành cho nhà phát triển. |
value | String | Giá trị cho siêu dữ liệu mới dành cho nhà phát triển. |
visibility | DeveloperMetadataVisibility | Chế độ hiển thị siêu dữ liệu mới dành cho nhà phát triển. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 đó được hiểu là một công thức.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 | Nội dung 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 tính hữu ích cho việc tạo chuỗi phương thức.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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
nếu không.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets 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
– Một trang tính nguồn dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Đặt chiều rộng của cột đã cho cho vừa với nội dung của cột đó.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 | Nội dung mô tả |
---|---|---|
columnPosition | Integer | Vị trí của cột đã cho cần đổi kích thước. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 cột.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 | Nội dung mô tả |
---|---|---|
startColumn | Integer | Cột bắt đầu để tự động đổi kích thước. |
numColumns | Integer | Số cột cần tự động đổi kích thước. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeRows(startRow, numRows)
Đặt chiều cao của tất cả các hàng bắt đầu từ vị trí hàng nhất định để vừa với nội dung của các hàng đó.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 | Nội dung 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 để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Xoá trang tính có nội dung và thông tin định dạng.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clear();
Cầu thủ trả bóng
Sheet
– Trang tính đã bị xoá.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Xoá trang tính mục lục và/hoặc định dạng, như được chỉ định với các tuỳ chọn nâng cao đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.clear({ formatOnly: true, contentsOnly: true });
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
options | Object | Bản đồ JavaScript chứa các tuỳ chọn nâng cao, được liệt kê bên dưới. |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
contentsOnly | Boolean | Liệu có xoá nội dung hay không. |
formatOnly | Boolean | Liệu có xoá định dạng hay không. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.clearConditionalFormatRules();
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContents()
Xoá trang tính mục lục, trong khi vẫn giữ lại thông tin định dạng.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearContents();
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormats()
Xoá trang tính định dạng mà vẫn giữ lại nội dung.
Định dạng là cách định dạng dữ liệu được các lựa chọn trong trình đơn "Định dạng" cho phép (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" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearFormats();
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNotes()
Xoá trang tính chứa tất cả ghi chú.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearNotes();
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllColumnGroups()
Thu gọn tất cả các nhóm cột trên trang tính.
var 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 để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllRowGroups()
Thu gọn tất cả các nhóm hàng trên trang tính.
var 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 để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(spreadsheet)
Sao chép trang tính vào một bảng tính nhất định, 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]".
var source = SpreadsheetApp.getActiveSpreadsheet(); var sheet = source.getSheets()[0]; var destination = SpreadsheetApp.openById('ID_GOES HERE'); sheet.copyTo(destination);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
spreadsheet | Spreadsheet | Bảng tính cần sao chép trang tính này vào. Bảng tính này có thể giống bảng tính với nguồn. |
Cầu thủ trả bóng
Sheet
– Trang tính mới để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Trả về 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 siêu dữ liệ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
– Trình tìm siêu dữ liệu dành cho nhà phát triển để tìm siêu dữ liệu trong phạm vi của trang tính này.
createTextFinder(findText)
Tạo trình tìm văn bản cho trang tính. Trình tìm kiếm này có thể tìm và thay thế văn bản trong trang tính.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Creates a text finder. var textFinder = sheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the sheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
findText | String | Văn bản cần tìm kiếm. |
Cầu thủ trả bóng
TextFinder
– TextFinder
cho trang tính.
deleteColumn(columnPosition)
Xoá cột tại vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Tham số
Tên | Loại | Nội dung 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 tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Xoá một số cột bắt đầu từ vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
Xoá hàng ở vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Tham số
Tên | Loại | Nội dung 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 tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Xoá một số hàng bắt đầu từ vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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.
var 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 để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 1 nhóm hàng.
var 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 để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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.
var 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 | Nội dung mô tả |
---|---|---|
groupDepth | Integer | Chiều sâu của nhóm mà bạn muốn mở rộng các nhóm cột. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandRowGroupsUpToDepth(groupDepth)
Mở rộng tất cả các nhóm hàng đến chiều sâu nhất định và thu gọn tất cả các nhóm hàng khác.
var 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 | Nội dung mô tả |
---|---|---|
groupDepth | Integer | Chiều sâu của nhóm mà bạn muốn mở rộng các nhóm hàng. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Cầu thủ trả bóng
Range
— ô hiện đang hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 ô nào đang hoạt động. Nếu bạn chọn nhiều dải ô, phương thức này chỉ trả về dải ô được chọn gần đây nhất.
Thuật ngữ "dải ô đang hoạt động" dùng để chỉ dải ô mà người dùng đã chọn trong trang tính đang hoạt động, nhưng trong hàm tuỳ chỉnh, thuật ngữ này đề cập đến ô đang được chủ động tính toán lại.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Cầu thủ trả bóng
Range
– dải ô hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Xem thêm
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 ô, lệnh này sẽ hoạt động như một lệnh gọi getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Cầu thủ trả bóng
RangeList
– danh sách dải ô đang hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Xem thêm
getBandings()
Trả về tất cả dải 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 trong trang tính này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCharts()
Trả về một mảng các biểu đồ trên trang tính này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; // Do something with the chart }
Cầu thủ trả bóng
EmbeddedChart[]
– Một mảng biểu đồ.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
Trả về nhóm cột theo chỉ mục và chiều sâu nhóm cho trước.
var 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. var columnGroup = sheet.getColumnGroup(2, 1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnIndex | Integer | Chỉ mục cột của nút bật/tắt chế độ điều khiển nhóm hoặc chỉ mục trong nhóm. |
groupDepth | Integer | Chiều sâu của nhóm. |
Cầu thủ trả bóng
Group
– Nhóm cột tại chỉ mục và chiều sâu của nhóm đối chứng hoặc trả về trường hợp ngoại lệ nếu nhóm không tồn tại.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupControlPosition()
Trả về GroupControlTogglePosition
cho tất cả các nhóm cột trên trang tính.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the // group. var columnGroupControlPosition = sheet.getColumnGroupControlPosition();
Cầu thủ trả bóng
GroupControlTogglePosition
– true
nếu nút bật/tắt chế độ điều khiển việc nhóm cột hiển thị sau nhóm trên trang tính này và nếu không thì false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupDepth(columnIndex)
Trả về chiều sâu nhóm của cột tại chỉ mục đã cho.
Chiều sâu nhóm cho biết có bao nhiêu nhóm chồng chéo với cột. Giá trị này có thể nằm trong khoảng từ 0 đến 8.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over columns 1 through 3 var groupDepth = sheet.getColumnGroupDepth(1);
Tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnWidth(columnPosition)
Lấy chiều rộng tính bằng pixel của cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getConditionalFormatRules()
Nhận tất 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. var rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules(); for (var i = 0; i < rules.length; i++) { var 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 Google Trang tính và được làm nổi bật bằng đường viền tối. Không bao giờ có nhiều ô hiện tại. Khi người dùng chọn một hoặc nhiều dải ô, một trong các ô được chọn sẽ là ô hiện tại.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Cầu thủ trả bóng
Range
– ô hiện tại
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
Trả về 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 Phạm vi được giới hạn bởi A1 và (Sheet.getLastColumn(), Sheet.getLastRow()).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
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(); // Logs the first data source formula in the array. console.log(dataSourceFormulas[0].getFormula());
Cầu thủ trả bóng
DataSourceFormula[]
– Danh sách các công thức của nguồn dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Lấy tất cả bảng tổng hợp về 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 bảng tổng hợp về nguồn dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Lấy tất cả bảng nguồn dữ liệu.
// 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Xem tất cả siêu dữ liệu dành cho 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 liên kết với trang tính này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Trả về bộ lọc trong trang tính này hoặc null
nếu không có bộ lọc.
// Gets the filter on the active sheet. let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter();
Cầu thủ trả bóng
Filter
– Bộ lọc.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
Trả về URL cho biểu mẫu gửi phản hồi đến trang tính này hoặc null
nếu trang tính này không có biểu mẫu nào liên kết.
var sheet = SpreadsheetApp.getActiveSheet(); var url = sheet.getFormUrl();
Cầu thủ trả bóng
String
– URL cho biểu mẫu đặt câu trả lời trong trang tính này hoặc null
nếu trang tính này không có biểu mẫu liên kết.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
Trả về số lượng cột được cố định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
Trả về số lượng hàng được cố định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Cầu thủ trả bóng
Integer
– số lượng hàng được cố định
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getImages()
Trả về tất cả hình ảnh trong 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 loạt các hình ảnh qua lưới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIndex()
Lấy vị trí của trang tính trong bảng tính mẹ của trang tính đó. Bắt đầu lúc 1 giờ.
var ss = SpreadsheetApp.getActiveSpreadsheet(); // Note that the JavaScript index is 0, but this logs 1 var 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 tính trong bảng tính mẹ.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Trả về vị trí của cột cuối cùng có nội dung.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var 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 chứa nội dung
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Trả về vị trí của hàng cuối cùng có nội dung.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var 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 chứa nội dung
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxColumns()
Trả về số 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" var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxRows()
Trả về số 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" var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
Trả về tên của trang tính.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
Lấy tất cả dải ô được đặt tên trong trang tính này.
// The code below logs the name of the first named range. var 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ả dải ô được đặt tên trong trang tính.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getParent()
Trả về Spreadsheet
chứa trang tính này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // parent is identical to ss var parent = sheet.getParent();
Cầu thủ trả bóng
Spreadsheet
— Bảng tính mẹ.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 phần tử đại diện cho biện pháp bảo vệ trên chính trang tính đó.
// Remove all range protections in the spreadsheet that the user has permission to edit. var sheet = SpreadsheetApp.getActiveSheet(); var protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove sheet protection from the active sheet, if the user has permission to edit it. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0]; if (protection && protection.canEdit()) { protection.remove(); }
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
type | ProtectionType | Loại khu vực được bảo vệ, 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ả dải ô được bảo vệ trong trang tính hoặc một mảng một phần tử đại diện cho biện pháp bảo vệ trên chính trang tính đó.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column)
Trả về dải ô có ô trên cùng bên trái tại toạ độ đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Passing only two arguments returns a "range" with a single cell. var range = sheet.getRange(1, 1); var values = range.getValues(); Logger.log(values[0][0]);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
row | Integer | Chỉ mục hàng của ô cần trả về; việc lập chỉ mục hàng bắt đầu bằng 1. |
column | Integer | Chỉ mục cột của ô cần trả về; việc lập chỉ mục cột bắt đầu bằng 1. |
Cầu thủ trả bóng
Range
– Một dải ô chỉ chứa ô này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows)
Trả về dải ô có ô trên cùng bên trái tại toạ độ đã cho và với số lượng hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // When the "numRows" argument is used, only a single column of data is returned. var range = sheet.getRange(1, 1, 3); var values = range.getValues(); // Prints 3 values from the first column, starting from row 1. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
row | Integer | Chỉ mục hàng bắt đầu của dải ô; việc lập chỉ mục hàng bắt đầu bằng 1. |
column | Integer | Chỉ mục cột của dải ô; việc lập chỉ mục cột bắt đầu bằng 1. |
numRows | Integer | Số hàng cần trả về. |
Cầu thủ trả bóng
Range
– Dải ô chứa một cột dữ liệu duy nhất có số hàng được chỉ định.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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ố hàng và cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 3, 3); var values = range.getValues(); // Print values from a 3x3 box. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
row | Integer | Chỉ mục hàng bắt đầu của dải ô; việc lập chỉ mục hàng bắt đầu bằng 1. |
column | Integer | Chỉ mục cột bắt đầu của dải ô; việc lập chỉ mục cột bắt đầu bằng 1. |
numRows | Integer | Số hàng cần trả về. |
numColumns | Integer | Số cột cần trả về. |
Cầu thủ trả bóng
Range
– Một dải ô tương ứng với vùng được chỉ định.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
a1Notation | String | Dải ô cần trả về, như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1. |
Cầu thủ trả bóng
Range
— dải ô tại vị trí được chỉ định
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeList(a1Notations)
Trả về bộ sưu tập RangeList
đại diện cho các dải ô trong cùng một trang tính được chỉ định bởi một danh sách không trống các ký hiệu A1 hoặc ký hiệu R1C1.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
a1Notations | String[] | Danh sách dải ô cần trả về, như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1. |
Cầu thủ trả bóng
RangeList
— danh sách dải ô tại vị trí được chỉ định
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroup(rowIndex, groupDepth)
Trả về nhóm hàng tại chỉ mục và chiều sâu nhóm cho trước.
var 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. var rowGroup = sheet.getRowGroup(2, 1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rowIndex | Integer | Chỉ mục hàng của nút bật/tắt chế độ điều khiển nhóm hoặc chỉ mục trong nhóm. |
groupDepth | Integer | Chiều sâu của nhóm. |
Cầu thủ trả bóng
Group
– Nhóm hàng ở chỉ mục và chiều sâu của nhóm đối chứng hoặc trả về trường hợp ngoại lệ nếu nhóm không tồn tại.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupControlPosition()
Trả về GroupControlTogglePosition
cho tất cả các nhóm hàng trên trang tính.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the row grouping control toggle is shown after the // group. var rowGroupControlPosition = sheet.getRowGroupControlPosition();
Cầu thủ trả bóng
GroupControlTogglePosition
– true
nếu nút bật/tắt chế độ điều khiển việc nhóm hàng hiển thị sau nhóm trên trang tính này và nếu không thì false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupDepth(rowIndex)
Trả về chiều sâu nhóm của hàng tại chỉ mục đã cho.
Chiều sâu nhóm cho biết có bao nhiêu nhóm chồng chéo với hàng. Giá trị này có thể dao động từ 0 đến 8.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over rows 1 through 3 var groupDepth = sheet.getRowGroupDepth(1);
Tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
Lấy chiều cao tính bằng pixel của một hàng nhất định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
Trả về Selection
hiện tại trong bảng tính.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Cầu thủ trả bóng
Selection
— lựa chọn hiện tại
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetId()
Trả về mã nhận dạng của trang tính do đối tượng này biểu thị.
Đây là mã nhận dạng của trang tính dành riêng cho 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í trang tính. Điều này hữu ích khi kết hợp với các phương thức như Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
. Phương thức này lấy tham số gridId
thay vì thực thể Sheet
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Cầu thủ trả bóng
Integer
— mã nhận dạng của trang tính chỉ dành cho bảng tính
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Trả về tên trang tính.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
Trả về lưới hình chữ nhật của các giá trị 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Tham số
Tên | Loại | Nội dung 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 để trả về giá trị. |
numColumns | Integer | Số cột cần trả về giá trị. |
Cầu thủ trả bóng
Object[][]
– một mảng các giá trị hai chiều
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSlicers()
Trả về một mảng các bộ cắt 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ộ cắt trên trang tính này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = first.getTabColorObject();
Cầu thủ trả bóng
Color
– Màu thẻ trang tính hoặc null
nếu thẻ trang tính không có màu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getType());
Cầu thủ trả bóng
SheetType
– Loại trang tính.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hasHiddenGridlines()
Trả về true
nếu các đường lưới của trang tính bị ẩn; nếu không sẽ trả về false
.
Đường lưới sẽ hiển thị theo mặc đị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'); // 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; nếu không đường lưới sẽ bị ẩn false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Ẩn cột hoặc các cột trong dải ô cho trước.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
column | Range | Dải ô cột cần ẩn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex)
Ẩn một cột tại chỉ mục đã cho. Hãy sử dụng 1 chỉ mục cho phương thức này.
Để ẩn nhiều cột bằng một chỉ mục, hãy sử dụng hideColumns(columnIndex, numColumns)
.
Để ẩn nhiều cột bằng một dải ô, hãy sử dụng hideColumn()
.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Hides the first column sheet.hideColumns(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnIndex | Integer | Chỉ mục của cột cần ẩn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex, numColumns)
Ẩn một hoặc nhiều cột liên tiếp bắt đầu từ chỉ mục đã cho. Hãy sử dụng 1 chỉ mục cho phương thức này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three columns sheet.hideColumns(1, 3);
Tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
Ẩn các hàng trong dải ô cho trước.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
row | Range | Dải ô hàng cần ẩn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex)
Ẩn hàng tại chỉ mục đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first row sheet.hideRows(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rowIndex | Integer | Chỉ mục của hàng cần ẩn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex, numRows)
Ẩn một hoặc nhiều hàng liên tiếp bắt đầu từ chỉ mục đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three rows sheet.hideRows(1, 3);
Tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideSheet()
Ẩn trang tính này. Không có hiệu lực nếu trang tính đã bị ẩn. Nếu phương thức này được gọi trên trang tính duy nhất hiển thị, thì phương thức này sẽ trả về một ngoại lệ.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.hideSheet();
Cầu thủ trả bóng
Sheet
– Trang tính hiện tại.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertChart(chart)
Thêm một biểu đồ mới vào trang tính này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates a simple bar chart from the first three rows // of the first two columns of the spreadsheet var 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 | Nội dung mô tả |
---|---|---|
chart | EmbeddedChart | Biểu đồ cần chèn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Chèn một cột sau vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
afterPosition | Integer | Cột mà sau đó bạn sẽ thêm cột mới. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Chèn một cột trước vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
beforePosition | Integer | Cột mà trước đó bạn phải thêm cột mới. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex)
Chèn một cột trống trong trang tính ở vị trí được chỉ định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by one sheet.insertColumns(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnIndex | Integer | Chỉ mục cho biết vị trí chèn một cột. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex, numColumns)
Chèn một hoặc nhiều cột trống liên tiếp trong trang tính bắt đầu tại vị trí được chỉ định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by three sheet.insertColumns(1, 3);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnIndex | Integer | Chỉ mục cho biết vị trí chèn một cột. |
numColumns | Integer | Số cột cần chèn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Chèn một số cột đã cho sau vị trí cột đã cho.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let 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 | Nội dung mô tả |
---|---|---|
afterPosition | Integer | Cột mà sau đó bạn sẽ thêm cột mới. |
howMany | Integer | Số cột cần chèn. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Chèn một số cột trước vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
beforePosition | Integer | Cột mà trước đó bạn phải thêm cột mới. |
howMany | Integer | Số cột cần chèn. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
Chèn BlobSource
dưới dạng hình ảnh trong tài liệu ở 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 của blob. Kích thước tối đa của blob được hỗ trợ là 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
blobSource | BlobSource | Blob có 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row, offsetX, offsetY)
Chèn BlobSource
dưới dạng hình ảnh trong tài liệu ở 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 của blob. Kích thước tối đa của blob
được hỗ trợ là 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
blobSource | BlobSource | Blob có 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 từ góc ô tính bằng pixel. |
offsetY | Integer | Độ lệch dọc so với góc của ô tính bằng pixel. |
Cầu thủ trả bóng
OverGridImage
– Hình ảnh được chèn.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
Chèn ảnh vào tài liệu ở một hàng và cột nhất định.
URL được cung cấp phải có thể truy cập công khai.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
Chèn hình ảnh trong tài liệu ở một hàng và cột nhất định, với độ lệch pixel.
URL được cung cấp phải có thể truy cập công khai.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
url | String | URL cho hình ảnh. |
column | Integer | Vị trí cột. |
row | Integer | Vị trí hàng. |
offsetX | Integer | Độ lệch ngang từ góc ô tính bằng pixel. |
offsetY | Integer | Độ lệch dọc so với góc của ô tính bằng pixel. |
Cầu thủ trả bóng
OverGridImage
– Hình ảnh đã chèn.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
Chèn một hàng sau vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
afterPosition | Integer | Hàng mà sau đó hàng mới sẽ được thêm vào. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Chèn một hàng trước vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
beforePosition | Integer | Hàng mà trước đó bạn sẽ thêm hàng mới. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex)
Chèn một hàng trống trong trang tính tại vị trí được chỉ định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by one sheet.insertRows(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rowIndex | Integer | Chỉ mục cho biết vị trí chèn hàng. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex, numRows)
Chèn một hoặc nhiều hàng trống liên tiếp trong một trang tính bắt đầu tại vị trí được chỉ định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by three sheet.insertRows(1, 3);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rowIndex | Integer | Chỉ mục cho biết vị trí chèn hàng. |
numRows | Integer | Số hàng cần chèn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Chèn một số hàng sau vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Tham số
Tên | Loại | Nội dung 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 tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Chèn một số dòng trước vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
beforePosition | Integer | Hàng mà trước đó bạn sẽ thêm các hàng mới. |
howMany | Integer | Số hàng cần chèn. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 | Nội dung mô tả |
---|---|---|
range | Range | Dải ô mà bộ cắt được tạo ra. |
anchorRowPos | Integer | Mặt trên của bộ cắt được neo vào hàng này. |
anchorColPos | Integer | Mặt trên của bộ cắt được neo vào cột này. |
Cầu thủ trả bóng
Slicer
– Bộ cắt mới được chèn.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 | Nội dung mô tả |
---|---|---|
range | Range | Dải ô mà bộ cắt được tạo ra. |
anchorRowPos | Integer | Mặt trên của bộ cắt được neo vào hàng này. |
anchorColPos | Integer | Mặt trên của bộ cắt được neo vào cột này. |
offsetX | Integer | Độ lệch ngang từ góc ô tính bằng pixel. |
offsetY | Integer | Độ lệch dọc so với góc của ô tính bằng pixel. |
Cầu thủ trả bóng
Slicer
– Bộ cắt mới được chèn.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
Trả về việc cột đã cho có bị người dùng ẩn hay không.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Tham số
Tên | Loại | Nội dung 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, nếu không thì false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Trả về xem liệu hàng đã cho có bị bộ lọc ẩn đi hay không (không phải chế độ xem bộ lọc).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Tham số
Tên | Loại | Nội dung 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, nếu không sẽ là false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
Trả về việc liệu hàng đã cho có bị người dùng ẩn hay không.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
Tham số
Tên | Loại | Nội dung 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, nếu không sẽ là false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isSheetHidden()
Trả về true
nếu trang tính đang bị ẩn.
var sheet = SpreadsheetApp.getActiveSheet(); if (sheet.isSheetHidden()) { // do something... }
Cầu thủ trả bóng
Boolean
– true
nếu trang tính bị ẩn, nếu không thì false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveColumns(columnSpec, destinationIndex)
Di chuyển các cột được chọn trong dải ô cho trước đến vị trí do destinationIndex
biểu thị. Bản thân columnSpec
không cần phải đại diện chính xác cho toàn bộ một cột hoặc nhóm cột cần di chuyển. Thuộc tính này chọn tất cả các cột mà phạm vi trải rộng.
// The code below moves rows A-B to destination index 5. // This results in those columns becoming columns C-D. var sheet = SpreadsheetApp.getActiveSheet(); // Selects column A and column B to be moved. var columnSpec = sheet.getRange("A1:B1"); sheet.moveColumns(columnSpec, 5);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnSpec | Range | Dải ô mở rộng trên các cột cần được di chuyển. |
destinationIndex | Integer | Chỉ mục mà các cột cần được di chuyển tới. Xin lưu ý rằng chỉ mục này dựa trên các toạ độ trước khi di chuyển các cột. Dữ liệu hiện có sẽ được dịch chuyển sang phải để dành chỗ cho các cột đã di chuyển, trong khi các cột nguồn sẽ bị xoá khỏi lưới. Do đó, dữ liệu có thể ở một chỉ mục khác với chỉ mục ban đầu. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveRows(rowSpec, destinationIndex)
Di chuyển các hàng được chọn trong dải ô đã cho đến vị trí do destinationIndex
biểu thị. Bản thân rowSpec
không cần phải đại diện chính xác cho toàn bộ một hàng hoặc nhóm hàng cần di chuyển, mà sẽ chọn mọi hàng mà phạm vi trải rộng.
// The code below moves rows 1-2 to destination index 5. // This results in those rows becoming rows 3-4. var sheet = SpreadsheetApp.getActiveSheet(); // Selects row 1 and row 2 to be moved. var rowSpec = sheet.getRange("A1:A2"); sheet.moveRows(rowSpec, 5);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rowSpec | Range | Một dải ô mở rộng trên các hàng cần được di chuyển. |
destinationIndex | Integer | Chỉ mục mà các hàng sẽ được di chuyển tới. Xin lưu ý rằng chỉ mục này dựa trên các toạ độ trước khi di chuyển các hàng. Dữ liệu hiện có sẽ được di chuyển xuống dưới để tạo chỗ trống cho các hàng đã di chuyển, trong khi các hàng nguồn sẽ bị xoá khỏi lưới. Do đó, dữ liệu có thể ở một chỉ mục khác với chỉ mục đã chỉ định ban đầu. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
newChart()
Trả về trình tạo để tạo biểu đồ mới cho trang tính này.
Ví dụ sau đây trình bày cách tạo biểu đồ mới:
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B8"); var 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
— Trình tạo để 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, ngoại trừ những người dùng có quyền. Cho đến khi tập lệnh thực sự thay đổi danh sách trình 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 mộ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 chế độ cài đặt bảo vệ hiện có.
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. var sheet = SpreadsheetApp.getActiveSheet(); var 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. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Cầu thủ trả bóng
Protection
– Đối tượng đại diện cho các chế độ cài đặt bảo vệ.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeChart(chart)
Xoá một biểu đồ khỏi trang tính mẹ.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This removes all the embedded charts from the spreadsheet var charts = sheet.getCharts(); for (var i in charts) { sheet.removeChart(charts[i]); }
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
chart | EmbeddedChart | Biểu đồ cần xoá. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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à current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
range | Range | Dải ô cần đặt làm dải ô hoạt động. |
Cầu thủ trả bóng
Range
– dải ô mới hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRangeList(rangeList)
Thiết lập danh sách dải ô được chỉ định dưới dạng active ranges
trong trang tính đang hoạt động. Dải ô cuối cùng trong danh sách được đặt là active range
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rangeList | RangeList | Danh sách dải ô để chọn. |
Cầu thủ trả bóng
RangeList
— danh sách dải ô mới được chọn
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(range)
Đặt vùng lựa chọn đang hoạt động cho trang tính này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
range | Range | Dải ô cần đặt làm lựa chọn đang hoạt động. |
Cầu thủ trả bóng
Range
– dải ô mới hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(a1Notation)
Đặt lựa chọn đang hoạt động, như chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
a1Notation | String | Dải ô cần đặt thành 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
– dải ô mới hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnGroupControlPosition(position)
Đặt vị trí của nút điều khiển nhóm cột trên trang tính.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
position | GroupControlTogglePosition | Vị trí của nút bật/tắt chế độ kiểm soát nhóm cột. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnPosition, width)
Đặt chiều rộng của cột đã cho tính bằng pixel.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Tham số
Tên | Loại | Nội dung 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 cần đặt. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(startColumn, numColumns, width)
Đặt chiều rộng của các cột đã cho tính bằng pixel.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 | Nội dung 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 cần đặt. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setConditionalFormatRules(rules)
Thay thế tất cả quy tắc định dạng có điều kiện hiện có trong trang tính bằng quy tắc nhập dữ liệu. Các quy tắc được đánh giá theo thứ tự nhập.
// Remove one of the existing conditional format rules. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); rules.splice(1, 1); // Deletes the 2nd format rule. sheet.setConditionalFormatRules(rules);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rules | ConditionalFormatRule[] | Quy tắc định dạng có điều kiện mới. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
Đặt ô được chỉ định làm current cell
.
Nếu ô được chỉ định có 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, Range
sẽ trả về một ngoại lệ.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Tham số
Tên | Loại | Nội dung 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 thiết lập
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenColumns(columns)
Cố định số cột đã cho. Nếu 0 thì không có cột nào bị cố định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columns | Integer | Số cột cần cố định. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenRows(rows)
Cố định số hàng đã cho. Nếu 0 thì không có hàng nào bị cố định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rows | Integer | Số hàng cần cố định. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHiddenGridlines(hideGridlines)
Ẩn hoặc hiển thị đườ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 | Nội dung mô tả |
---|---|---|
hideGridlines | Boolean | Nếu là true , hãy ẩn các đường lưới trong trang tính này; nếu không, hãy hiện các đường lưới. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Đặt tên trang tính.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setName("not first anymore");
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | Tên mới cho trang tính. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 | Nội dung mô tả |
---|---|---|
rightToLeft | Boolean | Nếu là true , bố cục trang tính sẽ được đặt từ phải sang trái, trong đó ô A1 ở góc trên cùng bên phải. Nếu là false , bố cục trang tính sẽ được đặt theo mặc định từ trái sang phải, với ô A1 ở trên cùng bên trái. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowGroupControlPosition(position)
Đặt vị trí của nút điều khiển nhóm hàng trên trang tính.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
position | GroupControlTogglePosition | Vị trí của nút điều khiển nhóm hàng. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
Đặt chiều cao của hàng đã cho tính bằng pixel. Theo mặc định, các hàng phát triển để vừa với nội dung ô. Nếu
bạn muốn buộc các hàng theo chiều cao đã chỉ định, hãy sử dụng setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
Tham số
Tên | Loại | Nội dung 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 tính hữu ích cho việc tạo chuỗi phương thức.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeights(startRow, numRows, height)
Đặt chiều cao của hàng đã cho tính bằng pixel. Theo mặc định, các hàng phát triển để vừa với nội dung ô. Nếu bạn muốn buộc các hàng đến một chiều cao đã chỉ định, hãy sử dụng setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 | Nội dung 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 để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeightsForced(startRow, numRows, height)
Đặt chiều cao của hàng đã cho tính bằng pixel. Theo mặc định, các hàng phát triển để vừa với nội dung ô. Khi
bạn sử dụng setRowHeightsForced
, các hàng bị buộc phải theo chiều cao đã chỉ định ngay cả khi
nội dung trong ô cao hơn chiều cao của hàng.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 | Nội dung 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 để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColor(color)
Đặt màu cho thẻ trang tính.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setTabColor("ff0000"); // Set the color to red. first.setTabColor(null); // Unset the color.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | String | Mã màu trong 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 để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColorObject(color)
Đặt màu cho thẻ trang tính.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var 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 | Nội dung mô tả |
---|---|---|
color | Color | Màu của thẻ trang tính cần đặt. |
Cầu thủ trả bóng
Sheet
– Trang tính này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex)
Hiện cột tại chỉ mục đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first column sheet.showColumns(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnIndex | Integer | Chỉ mục của cột cần hiện. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex, numColumns)
Hiện một hoặc nhiều cột liên tiếp bắt đầu tại chỉ mục đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three columns sheet.showColumns(1, 3);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnIndex | Integer | Chỉ mục bắt đầu của các cột cần hiện. |
numColumns | Integer | Số cột sẽ hiện. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex)
Hiện hàng tại chỉ mục đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first row sheet.showRows(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rowIndex | Integer | Chỉ mục của hàng cần hiện. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three rows sheet.showRows(1, 3);
Tham số
Tên | Loại | Nội dung 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 sẽ hiện. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showSheet()
Hiển thị trang tính. Không có hiệu lực nếu trang tính đã hiển thị.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.showSheet();
Cầu thủ trả bóng
Sheet
– Trang tính hiện tại.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition)
Sắp xếp trang tính theo cột, tăng dần.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnPosition | Integer | Cột cần sắp xếp theo. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Sắp xếp trang tính theo cột. Lấy một tham số để chỉ định mức tăng dần hoặc giảm dần.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnPosition | Integer | Cột cần sắp xếp theo. |
ascending | Boolean | true để sắp xếp theo thứ tự tăng dần, false để sắp xếp giảm dần. |
Cầu thủ trả bóng
Sheet
– trang tính hữu ích cho việc tạo chuỗi phương thức
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideColumn(column)
Hiện cột trong dải ô đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
column | Range | Dải ô sẽ hiện, nếu bị ẩn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideRow(row)
Hiện hàng trong dải ô đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
row | Range | Dải ô sẽ hiện, nếu bị ẩn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateChart(chart)
Cập nhật biểu đồ trên trang tính này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code is going to loop through all the charts and change them to // column charts var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; var newChart = chart .modify() .setChartType(Charts.ChartType.COLUMN) .build(); sheet.updateChart(newChart); }
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
chart | EmbeddedChart | Biểu đồ cần cập nhật. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets