Class SpreadsheetApp

SpreadsheetApp

Google Sheets 파일에 액세스하고 파일을 만들 수 있습니다. 이 클래스는 스프레드시트 서비스의 상위 클래스입니다.

속성

속성유형설명
AutoFillSeriesAutoFillSeries자동 입력 값을 계산하는 데 사용되는 계열 유형의 열거형입니다.
BandingThemeBandingTheme가능한 밴딩 테마의 열거형입니다.
BooleanCriteriaBooleanCriteria조건부 서식 불리언 기준의 열거형입니다.
BorderStyleBorderStyleRange에 테두리를 설정하는 유효한 스타일의 열거형입니다.
ColorTypeColorType가능한 색상 유형의 열거형입니다.
CopyPasteTypeCopyPasteType가능한 붙여넣기 유형을 열거합니다.
DataExecutionErrorCodeDataExecutionErrorCode가능한 데이터 실행 오류 코드를 열거합니다.
DataExecutionStateDataExecutionState가능한 데이터 실행 상태를 열거합니다.
DataSourceParameterTypeDataSourceParameterType가능한 데이터 소스 매개변수 유형의 열거형입니다.
DataSourceRefreshScopeDataSourceRefreshScope가능한 데이터 소스 새로고침 범위의 열거형입니다.
DataSourceTypeDataSourceType가능한 데이터 소스 유형을 열거합니다.
DataValidationCriteriaDataValidationCriteria범위에 설정할 수 있는 데이터 유효성 검사 기준을 나타내는 열거형입니다.
DateTimeGroupingRuleTypeDateTimeGroupingRuleType날짜 시간 그룹화 규칙의 열거형입니다.
DeveloperMetadataLocationTypeDeveloperMetadataLocationType가능한 개발자 메타데이터 위치 유형의 열거형입니다.
DeveloperMetadataVisibilityDeveloperMetadataVisibility가능한 개발자 메타데이터 표시 여부를 열거합니다.
DimensionDimension스프레드시트의 가능한 크기를 열거합니다.
DirectionDirection화살표 키를 사용하여 스프레드시트 내에서 이동할 수 있는 가능한 방향의 열거입니다.
FrequencyTypeFrequencyType가능한 빈도 유형의 열거형입니다.
GroupControlTogglePositionGroupControlTogglePosition그룹 컨트롤 토글이 있을 수 있는 위치의 열거형입니다.
InterpolationTypeInterpolationType조건부 형식 그라데이션 보간 유형을 열거합니다.
PivotTableSummarizeFunctionPivotTableSummarizeFunction피벗 테이블의 값을 요약하는 데 사용할 수 있는 함수의 열거형입니다.
PivotValueDisplayTypePivotValueDisplayType피벗 값을 표시할 수 있는 방식을 열거합니다.
ProtectionTypeProtectionType스프레드시트에서 편집 가능한 부분을 나타내는 열거형입니다.
RecalculationIntervalRecalculationInterval스프레드시트 다시 계산에 사용할 수 있는 간격의 열거입니다.
RelativeDateRelativeDate날짜 기반 BooleanCriteria에 사용할 값을 계산하기 위한 상대 날짜 옵션을 열거합니다.
SheetTypeSheetType스프레드시트에 있을 수 있는 다양한 유형의 시트를 열거합니다.
SortOrderSortOrder정렬 순서를 열거합니다.
TextDirectionTextDirection유효한 텍스트 방향의 열거형입니다.
TextToColumnsDelimiterTextToColumnsDelimiter텍스트를 열로 분할하기 위한 미리 설정된 구분 기호를 열거합니다.
ThemeColorTypeThemeColorType가능한 테마 색상 유형의 열거형입니다.
ValueTypeValueType스프레드시트 서비스의 Range 클래스에서 Range.getValue()Range.getValues()가 반환한 값 유형의 열거형입니다. 아래에 나열된 열거형 값은 Number, Boolean, Date 또는 String에 추가됩니다.
WrapStrategyWrapStrategy셀을 래핑하는 데 사용되는 전략의 열거형입니다.

방법

