Class SpreadsheetApp

SpreadsheetApp

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ínhLoạiMô tả
AutoFillSeriesAutoFillSeriesBả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.
BandingThemeBandingThemeBảng liệt kê các giao diện dải có thể có.
BooleanCriteriaBooleanCriteriaBảng liệt kê các tiêu chí boolean định dạng có điều kiện.
BorderStyleBorderStyleBảng liệt kê các kiểu hợp lệ để đặt đường viền trên Range.
ColorTypeColorTypeBảng liệt kê các loại màu có thể sử dụng.
CopyPasteTypeCopyPasteTypeBảng liệt kê các kiểu dán có thể có.
DataExecutionErrorCodeDataExecutionErrorCodeBảng liệt kê các mã lỗi thực thi dữ liệu có thể xảy ra.
DataExecutionStateDataExecutionStateBảng liệt kê các trạng thái thực thi dữ liệu có thể có.
DataSourceParameterTypeDataSourceParameterTypeBảng liệt kê các loại tham số nguồn dữ liệu có thể có.
DataSourceRefreshScopeDataSourceRefreshScopeBảng liệt kê các phạm vi có thể làm mới nguồn dữ liệu.
DataSourceTypeDataSourceTypeBảng liệt kê các loại nguồn dữ liệu có thể có.
DataValidationCriteriaDataValidationCriteriaMộ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 ô.
DateTimeGroupingRuleTypeDateTimeGroupingRuleTypeBảng liệt kê quy tắc nhóm ngày giờ.
DeveloperMetadataLocationTypeDeveloperMetadataLocationTypeLiệt kê các loại vị trí siêu dữ liệu nhà phát triển có thể có.
DeveloperMetadataVisibilityDeveloperMetadataVisibilityBảng liệt kê các nội dung có thể hiển thị siêu dữ liệu nhà phát triển.
DimensionDimensionBảng liệt kê các kích thước có thể có trong bảng tính.
DirectionDirectionBả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á.
FrequencyTypeFrequencyTypeBảng liệt kê các loại tần suất có thể có.
GroupControlTogglePositionGroupControlTogglePositionBả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ó.
InterpolationTypeInterpolationTypeBảng liệt kê các kiểu nội suy chuyển màu theo định dạng có điều kiện.
PivotTableSummarizeFunctionPivotTableSummarizeFunctionBả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.
PivotValueDisplayTypePivotValueDisplayTypeBảng liệt kê các cách hiển thị giá trị tổng hợp.
ProtectionTypeProtectionTypeMộ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.
RecalculationIntervalRecalculationIntervalBả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.
RelativeDateRelativeDateBả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.
SheetTypeSheetTypeBả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.
SortOrderSortOrderBảng liệt kê thứ tự sắp xếp.
TextDirectionTextDirectionBảng liệt kê các hướng văn bản hợp lệ.
TextToColumnsDelimiterTextToColumnsDelimiterBả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.
ThemeColorTypeThemeColorTypeBảng liệt kê các loại màu giao diện có thể có.
ValueTypeValueTypeLiệt kê các loại giá trị do Range.getValue()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.
WrapStrategyWrapStrategyBảng liệt kê các chiến lược dùng để gói ô.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
create(name)SpreadsheetTạo bảng tính mới có tên đã cho.
create(name, rows, columns)SpreadsheetTạ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()voidBật chế độ thực thi dữ liệu cho tất cả các loại nguồn dữ liệu.
enableBigQueryExecution()voidBật tính năng thực thi dữ liệu cho nguồn dữ liệu BigQuery.
enableLookerExecution()voidBật tính năng thực thi dữ liệu cho nguồn dữ liệu Looker.
flush()voidÁp dụng tất cả các thay đổi đang chờ xử lý trên bảng tính.
getActive()SpreadsheetTrả về bảng tính đang hoạt động hoặc null nếu không có bảng tính nào.
getActiveRange()RangeTrả 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()RangeListTrả 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()SheetLấy trang tính đang hoạt động trong bảng tính.
getActiveSpreadsheet()SpreadsheetTrả về bảng tính đang hoạt động hoặc null nếu không có bảng tính nào.
getCurrentCell()RangeTrả 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()SelectionTrả về Selection hiện tại trong bảng tính.
getUi()UiTrả 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()CellImageBuilderTạo trình tạo cho CellImage.
newColor()ColorBuilderTạo trình tạo cho Color.
newConditionalFormatRule()ConditionalFormatRuleBuilderTạo trình tạo cho quy tắc định dạng có điều kiện.
newDataSourceSpec()DataSourceSpecBuilderTạo trình tạo cho DataSourceSpec.
newDataValidation()DataValidationBuilderTạo trình tạo cho quy tắc xác thực dữ liệu.
newFilterCriteria()FilterCriteriaBuilderTạo trình tạo cho FilterCriteria.
newRichTextValue()RichTextValueBuilderTạo một trình tạo giá trị Văn bản đa dạng thức.
newTextStyle()TextStyleBuilderTạo trình tạo cho kiểu văn bản.
open(file)SpreadsheetMở bảng tính tương ứng với đối tượng Tệp đã cho.
openById(id)SpreadsheetMở bảng tính bằng mã nhận dạng đã cho.
openByUrl(url)SpreadsheetMở 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)RangeListThiế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());

Thông số

TênLoạiMô tả
nameStringTê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());

Thông số

TênLoạiMô tả
nameStringTên cho bảng tính.
rowsIntegerSố hàng của bảng tính.
columnsIntegerSố 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

enableLookerExecution()

Bật tính năng thực thi dữ liệu cho nguồn dữ liệu Looker.

Tính năng thực thi dữ liệu cho nguồn dữ liệu Looker sẽ gửi một ngoại lệ nếu không được bật.

// Turns data execution on for Looker data sources.
SpreadsheetApp.enableLookerExecution();

// 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 associated Looker
// data.
ss.getDataSourceSheets()[0].refreshData();

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

Thông số

TênLoạiMô tả
fileFileTệ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. Để 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());

Thông số

TênLoạiMô tả
idStringGiá 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ệ 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());

Thông số

TênLoạiMô tả
urlStringURL 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();

Thông số

TênLoạiMô tả
rangeRangeDả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();

Thông số

TênLoạiMô tả
rangeListRangeListDanh 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]);

Thông số

TênLoạiMô tả
sheetSheetTrang 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 đang 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());

Thông số

TênLoạiMô tả
sheetSheetTrang tính đang hoạt động mới.
restoreSelectionBooleanNế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 mớ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

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

Thông số

TênLoạiMô tả
newActiveSpreadsheetSpreadsheetBả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();

Thông số

TênLoạiMô tả
cellRangeÔ 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