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

Class SpreadsheetApp

Truy cập và tạo tệp trên Google Trang tính. Lớp này là lớp mẹ cho Dịch vụ bảng tính.

Thuộc tính

Tài sản	Loại	Nội dung mô tả
`AutoFillSeries`	`AutoFillSeries`	Bảng liệt kê các loại chuỗi được dùng để tính các giá trị được điền tự động.
`BandingTheme`	`BandingTheme`	Bảng liệt kê các chủ đề 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 cho `Range`.
`ColorType`	`ColorType`	Bảng liệt kê các loại màu có thể có.
`CopyPasteType`	`CopyPasteType`	Bảng liệt kê các loại nội dung có thể dán.
`DataExecutionErrorCode`	`DataExecutionErrorCode`	Bảng liệt kê các mã lỗi có thể xảy ra khi thực thi dữ liệu.
`DataExecutionState`	`DataExecutionState`	Bảng liệt kê các trạng thái thực thi dữ liệu có thể xảy ra.
`DataSourceParameterType`	`DataSourceParameterType`	Bảng liệt kê các loại thông số nguồn dữ liệu có thể có.
`DataSourceRefreshScope`	`DataSourceRefreshScope`	Bảng liệt kê các phạm vi làm mới nguồn dữ liệu có thể có.
`DataSourceType`	`DataSourceType`	Bảng liệt kê các loại nguồn dữ liệu có thể có.
`DataValidationCriteria`	`DataValidationCriteria`	Một bảng liệt kê thể hiện tiêu chí xác thực dữ liệu có thể được đặt 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í có thể có của siêu dữ liệu nhà phát triển.
`DeveloperMetadataVisibility`	`DeveloperMetadataVisibility`	Bảng liệt kê khả năng hiển thị của siêu dữ liệu dành cho nhà phát triển.
`Dimension`	`Dimension`	Bảng liệt kê các phương diện có thể có của bảng tính.
`Direction`	`Direction`	Bảng liệt kê các hướng mà một người có thể di chuyển trong bảng tính bằng các phím mũi tên.
`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ể nằm trong đó.
`InterpolationType`	`InterpolationType`	Bảng liệt kê các loại nội suy chuyển màu chuyển tiếp đị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 có thể hiển thị giá trị tổng hợp.
`ProtectionType`	`ProtectionType`	Một bảng liệt kê thể hiện 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 khi tính toán lại trong 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 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 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 tá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ê dưới đây bổ sung cho `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	Kiểu 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 bảng tính mới có tên đã cho và 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 chế độ thực thi dữ liệu cho các nguồn dữ liệu BigQuery.
`flush()`	`void`	Áp dụng tất cả các thay đổi đang chờ xử lý liên quan đế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 ô 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 chưa có dải ô nào được chọn.
`getActiveSheet()`	`Sheet`	Lấy 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 ô đang hoạt động trong trang tính đang hoạt động hoặc `null` nếu không có ô hiện tại nào.
`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 một trình tạo cho `CellImage`.
`newColor()`	`ColorBuilder`	Tạo một 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 một 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 một trình tạo cho `FilterCriteria`.
`newRichTextValue()`	`RichTextValueBuilder`	Tạo trình tạo cho 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 bằng URL đã cho.
`setActiveRange(range)`	`Range`	Đặt dải ô được chỉ định thành `active range`, 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`.
`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, với tuỳ 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());

Các tham số

Tên	Loại	Nội dung 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 cần được uỷ 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 bảng tính mới có tên đã cho và 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());

Các tham số

Tên	Loại	Nội dung mô tả
`name`	`String`	Tên cho bảng tính.
`rows`	`Integer`	Số hàng cho bảng tính.
`columns`	`Integer`	Số cột của 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 cần được uỷ 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ẽ tạo ra trường hợp ngoại lệ nếu loại nguồn dữ liệu chưa được bật. Hãy sử dụng phương thức này để bật quá trình 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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/bigquery.readonly

`enableBigQueryExecution()`

Bật chế độ thực thi dữ liệu cho các nguồn dữ liệu BigQuery.

Quá trình thực thi dữ liệu cho nguồn dữ liệu BigQuery sẽ tạo ra một ngoại lệ nếu không đượ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 cần được uỷ 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ý liên quan đến Bảng tính.

Đôi khi, các thao tác trong bảng tính đượ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 nên đảm bảo rằng tất cả thay đổi đang chờ xử lý sẽ được thực hiện ngay lập tức, chẳng hạn như để hiển thị dữ liệu người dùng khi 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 của bảng tính có thể tham chiếu đến đối tượng Bảng tính tương ứng 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 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.

Nói chung, đây là 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, dải ô này đề cập đến ô đang được tính toán lại.

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

`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 chưa có dải ô nào được chọn. Dải ô đang hoạt động có chứa ô được đánh dấu hiện tại sẽ được đặt ở cuối danh sách.

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

// Returns the list of active ranges.
var rangeList = SpreadsheetApp.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

`getActiveSheet()`

Lấy 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 giao diện người dùng của bảng tính.

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

`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 của bảng tính có thể tham chiếu đến đối tượng Spreadsheet tương ứng 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 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 (được đánh dấu) được chọn ở một trong các dải ô đang hoạt động trong trang tính đang hoạt động hoặc null nếu không có ô hiện tại nào.

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

`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 được liên kết 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 phiên bản của môi trường giao diện người dùng của bảng tính này

`newCellImage()`

Tạo một 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 một 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 một 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 một 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 trình tạo cho 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());
}

Các tham số

Tên	Loại	Nội dung mô tả
`file`	`File`	Tệp sẽ 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 cần được uỷ 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ã nhận dạng bảng tính từ URL của bảng tính đó. 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());

Các tham số

Tên	Loại	Nội dung 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 cần được uỷ 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 bằng URL đã cho. Gửi một ngoại lệ cho 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 vào URL đó.

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

Các tham số

Tên	Loại	Nội dung 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 cần được uỷ 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 thành active range, với ô trên cùng bên trái trong dải ô là current cell.

Giao diện người dùng bảng tính cho thấy trang tính có 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();

Các tham số

Tên	Loại	Nội dung mô tả
`range`	`Range`	Dải ô cần được tạo thành dải ô hoạt động.

Cầu thủ trả bóng

Range – Dải ô mới đang hoạt động

`setActiveRangeList(rangeList)`

Thiết lập danh sách dải ô được chỉ định dưới dạng active ranges. Dải ô cuối cùng trong danh sách được đặt là 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();

Các 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

`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 sẽ hiển thị trang tính đã chọn trừ phi trang tính đó thuộc 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]);

Các tham số

Tên	Loại	Nội dung mô tả
`sheet`	`Sheet`	Trang tính mới đang hoạt động.

Cầu thủ trả bóng

Sheet – trang tính đã được chuyển thành trang tính mới đang hoạt động

`setActiveSheet(sheet, restoreSelection)`

Đặt trang tính đang hoạt động trong một bảng tính, với tuỳ 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 sẽ hiển thị trang tính đã chọn trừ phi trang tính đó thuộc về một 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());

Các tham số

Tên	Loại	Nội dung mô tả
`sheet`	`Sheet`	Trang tính mới đang hoạt động.
`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 sẽ được chọn lại khi trang tính mới hoạt động; nếu `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 mớ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

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

Các tham số

Tên	Loại	Nội dung mô tả
`newActiveSpreadsheet`	`Spreadsheet`	Bảng tính sẽ được chuyển thành bảng tính hoạt động.

`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 được chọn, thì lựa chọn hiện tại 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, phương thức này sẽ gửi ra 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();

Các 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