메서드반환 유형간략한 설명
create(name)Spreadsheet지정된 이름으로 새 스프레드시트를 만듭니다.
create(name, rows, columns)Spreadsheet지정된 이름과 지정된 수의 행과 열을 사용하여 새 스프레드시트를 만듭니다.
enableAllDataSourcesExecution()void모든 유형의 데이터 소스에 대해 데이터 실행을 사용 설정합니다.
enableBigQueryExecution()voidBigQuery 데이터 소스에 대한 데이터 실행을 사용 설정합니다.
flush()void대기 중인 모든 스프레드시트 변경사항을 적용합니다.
getActive()Spreadsheet현재 활성 스프레드시트를 반환하거나 없는 경우 null을 반환합니다.
getActiveRange()Range활성 시트에서 선택된 범위를 반환하거나 활성 범위가 없는 경우 null을 반환합니다.
getActiveRangeList()RangeList활성 시트의 활성 범위 목록을 반환하거나 선택된 범위가 없는 경우 null을 반환합니다.
getActiveSheet()Sheet스프레드시트의 활성 시트를 가져옵니다.
getActiveSpreadsheet()Spreadsheet현재 활성 스프레드시트를 반환하거나 없는 경우 null을 반환합니다.
getCurrentCell()Range활성 시트의 활성 범위 중 하나에서 선택된 현재 (강조표시된) 셀을 반환하거나 현재 셀이 없는 경우 null을 반환합니다.
getSelection()Selection스프레드시트의 현재 Selection를 반환합니다.
getUi()Ui스크립트가 메뉴, 대화상자, 사이드바와 같은 기능을 추가할 수 있도록 하는 스프레드시트의 사용자 인터페이스 환경 인스턴스를 반환합니다.
newCellImage()CellImageBuilderCellImage의 빌더를 만듭니다.
newColor()ColorBuilderColor의 빌더를 만듭니다.
newConditionalFormatRule()ConditionalFormatRuleBuilder조건부 서식 규칙을 위한 빌더를 만듭니다.
newDataSourceSpec()DataSourceSpecBuilderDataSourceSpec의 빌더를 만듭니다.
newDataValidation()DataValidationBuilder데이터 유효성 검사 규칙의 빌더를 만듭니다.
newFilterCriteria()FilterCriteriaBuilderFilterCriteria의 빌더를 만듭니다.
newRichTextValue()RichTextValueBuilder서식 있는 텍스트 값의 빌더를 만듭니다.
newTextStyle()TextStyleBuilder텍스트 스타일의 빌더를 만듭니다.
open(file)Spreadsheet지정된 파일 객체에 해당하는 스프레드시트를 엽니다.
openById(id)Spreadsheet지정된 ID로 스프레드시트를 엽니다.
openByUrl(url)Spreadsheet지정된 URL로 스프레드시트를 엽니다.
setActiveRange(range)Range지정된 범위를 active range로 설정하며, 범위의 왼쪽 상단 셀은 current cell입니다.
setActiveRangeList(rangeList)RangeList지정된 범위 목록을 active ranges로 설정합니다.
setActiveSheet(sheet)Sheet스프레드시트의 활성 시트를 설정합니다.
setActiveSheet(sheet, restoreSelection)Sheet스프레드시트의 활성 시트를 해당 시트 내에서 가장 최근에 선택한 항목을 복원하는 옵션과 함께 설정합니다.
setActiveSpreadsheet(newActiveSpreadsheet)void활성 스프레드시트를 설정합니다.
setCurrentCell(cell)Range지정된 셀을 current cell로 설정합니다.

자세한 문서

create(name)

지정된 이름으로 새 스프레드시트를 만듭니다.

// The code below creates a new spreadsheet "Finances" and logs the URL for it
var ssNew = SpreadsheetApp.create("Finances");
Logger.log(ssNew.getUrl());

매개변수

이름유형설명
nameString스프레드시트의 이름입니다.

리턴

Spreadsheet — 새 스프레드시트

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets

create(name, rows, columns)

지정된 이름과 지정된 수의 행과 열을 사용하여 새 스프레드시트를 만듭니다.

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

매개변수

이름유형설명
nameString스프레드시트의 이름입니다.
rowsInteger스프레드시트의 행 수입니다.
columnsInteger스프레드시트의 열 수입니다.

리턴

Spreadsheet — 새 스프레드시트

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets

enableAllDataSourcesExecution()

모든 유형의 데이터 소스에 대해 데이터 실행을 사용 설정합니다.

데이터 소스 유형이 사용 설정되지 않은 경우 데이터 실행 시 예외가 발생합니다. 모든 데이터 소스 유형에 대해 데이터 실행을 사용 설정하려면 이 메서드를 사용하세요.

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

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

enableBigQueryExecution()

BigQuery 데이터 소스에 대한 데이터 실행을 사용 설정합니다.

사용 설정하지 않으면 BigQuery 데이터 소스의 데이터 실행에서 예외가 발생합니다.

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

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

flush()

대기 중인 모든 스프레드시트 변경사항을 적용합니다.

Range.getValue()를 여러 번 호출하는 경우와 같이 성능 향상을 위해 스프레드시트 작업이 함께 번들로 묶인 경우도 있습니다. 하지만 스크립트가 실행되는 동안 사용자 데이터를 표시하기 위해 대기 중인 모든 변경사항이 즉시 적용되도록 해야 하는 경우도 있습니다.

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

현재 활성 스프레드시트를 반환하거나 없는 경우 null을 반환합니다.

스프레드시트의 컨텍스트에서 실행되는 함수는 이 함수를 호출하여 해당 스프레드시트 객체에 대한 참조를 가져올 수 있습니다.

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActive().getUrl());

리턴

Spreadsheet - 활성 스프레드시트 객체

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveRange()

활성 시트에서 선택된 범위를 반환하거나 활성 범위가 없는 경우 null을 반환합니다. 여러 범위가 선택된 경우 이 메서드는 마지막으로 선택한 범위만 반환합니다.

일반적으로 사용자가 활성 시트에서 선택한 범위를 의미하지만 맞춤 함수에서는 적극적으로 다시 계산 중인 셀을 나타냅니다.

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

리턴

Range - 활성 범위입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveRangeList()

활성 시트의 활성 범위 목록을 반환하거나 선택된 범위가 없는 경우 null을 반환합니다. 현재 강조표시된 셀을 포함하는 활성 범위가 목록의 마지막에 배치됩니다.

단일 범위를 선택한 경우 getActiveRange() 호출처럼 작동합니다.

// Returns the list of active ranges.
var rangeList = SpreadsheetApp.getActiveRangeList();

리턴

RangeList - 활성 범위 목록

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveSheet()

스프레드시트의 활성 시트를 가져옵니다.

스프레드시트의 활성 시트는 스프레드시트 UI에 표시되는 시트입니다.

// The code below logs the name of the active sheet.
Logger.log(SpreadsheetApp.getActiveSheet().getName());

리턴

Sheet - 활성 시트 객체

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveSpreadsheet()

현재 활성 스프레드시트를 반환하거나 없는 경우 null을 반환합니다.

스프레드시트의 컨텍스트에서 실행되는 함수는 이 함수를 호출하여 상응하는 Spreadsheet 객체에 대한 참조를 가져올 수 있습니다.

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getUrl());

리턴

Spreadsheet - 활성 스프레드시트 객체

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getCurrentCell()

활성 시트의 활성 범위 중 하나에서 선택된 현재 (강조표시된) 셀을 반환하거나 현재 셀이 없는 경우 null을 반환합니다.

// Returns the current highlighted cell in the one of the active ranges.
var currentCell = SpreadsheetApp.getCurrentCell();

리턴

Range — 현재 셀

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSelection()

스프레드시트의 현재 Selection를 반환합니다.

var selection = SpreadsheetApp.getSelection();
var currentCell = selection.getCurrentCell();

리턴

Selection: 현재 선택 항목

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getUi()

스크립트가 메뉴, 대화상자, 사이드바와 같은 기능을 추가할 수 있도록 하는 스프레드시트의 사용자 인터페이스 환경 인스턴스를 반환합니다. 스크립트는 열려 있는 스프레드시트의 현재 인스턴스를 위한, 그리고 스크립트가 스프레드시트에 바인드된 경우에만 UI와 상호작용할 수 있습니다. 자세한 내용은 메뉴대화상자 및 사이드바 가이드를 참고하세요.

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

리턴

Ui: 이 스프레드시트의 사용자 인터페이스 환경의 인스턴스입니다.


newCellImage()

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

리턴

CellImageBuilder - 새 빌더입니다.


newColor()

Color의 빌더를 만듭니다.

var rgbColor = SpreadsheetApp.newColor().setRgbColor("#FF0000").build();

리턴

ColorBuilder - 새 빌더입니다.


newConditionalFormatRule()

조건부 서식 규칙을 위한 빌더를 만듭니다.

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

리턴

ConditionalFormatRuleBuilder: 새 빌더입니다.


newDataSourceSpec()

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

리턴

DataSourceSpecBuilder - 새 빌더입니다.


newDataValidation()

데이터 유효성 검사 규칙의 빌더를 만듭니다.

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

리턴

DataValidationBuilder - 새 빌더입니다.


newFilterCriteria()

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

리턴

FilterCriteriaBuilder — 새 빌더


newRichTextValue()

서식 있는 텍스트 값의 빌더를 만듭니다.

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

리턴

RichTextValueBuilder - 새 빌더입니다.


newTextStyle()

텍스트 스타일의 빌더를 만듭니다.

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

리턴

TextStyleBuilder - 새 빌더입니다.


open(file)

지정된 파일 객체에 해당하는 스프레드시트를 엽니다.

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

매개변수

이름유형설명
fileFile열려는 파일입니다.

리턴

Spreadsheet: 스프레드시트

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets

openById(id)

지정된 ID로 스프레드시트를 엽니다. 스프레드시트 ID는 URL에서 추출할 수 있습니다. 예를 들어 URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0의 스프레드시트 ID는 '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());

매개변수

이름유형설명
idString스프레드시트의 고유 식별자입니다.

리턴

Spreadsheet - 지정된 ID가 있는 스프레드시트 객체

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets

openByUrl(url)

지정된 URL로 스프레드시트를 엽니다. URL이 존재하지 않거나 사용자에게 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());

매개변수

이름유형설명
urlString스프레드시트의 URL입니다.

리턴

Spreadsheet - 지정된 URL이 있는 스프레드시트 객체입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets

setActiveRange(range)

지정된 범위를 active range로 설정하며, 범위의 왼쪽 상단 셀은 current cell입니다.

스프레드시트 UI가 선택한 범위가 포함된 시트를 표시하고 선택된 범위에 정의된 셀을 선택합니다.

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

매개변수

이름유형설명
rangeRange활성 범위로 만들 범위입니다.

리턴

Range - 새 활성 범위


setActiveRangeList(rangeList)

지정된 범위 목록을 active ranges로 설정합니다. 목록의 마지막 범위는 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();

매개변수

이름유형설명
rangeListRangeList선택할 범위 목록입니다.

리턴

RangeList - 새로 선택한 범위 목록입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setActiveSheet(sheet)

스프레드시트의 활성 시트를 설정합니다. 시트가 다른 스프레드시트에 속하지 않는 한 Google Sheets UI는 선택된 시트를 표시합니다.

// The code below makes the 2nd sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);

매개변수

이름유형설명
sheetSheet새 활성 시트입니다.

리턴

Sheet: 새 활성 시트가 된 시트


setActiveSheet(sheet, restoreSelection)

스프레드시트의 활성 시트를 해당 시트 내에서 가장 최근에 선택한 항목을 복원하는 옵션과 함께 설정합니다. 시트가 다른 스프레드시트에 속하지 않는 한 Google Sheets UI는 선택된 시트를 표시합니다.

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

매개변수

이름유형설명
sheetSheet새 활성 시트입니다.
restoreSelectionBooleantrue인 경우 새 시트가 활성화될 때 새 활성 시트의 가장 최근 선택 항목이 다시 선택됩니다. false인 경우 현재 선택 항목을 변경하지 않고 새 시트가 활성화됩니다.

리턴

Sheet: 새 활성 시트

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setActiveSpreadsheet(newActiveSpreadsheet)

활성 스프레드시트를 설정합니다.

// The code below makes the spreadsheet with key "1234567890" the active spreadsheet
var ss = SpreadsheetApp.openById("1234567890");
SpreadsheetApp.setActiveSpreadsheet(ss);

매개변수

이름유형설명
newActiveSpreadsheetSpreadsheet활성 스프레드시트로 만들 스프레드시트입니다.

setCurrentCell(cell)

지정된 셀을 current cell로 설정합니다.

지정된 셀이 이미 선택한 범위에 있으면 해당 범위는 셀이 현재 셀인 활성 범위가 됩니다.

지정된 셀이 선택한 범위에 없으면 기존 선택 항목이 삭제되고 셀이 현재 셀 및 활성 범위가 됩니다.

참고: 지정된 Range는 하나의 셀로 구성되어야 합니다. 그러지 않으면 이 메서드가 예외가 발생합니다.

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

매개변수

이름유형설명
cellRange현재 셀로 설정할 셀입니다.

리턴

Range - 새로 설정된 현재 셀

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets