Truy cập và tạo tệp Google Trang tính. Lớp này là lớp mẹ của Dịch vụ bảng tính.
Thuộc tính
Thuộc tính | Loại | Mô tả |
---|---|---|
AutoFillSeries | AutoFillSeries | Bảng liệt kê các loại chuỗi dữ liệu dùng để tính toán các giá trị được điền tự động. |
BandingTheme | BandingTheme | Bảng liệt kê các giao diện dải có thể có. |
BooleanCriteria | BooleanCriteria | Bảng liệt kê các tiêu chí boolean định dạng có điều kiện. |
BorderStyle | BorderStyle | Bảng liệt kê các kiểu hợp lệ để đặt đường viền trên Range . |
ColorType | ColorType | Bảng liệt kê các loại màu có thể sử dụng. |
CopyPasteType | CopyPasteType | Bảng liệt kê các kiểu dán có thể có. |
DataExecutionErrorCode | DataExecutionErrorCode | Bảng liệt kê các mã lỗi thực thi dữ liệu có thể xảy ra. |
DataExecutionState | DataExecutionState | Bảng liệt kê các trạng thái thực thi dữ liệu có thể có. |
DataSourceParameterType | DataSourceParameterType | Bảng liệt kê các loại tham số nguồn dữ liệu có thể có. |
DataSourceRefreshScope | DataSourceRefreshScope | Bảng liệt kê các phạm vi có thể làm mới nguồn dữ liệu. |
DataSourceType | DataSourceType | Bảng liệt kê các loại nguồn dữ liệu có thể có. |
DataValidationCriteria | DataValidationCriteria | Một bản liệt kê thể hiện tiêu chí xác thực dữ liệu có thể thiết lập trên một dải ô. |
DateTimeGroupingRuleType | DateTimeGroupingRuleType | Bảng liệt kê quy tắc nhóm ngày giờ. |
DeveloperMetadataLocationType | DeveloperMetadataLocationType | Bảng liệt kê các loại vị trí siêu dữ liệu nhà phát triển có thể có. |
DeveloperMetadataVisibility | DeveloperMetadataVisibility | Bảng liệt kê các nội dung có thể hiển thị siêu dữ liệu nhà phát triển. |
Dimension | Dimension | Bảng liệt kê các kích thước có thể có trong bảng tính. |
Direction | Direction | Bảng liệt kê các hướng khả thi mà một người có thể di chuyển trong bảng tính bằng mũi tên khoá. |
FrequencyType | FrequencyType | Bảng liệt kê các loại tần suất có thể có. |
GroupControlTogglePosition | GroupControlTogglePosition | Bảng liệt kê các vị trí mà nút bật/tắt chế độ kiểm soát nhóm có thể có. |
InterpolationType | InterpolationType | Bảng liệt kê các kiểu nội suy chuyển màu theo định dạng có điều kiện. |
PivotTableSummarizeFunction | PivotTableSummarizeFunction | Bảng liệt kê các hàm có thể dùng để tóm tắt các giá trị trong bảng tổng hợp. |
PivotValueDisplayType | PivotValueDisplayType | Bảng liệt kê các cách hiển thị giá trị tổng hợp. |
ProtectionType | ProtectionType | Một bản liệt kê đại diện cho các phần của bảng tính có thể được bảo vệ khỏi nội dung chỉnh sửa. |
RecalculationInterval | RecalculationInterval | Bảng liệt kê các khoảng thời gian có thể dùng trong tính toán lại bảng tính. |
RelativeDate | RelativeDate | Bảng liệt kê các tuỳ chọn ngày tương đối để tính toán một giá trị sẽ được dùng trong BooleanCriteria dựa trên ngày. |
SheetType | SheetType | Bảng liệt kê các loại trang tính khác nhau có thể tồn tại trong một bảng tính. |
SortOrder | SortOrder | Bảng liệt kê thứ tự sắp xếp. |
TextDirection | TextDirection | Bảng liệt kê các hướng văn bản hợp lệ. |
TextToColumnsDelimiter | TextToColumnsDelimiter | Bảng liệt kê các dấu phân cách đặt trước để phân tách văn bản thành các cột. |
ThemeColorType | ThemeColorType | Bảng liệt kê các loại màu giao diện có thể có. |
ValueType | ValueType | Bảng liệt kê các loại giá trị được Range.getValue() và Range.getValues() trả về từ lớp Dải ô của dịch vụ Bảng tính. Các giá trị liệt kê
được liệt kê bên dưới ngoài Number , Boolean , Date hoặc String . |
WrapStrategy | WrapStrategy | Bảng liệt kê các chiến lược dùng để gói ô. |
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
create(name) | Spreadsheet | Tạo bảng tính mới có tên đã cho. |
create(name, rows, columns) | Spreadsheet | Tạo một bảng tính mới có tên đã cho cùng với số hàng và cột đã chỉ định. |
enableAllDataSourcesExecution() | void | Bật chế độ thực thi dữ liệu cho tất cả các loại nguồn dữ liệu. |
enableBigQueryExecution() | void | Bật tính năng thực thi dữ liệu cho nguồn dữ liệu BigQuery. |
flush() | void | Áp dụng tất cả các thay đổi đang chờ xử lý trên bảng tính. |
getActive() | Spreadsheet | Trả về bảng tính đang hoạt động hoặc null nếu không có bảng tính nào. |
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 ô hoạt động. |
getActiveRangeList() | RangeList | Trả về danh sách dải ô đang hoạt động trong trang tính đang hoạt động hoặc null nếu không có dải ô
đã chọn. |
getActiveSheet() | Sheet | Xem trang tính đang hoạt động trong một bảng tính. |
getActiveSpreadsheet() | Spreadsheet | Trả về bảng tính đang hoạt động hoặc null nếu không có bảng tính nào. |
getCurrentCell() | Range | Trả về ô hiện tại (được đánh dấu) được chọn ở một trong các dải ô hoạt động trong
trang tính đang hoạt động hoặc null nếu không có ô hiện tại. |
getSelection() | Selection | Trả về Selection hiện tại trong bảng tính. |
getUi() | Ui | Trả về một thực thể của môi trường giao diện người dùng của bảng tính cho phép tập lệnh thêm các tính năng như trình đơn, hộp thoại và thanh bên. |
newCellImage() | CellImageBuilder | Tạo trình tạo cho CellImage . |
newColor() | ColorBuilder | Tạo trình tạo cho Color . |
newConditionalFormatRule() | ConditionalFormatRuleBuilder | Tạo trình tạo cho quy tắc định dạng có điều kiện. |
newDataSourceSpec() | DataSourceSpecBuilder | Tạo trình tạo cho DataSourceSpec . |
newDataValidation() | DataValidationBuilder | Tạo trình tạo cho quy tắc xác thực dữ liệu. |
newFilterCriteria() | FilterCriteriaBuilder | Tạo trình tạo cho FilterCriteria . |
newRichTextValue() | RichTextValueBuilder | Tạo một trình tạo giá trị Văn bản đa dạng thức. |
newTextStyle() | TextStyleBuilder | Tạo trình tạo cho kiểu văn bản. |
open(file) | Spreadsheet | Mở bảng tính tương ứng với đối tượng Tệp đã cho. |
openById(id) | Spreadsheet | Mở bảng tính bằng mã nhận dạng đã cho. |
openByUrl(url) | Spreadsheet | Mở bảng tính có URL đã cho. |
setActiveRange(range) | Range | Đặt dải ô được chỉ định làm active range , có phần trên cùng
ô bên trái trong dải ô dưới dạng current cell . |
setActiveRangeList(rangeList) | RangeList | Thiết lập danh sách dải ô được chỉ định làm active ranges . |
setActiveSheet(sheet) | Sheet | Đặt trang tính đang hoạt động trong một bảng tính. |
setActiveSheet(sheet, restoreSelection) | Sheet | Đặt trang tính đang hoạt động trong một bảng tính, có lựa chọn khôi phục lựa chọn gần đây nhất trong trang tính đó. |
setActiveSpreadsheet(newActiveSpreadsheet) | void | Đặt bảng tính đang hoạt động. |
setCurrentCell(cell) | Range | Đặt ô được chỉ định làm current cell . |
Tài liệu chi tiết
create(name)
Tạo bảng tính mới có tên đã cho.
// The code below creates a new spreadsheet "Finances" and logs the URL for it var ssNew = SpreadsheetApp.create("Finances"); Logger.log(ssNew.getUrl());
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên cho bảng tính. |
Cầu thủ trả bóng
Spreadsheet
— một bảng tính mới
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets
create(name, rows, columns)
Tạo một bảng tính mới có tên đã cho cùng với số hàng và cột đã chỉ định.
// The code below creates a new spreadsheet "Finances" with 50 rows and 5 columns and logs the // URL for it var ssNew = SpreadsheetApp.create("Finances", 50, 5); Logger.log(ssNew.getUrl());
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên cho bảng tính. |
rows | Integer | Số hàng của bảng tính. |
columns | Integer | Số cột cho bảng tính. |
Cầu thủ trả bóng
Spreadsheet
— một bảng tính mới
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets
enableAllDataSourcesExecution()
Bật chế độ thực thi dữ liệu cho tất cả các loại nguồn dữ liệu.
Quá trình thực thi dữ liệu sẽ gửi ra một trường hợp ngoại lệ nếu bạn chưa bật loại nguồn dữ liệu. Sử dụng phương thức này để bật tính năng thực thi dữ liệu cho tất cả các loại nguồn dữ liệu.
// Turns data execution on for all types of data sources. SpreadsheetApp.enableAllDataSourcesExecution(); // 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 the first data source sheet in the spreadsheet and refreshes the data. ss.getDataSourceSheets()[0].refreshData();
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/bigquery.readonly
enableBigQueryExecution()
Bật tính năng thực thi dữ liệu cho nguồn dữ liệu BigQuery.
Quá trình thực thi dữ liệu cho nguồn dữ liệu BigQuery sẽ gửi ra một ngoại lệ nếu chưa được bật.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // 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 the first data source sheet in the spreadsheet and refreshes the BigQuery data. ss.getDataSourceSheets()[0].refreshData();
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/bigquery.readonly
flush()
Áp dụng tất cả các thay đổi đang chờ xử lý trên bảng tính.
Các hoạt động trong bảng tính đôi khi được nhóm lại với nhau để cải thiện hiệu suất, chẳng hạn như khi thực hiện nhiều lệnh gọi đến Range.getValue(). Tuy nhiên, đôi khi bạn có thể muốn đảm bảo rằng tất cả các thay đổi đang chờ xử lý được thực hiện ngay lập tức, chẳng hạn như để cho người dùng thấy dữ liệu khi một tập lệnh đang thực thi.
// The code below changes the background color of cells A1 and B1 twenty times. You should be // able to see the updates live in the spreadsheet. If flush() is not called, the updates may // be applied live or may all be applied at once when the script completes. function colors() { var sheet = SpreadsheetApp.getActiveSheet(); for (var i = 0; i < 20; i++) { if ((i % 2) == 0) { sheet.getRange('A1').setBackground('green'); sheet.getRange('B1').setBackground('red'); } else { sheet.getRange('A1').setBackground('red'); sheet.getRange('B1').setBackground('green'); } SpreadsheetApp.flush(); } }
getActive()
Trả về bảng tính đang hoạt động hoặc null
nếu không có bảng tính nào.
Các hàm chạy trong ngữ cảnh bảng tính có thể tham chiếu đến tương ứng với Bảng tính bằng cách gọi hàm này.
// The code below logs the URL for the active spreadsheet. Logger.log(SpreadsheetApp.getActive().getUrl());
Cầu thủ trả bóng
Spreadsheet
— đối tượng Bảng tính đang hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 ô hoạt động. Nếu
nhiều dải ô đã được chọn, phương thức này chỉ trả về dải ô được chọn gần đây nhất.
Đây thường là dải ô mà người dùng đã chọn trong trang tính hiện hoạt, nhưng trong một hàm này tham chiếu đến ô đang được tính toán lại chủ động.
// The code below logs the background color for the active range. var colorObject = SpreadsheetApp.getActiveRange().getBackgroundObject(); // Assume the color has ColorType.RGB. Logger.log(colorObject.asRgbColor().asHexString());
Cầu thủ trả bóng
Range
— Dải ô đang hoạt động.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRangeList()
Trả về danh sách dải ô đang hoạt động trong trang tính đang hoạt động hoặc null
nếu không có dải ô
đã chọn. Dải ô hoạt động chứa ô được đánh dấu hiện tại được đặt cuối cùng trong danh sách.
Nếu bạn chọn một dải ô, thì mục này sẽ hoạt động như một lệnh gọi getActiveRange()
.
// Returns the list of active ranges. var rangeList = SpreadsheetApp.getActiveRangeList();
Cầu thủ trả bóng
RangeList
— danh sách các dải ô đang hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveSheet()
Xem trang tính đang hoạt động trong một bảng tính.
Trang tính đang hoạt động trong bảng tính là trang tính đang hiển thị trong bảng tính Giao diện người dùng.
// The code below logs the name of the active sheet. Logger.log(SpreadsheetApp.getActiveSheet().getName());
Cầu thủ trả bóng
Sheet
– đối tượng Trang tính đang hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveSpreadsheet()
Trả về bảng tính đang hoạt động hoặc null
nếu không có bảng tính nào.
Các hàm chạy trong ngữ cảnh bảng tính có thể tham chiếu đến
tương ứng với Spreadsheet
bằng cách gọi hàm này.
// The code below logs the URL for the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getUrl());
Cầu thủ trả bóng
Spreadsheet
— đối tượng Bảng tính đang hoạt động
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
Trả về ô hiện tại (được đánh dấu) được chọn ở một trong các dải ô hoạt động trong
trang tính đang hoạt động hoặc null
nếu không có ô hiện tại.
// Returns the current highlighted cell in the one of the active ranges. var currentCell = SpreadsheetApp.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 yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
Trả về Selection
hiện tại trong bảng tính.
var selection = SpreadsheetApp.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 yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getUi()
Trả về một thực thể của môi trường giao diện người dùng của bảng tính cho phép tập lệnh thêm các tính năng như trình đơn, hộp thoại và thanh bên. Một tập lệnh chỉ có thể tương tác với giao diện người dùng cho bản sao hiện tại của bảng tính đang mở và chỉ khi tập lệnh bị ràng buộc với bảng tính. Để biết thêm thông tin, hãy xem hướng dẫn về trình đơn cũng như hộp thoại và thanh bên.
// Add a custom menu to the active spreadsheet, including a separator and a sub-menu. function onOpen(e) { SpreadsheetApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(SpreadsheetApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
Cầu thủ trả bóng
Ui
— một thực thể của môi trường giao diện người dùng của bảng tính này
newCellImage()
Tạo trình tạo cho CellImage
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A1 on Sheet1. const range = sheet.getRange('A1'); // Builds an image using a source URL. const cellImage = SpreadsheetApp.newCellImage() .setSourceUrl('https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png') .build(); // Sets the image in cell A1. range.setValue(cellImage);
Cầu thủ trả bóng
CellImageBuilder
— Trình tạo mới.
newColor()
Tạo trình tạo cho Color
.
var rgbColor = SpreadsheetApp.newColor().setRgbColor("#FF0000").build();
Cầu thủ trả bóng
ColorBuilder
— Trình tạo mới.
newConditionalFormatRule()
Tạo trình tạo cho quy tắc định dạng có điều kiện.
// Adds a conditional format rule to a sheet that causes all cells in range A1:B3 to turn red // if they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActive().getActiveSheet(); var range = sheet.getRange('A1:B3'); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build() var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Cầu thủ trả bóng
ConditionalFormatRuleBuilder
– trình tạo mới.
newDataSourceSpec()
Tạo trình tạo cho DataSourceSpec
.
// 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'); // Enables BigQuery. SpreadsheetApp.enableBigQueryExecution(); // Builds a data source specification. // TODO (developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setTableProjectId('bigquery-public-data') .setDatasetId('ncaa_basketball') .setTableId('mbb_historical_teams_games') .build(); // Adds the data source and its data to the spreadsheet. ss.insertDataSourceSheet(dataSourceSpec);
Cầu thủ trả bóng
DataSourceSpecBuilder
— Trình tạo mới.
newDataValidation()
Tạo trình tạo cho quy tắc xác thực dữ liệu.
var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireNumberBetween(1, 100) .setAllowInvalid(false) .setHelpText('Number must be between 1 and 100.') .build(); cell.setDataValidation(rule);
Cầu thủ trả bóng
DataValidationBuilder
— Trình tạo mới.
newFilterCriteria()
Tạo trình tạo cho FilterCriteria
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets the range to A1:D20. const range = sheet.getRange('A1:D20'); // Creates a filter and applies it to the specified range. range.createFilter(); // Gets the current filter for the range and creates filter criteria that only shows cells // that aren't empty. const filter = range.getFilter(); const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build(); // Sets the criteria to column C. filter.setColumnFilterCriteria(3, criteria);
Cầu thủ trả bóng
FilterCriteriaBuilder
– trình tạo mới
newRichTextValue()
Tạo một trình tạo giá trị Văn bản đa dạng thức.
// Sets cell A1 to have the text "Hello world", with "Hello" bolded. var cell = SpreadsheetApp.getActive().getRange('A1'); var bold = SpreadsheetApp.newTextStyle().setBold(true).build(); var value = SpreadsheetApp.newRichTextValue() .setText("Hello world") .setTextStyle(0, 5, bold) .build(); cell.setRichTextValue(value);
Cầu thủ trả bóng
RichTextValueBuilder
— Trình tạo mới.
newTextStyle()
Tạo trình tạo cho kiểu văn bản.
// Sets range A1:B3 to have red, size 22, bolded, underlined text. var range = SpreadsheetApp.getActive().getRange('A1:B3'); var style = SpreadsheetApp.newTextStyle() .setForegroundColor("red") .setFontSize(22) .setBold(true) .setUnderline(true) .build(); range.setTextStyle(style);
Cầu thủ trả bóng
TextStyleBuilder
— Trình tạo mới.
open(file)
Mở bảng tính tương ứng với đối tượng Tệp đã cho.
// Get any starred spreadsheets from Google Drive, then open the spreadsheets and log the name // of the first sheet within each spreadsheet. var files = DriveApp.searchFiles( 'starred = true and mimeType = "' + MimeType.GOOGLE_SHEETS + '"'); while (files.hasNext()) { var spreadsheet = SpreadsheetApp.open(files.next()); var sheet = spreadsheet.getSheets()[0]; Logger.log(sheet.getName()); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
file | File | Tệp cần mở. |
Cầu thủ trả bóng
Spreadsheet
— bảng tính
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets
openById(id)
Mở bảng tính bằng mã nhận dạng đã cho. Bạn có thể trích xuất mã bảng tính từ URL của bảng tính. Cho
ví dụ: mã nhận dạng bảng tính trong URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0
là "abc1234567".
// The code below opens a spreadsheet using its ID and logs the name for it. // Note that the spreadsheet is NOT physically opened on the client side. // It is opened on the server only (for modification by the script). var ss = SpreadsheetApp.openById("abc1234567"); Logger.log(ss.getName());
Tham số
Tên | Loại | Mô tả |
---|---|---|
id | String | Giá trị nhận dạng duy nhất của bảng tính. |
Cầu thủ trả bóng
Spreadsheet
– đối tượng Bảng tính có mã nhận dạng đã cho
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets
openByUrl(url)
Mở bảng tính có URL đã cho. Gửi một ngoại lệ về tập lệnh nếu URL không tồn tại hoặc người dùng không có quyền truy cập.
// Opens a spreadsheet by its URL and logs its name. // Note that the spreadsheet doesn't physically open on the client side. // It opens on the server only (for modification by the script). var ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc1234567/edit'); console.log(ss.getName());
Tham số
Tên | Loại | Mô tả |
---|---|---|
url | String | URL cho bảng tính. |
Cầu thủ trả bóng
Spreadsheet
— Đối tượng bảng tính có URL đã cho.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Đặt dải ô được chỉ định làm active range
, có phần trên cùng
ô bên trái trong dải ô dưới dạng current cell
.
Giao diện người dùng của bảng tính cho thấy trang tính chứa dải ô đã chọn và chọn các ô được xác định trong dải ô đã chọn.
// The code below sets range C1:D4 in the first sheet as the active range. var range = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('C1:D4'); SpreadsheetApp.setActiveRange(range); var selection = SpreadsheetApp.getSelection(); // Current cell: C1 var currentCell = selection.getCurrentCell(); // Active Range: C1:D4 var activeRange = selection.getActiveRange();
Tham số
Tên | Loại | Mô tả |
---|---|---|
range | Range | Dải ô được đặt làm dải ô hoạt động. |
Cầu thủ trả bóng
Range
— Phạm vi hoạt động mới
setActiveRangeList(rangeList)
Thiết lập danh sách dải ô được chỉ định làm active ranges
. Cuối cùng
dải ô trong danh sách được đặt thành active range
.
// The code below sets ranges [D4, B2:C4] in the active sheet as the active ranges. var rangeList = SpreadsheetApp.getActiveSheet().getRanges(['D4', 'B2:C4']); SpreadsheetApp.setActiveRangeList(rangeList); var selection = SpreadsheetApp.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 | Mô tả |
---|---|---|
rangeList | RangeList | Danh sách các dải ô để chọn. |
Cầu thủ trả bóng
RangeList
— danh sách các dải ô mới được chọn
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSheet(sheet)
Đặt trang tính đang hoạt động trong một bảng tính. Giao diện người dùng của Google Trang tính hiển thị trang tính đã chọn trừ phi trang tính thuộc về một bảng tính khác.
// The code below makes the 2nd sheet active in the active spreadsheet. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | Sheet | Trang tính đang hoạt động mới. |
Cầu thủ trả bóng
Sheet
— trang tính đã được tạo là trang tính hoạt động mới
setActiveSheet(sheet, restoreSelection)
Đặt trang tính đang hoạt động trong một bảng tính, có lựa chọn khôi phục lựa chọn gần đây nhất trong trang tính đó. Giao diện người dùng của Google Trang tính hiển thị trang tính đã chọn, trừ phi trang tính đó thuộc về bảng tính khác.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var firstSheet = spreadsheet.getSheets()[0]; var secondSheet = spreadsheet.getSheets()[1]; // Set the first sheet as the active sheet and select the range D4:F4. spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate(); // Switch to the second sheet to do some work. spreadsheet.setActiveSheet(secondSheet); // Switch back to first sheet, and restore its selection. spreadsheet.setActiveSheet(firstSheet, true); // The selection of first sheet is restored, and it logs D4:F4 var range = spreadsheet.getActiveSheet().getSelection().getActiveRange(); Logger.log(range.getA1Notation());
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | Sheet | Trang tính đang hoạt động mới. |
restoreSelection | Boolean | Nếu là true , lựa chọn gần đây nhất của trang tính đang hoạt động mới
được chọn lại khi trang tính mới hoạt động; nếu là false , trang tính mới
sẽ hoạt động mà không thay đổi lựa chọn hiện tại. |
Cầu thủ trả bóng
Sheet
— trang tính đang hoạt động mới
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSpreadsheet(newActiveSpreadsheet)
Đặt bảng tính đang hoạt động.
// The code below makes the spreadsheet with key "1234567890" the active spreadsheet var ss = SpreadsheetApp.openById("1234567890"); SpreadsheetApp.setActiveSpreadsheet(ss);
Tham số
Tên | Loại | Mô tả |
---|---|---|
newActiveSpreadsheet | Spreadsheet | Bảng tính sẽ được đặt làm bảng tính đang hoạt động. |
setCurrentCell(cell)
Đặt ô được chỉ định làm current cell
.
Nếu ô được chỉ định có mặt trong một dải ô đã chọn thì dải ô đó sẽ trở thành dải ô đang hoạt động, trong đó ô là ô hiện tại.
Nếu ô được chỉ định không có trong bất kỳ dải ô nào đã chọn, thì vùng được chọn hiện có sẽ là bị xoá và ô trở thành ô hiện tại và dải ô đang hoạt động.
Lưu ý:Range
được chỉ định phải bao gồm một ô, nếu không thì phương thức này
trả về một ngoại lệ.
// The code below sets the cell B5 in the first sheet as the current cell. var cell = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('B5'); SpreadsheetApp.setCurrentCell(cell); var selection = SpreadsheetApp.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Tham số
Tên | Loại | Mô tả |
---|---|---|
cell | Range | Ô cần đặt làm ô hiện tại. |
Cầu thủ trả bóng
Range
— ô hiện tại mới đặt
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets