Class SpreadsheetApp

스프레드시트 앱

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

속성

속성	유형	설명
AutoFillSeries	AutoFillSeries	자동 입력 값을 계산하는 데 사용되는 계열 유형의 열거형입니다.
BandingTheme	BandingTheme	가능한 밴딩 테마의 열거형입니다.
BooleanCriteria	BooleanCriteria	조건부 서식 부울 기준의 열거형입니다.
BorderStyle	BorderStyle	Range에 테두리를 설정하는 유효한 스타일의 열거형입니다.
ColorType	ColorType	가능한 색상 유형의 열거형입니다.
CopyPasteType	CopyPasteType	가능한 붙여넣기 유형의 열거형입니다.
DataExecutionErrorCode	DataExecutionErrorCode	가능한 데이터 실행 오류 코드의 열거형입니다.
DataExecutionState	DataExecutionState	가능한 데이터 실행 상태의 열거형입니다.
DataSourceParameterType	DataSourceParameterType	가능한 데이터 소스 매개변수 유형의 열거형입니다.
DataSourceRefreshScope	DataSourceRefreshScope	가능한 데이터 소스 새로고침 범위의 열거형입니다.
DataSourceType	DataSourceType	가능한 데이터 소스 유형의 열거형입니다.
DataValidationCriteria	DataValidationCriteria	범위에서 설정할 수 있는 데이터 유효성 검사 기준을 나타내는 열거형입니다.
DateTimeGroupingRuleType	DateTimeGroupingRuleType	날짜 시간 그룹화 규칙의 열거형
DeveloperMetadataLocationType	DeveloperMetadataLocationType	가능한 개발자 메타데이터 위치 유형의 열거형입니다.
DeveloperMetadataVisibility	DeveloperMetadataVisibility	가능한 개발자 메타데이터의 열거형입니다.
Dimension	Dimension	스프레드시트에서 사용할 수 있는 측정기준의 열거형입니다.
Direction	Direction	화살표 키를 사용하여 스프레드시트 내에서 이동할 수 있는 가능한 경로의 열거형입니다.
FrequencyType	FrequencyType	가능한 주파수 유형의 열거형입니다.
GroupControlTogglePosition	GroupControlTogglePosition	그룹 컨트롤 전환이 있을 수 있는 위치의 열거형입니다.
InterpolationType	InterpolationType	조건부 서식 그라데이션 보간 유형 열거형입니다.
PivotTableSummarizeFunction	PivotTableSummarizeFunction	피벗 테이블의 값을 요약하는 데 사용할 수 있는 함수의 열거형입니다.
PivotValueDisplayType	PivotValueDisplayType	피봇 값이 표시되는 방식의 열거형입니다.
ProtectionType	ProtectionType	수정으로부터 보호할 수 있는 스프레드시트에서 부분을 나타내는 열거형입니다.
RecalculationInterval	RecalculationInterval	스프레드시트 다시 계산에 사용할 수 있는 간격의 열거형입니다.
RelativeDate	RelativeDate	날짜 기반 BooleanCriteria에 사용할 값을 계산하는 상대 날짜 옵션의 열거형입니다.
SheetType	SheetType	스프레드시트에 존재할 수 있는 여러 유형의 시트가 열거되어 있습니다.
SortOrder	SortOrder	정렬 순서의 열거형입니다.
TextDirection	TextDirection	유효한 텍스트 방향의 열거형입니다.
TextToColumnsDelimiter	TextToColumnsDelimiter	텍스트를 열로 분할하기 위한 미리 설정된 구분 기호의 열거형입니다.
ThemeColorType	ThemeColorType	가능한 테마 색상 유형의 열거형입니다.
ValueType	ValueType	스프레드시트 서비스의 Range 클래스에서 Range.getValue()와 Range.getValues()가 반환하는 값 유형의 열거형입니다. 아래에 나열된 열거형 값은 Number, Boolean, Date, String에 추가됩니다.
WrapStrategy	WrapStrategy	셀을 래핑하는 데 사용되는 전략의 열거형입니다.

메서드

메서드	반환 유형	간략한 설명
create(name)	Spreadsheet	지정된 이름으로 새 스프레드시트를 만듭니다.
create(name, rows, columns)	Spreadsheet	지정된 이름 및 지정된 수의 행과 열로 새 스프레드시트를 만듭니다.
enableAllDataSourcesExecution()	void	모든 유형의 데이터 소스에 대한 데이터 실행을 사용 설정합니다.
enableBigQueryExecution()	void	BigQuery 데이터 소스에 대한 데이터 실행을 사용 설정합니다.
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()	CellImageBuilder	CellImage의 빌더를 만듭니다.
newColor()	ColorBuilder	Color의 빌더를 만듭니다.
newConditionalFormatRule()	ConditionalFormatRuleBuilder	조건부 서식 규칙의 빌더를 만듭니다.
newDataSourceSpec()	DataSourceSpecBuilder	DataSourceSpec의 빌더를 만듭니다.
newDataValidation()	DataValidationBuilder	데이터 검증 규칙을 위한 빌더를 만듭니다.
newFilterCriteria()	FilterCriteriaBuilder	FilterCriteria의 빌더를 만듭니다.
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());

매개변수

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

Return

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

매개변수

이름	유형	설명
name	String	스프레드시트의 이름입니다.
rows	Integer	스프레드시트의 행 수입니다.
columns	Integer	스프레드시트의 열 수입니다.

Return

Spreadsheet: 새 스프레드시트

승인

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

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

---

enableAllDataSourcesExecution()

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

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

승인

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

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

---

enableBigQueryExecution()

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

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

승인

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

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

Return

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

Return

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

Return

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

Return

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

Return

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

Return

Range: 현재 셀

승인

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

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

---

getSelection()

스프레드시트에서 현재 Selection을 반환합니다.

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

Return

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

Return

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

---

newCellImage()

CellImage의 빌더를 만듭니다.

Return

CellImageBuilder — 새 빌더입니다.

---

newColor()

Color의 빌더를 만듭니다.

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

Return

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

Return

ConditionalFormatRuleBuilder — 새 빌더입니다.

---

newDataSourceSpec()

DataSourceSpec의 빌더를 만듭니다.

Return

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

Return

DataValidationBuilder — 새 빌더입니다.

---

newFilterCriteria()

FilterCriteria의 빌더를 만듭니다.

Return

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

Return

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

Return

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

매개변수

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

Return

Spreadsheet — 스프레드시트

승인

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

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

---

openById(id)

해당 ID로 스프레드시트를 엽니다. URL에서 스프레드시트 ID를 추출할 수 있습니다. 예를 들어 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());

매개변수

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

Return

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

승인

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

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

---

openByUrl(url)

주어진 URL의 스프레드시트를 엽니다. URL이 존재하지 않거나 사용자에게 URL에 액세스할 권한이 없는 경우 스크립팅 예외가 발생합니다.

// 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.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc1234567/edit');
Logger.log(ss.getName());

매개변수

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

Return

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

승인

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

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

매개변수

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

Return

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

매개변수

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

Return

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

매개변수

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

Return

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

매개변수

이름	유형	설명
sheet	Sheet	새 활성 시트입니다.
restoreSelection	Boolean	true인 경우 새 시트가 활성화되면 가장 최근에 선택한 새 활성 시트가 다시 선택됩니다. false인 경우 현재 선택 항목을 변경하지 않고 새 시트가 활성화됩니다.

Return

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

매개변수

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

---

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

매개변수

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

Return

Range: 새로 설정된 현재 셀

승인

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

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