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 | 스프레드시트의 이름입니다. |
리턴
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 | 스프레드시트의 열 수입니다. |
리턴
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()를 여러 번 호출합니다. 하지만 때로는 모든 URL이 대기 중인 변경 사항이 즉시 적용됩니다. 예를 들어 스크립트가 실행 중일 때 사용자에게 데이터를 표시하기 위해서입니다.
// 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()
스프레드시트의 활성 시트를 가져옵니다.
스프레드시트의 활성 시트는 스프레드시트에 표시되고 있는 시트입니다. 있습니다.
// 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()
getUi()
스크립트가 다음 작업을 수행할 수 있도록 하는 스프레드시트의 사용자 인터페이스 환경 인스턴스를 반환합니다. 메뉴, 대화상자 및 사이드바와 같은 기능을 추가할 수 있습니다. 스크립트는 스크립트가 스프레드시트에 바인딩된 경우에만 이 값을 반환합니다. 자세한 내용은 메뉴 및 대화상자 및 사이드바에 대한 가이드를 참조하세요.
// 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()); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
file | File | 열려는 파일입니다. |
리턴
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 | 스프레드시트의 고유 식별자입니다. |
리턴
Spreadsheet
: 지정된 ID의 스프레드시트 객체
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets
openByUrl(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());
매개변수
이름 | 유형 | 설명 |
---|---|---|
url | String | 스프레드시트의 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();
매개변수
이름 | 유형 | 설명 |
---|---|---|
range | Range | 활성 범위로 만들 범위입니다. |
리턴
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 | 선택할 범위 목록입니다. |
리턴
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 | 새 활성 시트입니다. |
리턴
Sheet
: 새 활성 시트로 만들어진 시트입니다.
setActiveSheet(sheet, restoreSelection)
가장 최근의 선택사항을 복원할 수 있는 옵션이 있는 스프레드시트의 활성 시트를 설정합니다. 해당 시트에 추가할 수 있습니다. 시트가 확인할 수 있습니다.
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 인 경우 새 시트입니다.
이(가) 현재 선택 항목을 변경하지 않고 활성화됩니다. |
리턴
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 | 현재 셀로 설정할 셀입니다. |
리턴
Range
: 새로 설정된 현재 셀
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets