Google Sheets 파일에 액세스하고 파일을 수정합니다. 일반적인 작업은 새 시트 추가 및 있습니다.
메서드
자세한 문서
addDeveloperMetadata(key)
지정된 키를 가진 개발자 메타데이터를 최상위 스프레드시트에 추가합니다.
// 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'); // Adds the key 'NAME' in the developer metadata for the spreadsheet. ss.addDeveloperMetadata('NAME') // Gets the first developer metadata object and logs its key. const developerMetaData = ss.getDeveloperMetadata()[0] console.log(developerMetaData.getKey())
매개변수
이름 | 유형 | 설명 |
---|---|---|
key | String | 새 개발자 메타데이터의 키입니다. |
리턴
Spreadsheet
- 이 스프레드시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
지정된 키와 공개 상태가 포함된 개발자 메타데이터를 스프레드시트에 추가합니다.
// 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'); // Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility // to the developer project that created the metadata. ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the first developer metadata object and logs its key and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, . Visibility: ${developerMetaData.getVisibility()}`);
매개변수
이름 | 유형 | 설명 |
---|---|---|
key | String | 새 개발자 메타데이터의 키입니다. |
visibility | DeveloperMetadataVisibility | 새 개발자 메타데이터의 공개 상태입니다. |
리턴
Spreadsheet
- 이 스프레드시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
지정된 키와 값이 포함된 개발자 메타데이터를 스프레드시트에 추가합니다.
// 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'); // Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the // spreadsheet. ss.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the first developer metadata object and logs its key and value. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);
매개변수
이름 | 유형 | 설명 |
---|---|---|
key | String | 새 개발자 메타데이터의 키입니다. |
value | String | 새 개발자 메타데이터의 값입니다. |
리턴
Spreadsheet
- 이 스프레드시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
지정된 키, 값, 공개 상태가 포함된 개발자 메타데이터를 스프레드시트에 추가합니다.
// 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'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to any developer project with document access. ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the first developer metadata object and logs its key, value, and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}, Visibility: ${developerMetaData.getVisibility()}`);
매개변수
이름 | 유형 | 설명 |
---|---|---|
key | String | 새 개발자 메타데이터의 키입니다. |
value | String | 새 개발자 메타데이터의 값입니다. |
visibility | DeveloperMetadataVisibility | 새 개발자 메타데이터의 공개 상태입니다. |
리턴
Spreadsheet
- 이 스프레드시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditor(emailAddress)
지정된 사용자를 Spreadsheet
의 편집자 목록에 추가합니다. 사용자가 이미
를 지정하면 뷰어 목록에서 사용자를 벗어나게 됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
emailAddress | String | 추가할 사용자의 이메일 주소입니다. |
리턴
Spreadsheet
: 이 Spreadsheet
는 체이닝을 위한 것입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditor(user)
지정된 사용자를 Spreadsheet
의 편집자 목록에 추가합니다. 사용자가 이미
를 지정하면 뷰어 목록에서 사용자를 벗어나게 됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
user | User | 추가할 사용자의 표현입니다. |
리턴
Spreadsheet
: 이 Spreadsheet
는 체이닝을 위한 것입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditors(emailAddresses)
지정된 사용자 배열을 Spreadsheet
의 편집자 목록에 추가합니다. 만약
사용자가 이미 뷰어 목록에 있는 경우 이 방법을 사용하면
시청자
매개변수
이름 | 유형 | 설명 |
---|---|---|
emailAddresses | String[] | 추가할 사용자의 이메일 주소 배열입니다. |
리턴
Spreadsheet
: 이 Spreadsheet
는 체이닝을 위한 것입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addMenu(name, subMenus)
스프레드시트 UI에 새 메뉴를 만듭니다.
각 메뉴 항목은 사용자 정의 함수를 실행합니다. 일반적으로 스프레드시트가 로드될 때 메뉴가 자동으로 생성되도록 onOpen()
함수에서 호출하려고 합니다.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is // executed. menuEntries.push({name: "Menu Entry 1", functionName: "function1"}); menuEntries.push(null); // line separator menuEntries.push({name: "Menu Entry 2", functionName: "function2"}); ss.addMenu("addMenuExample", menuEntries); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 생성할 메뉴의 이름입니다. |
subMenus | Object[] | name 및 functionName
매개변수가 있는 JavaScript 지도의 배열. 포함된 라이브러리의 함수(예:
Library.libFunction1 )를 사용할 수 있습니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewer(emailAddress)
지정된 사용자를 Spreadsheet
의 뷰어 목록에 추가합니다. 사용자가 이미
이 메서드는 효과가 없습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
emailAddress | String | 추가할 사용자의 이메일 주소입니다. |
리턴
Spreadsheet
: 이 Spreadsheet
는 체이닝을 위한 것입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewer(user)
지정된 사용자를 Spreadsheet
의 뷰어 목록에 추가합니다. 사용자가 이미
이 메서드는 효과가 없습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
user | User | 추가할 사용자의 표현입니다. |
리턴
Spreadsheet
: 이 Spreadsheet
는 체이닝을 위한 것입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewers(emailAddresses)
지정된 사용자 배열을 Spreadsheet
의 뷰어 목록에 추가합니다. 만약
사용자가 이미 편집자 목록에 있으면 이 방법은 아무런 영향을 미치지 않습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
emailAddresses | String[] | 추가할 사용자의 이메일 주소 배열입니다. |
리턴
Spreadsheet
: 이 Spreadsheet
는 체이닝을 위한 것입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
시트의 현재 데이터 영역 하단에 행을 추가합니다. 셀의 내용이
=
이면 수식으로 해석됩니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowContents | Object[] | 시트의 마지막 행 뒤에 삽입할 값의 배열. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
지정된 열의 너비를 콘텐츠에 맞게 설정합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnPosition | Integer | 크기를 조절할 지정된 열의 위치입니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy(name)
스프레드시트를 복사하고 새 스프레드시트를 반환합니다.
// This code makes a copy of the current spreadsheet and names it appropriately var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.copy("Copy of " + ss.getName());
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 사본의 이름입니다. |
리턴
Spreadsheet
- 이 스프레드시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
범위 내에서 개발자 메타데이터를 찾기 위해 DeveloperMetadataFinder
를 반환합니다.
이 스프레드시트에 나와 있습니다. 기본적으로 스프레드시트와 연결된 모든 메타데이터를 고려하며
행, 열입니다.
// 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'); // Adds developer metadata to the spreadsheet. ss.addDeveloperMetadata('NAME', 'CHARLIE'); ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION'); ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT'); // Creates a developer metadata finder. const developerMetadataFinder = ss.createDeveloperMetadataFinder(); // Finds the developer metadata objects with 'COMPANY' as the key. const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find(); // Gets the first result of developer metadata that has the key 'COMPANY' and logs its value. console.log(googleMetadataFromSpreadsheet[0].getValue());
리턴
DeveloperMetadataFinder
- 이 스프레드시트의 범위에서 메타데이터를 검색하기 위한 개발자 메타데이터 파인더입니다.
createTextFinder(findText)
스프레드시트용 텍스트 검색기를 만들어 내부에서 텍스트를 찾고 바꾸는 데 사용할 수 있습니다. 있습니다. 스프레드시트의 첫 번째 시트에서 검색이 시작됩니다.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Creates a text finder. var textFinder = spreadsheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the spreadsheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
매개변수
이름 | 유형 | 설명 |
---|---|---|
findText | String | 검색할 텍스트입니다. |
리턴
TextFinder
- 스프레드시트의 TextFinder
입니다.
deleteActiveSheet()
현재 활성 시트를 삭제합니다.
// The code below deletes the currently active sheet and stores the new active sheet in a // variable var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();
리턴
Sheet
- 새 활성 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumn(columnPosition)
지정된 열 위치에서 열을 삭제합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnPosition | Integer | 열의 위치로, 첫 번째 열의 경우 1부터 시작합니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
지정된 열 위치에서 시작하는 여러 열을 삭제합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnPosition | Integer | 삭제할 첫 번째 열의 위치입니다. |
howMany | Integer | 삭제할 열의 수입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
지정된 행 위치에서 행을 삭제합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowPosition | Integer | 행의 위치로, 첫 번째 행의 경우 1부터 시작합니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
지정된 행 위치에서 시작하는 여러 행을 삭제합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowPosition | Integer | 삭제할 첫 번째 행의 위치입니다. |
howMany | Integer | 삭제할 행 수입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteSheet(sheet)
지정된 시트를 삭제합니다.
// The code below deletes the specified sheet. var ss = SpreadsheetApp.getActive(); var sheet = ss.getSheetByName('My Sheet'); ss.deleteSheet(sheet);
매개변수
이름 | 유형 | 설명 |
---|---|---|
sheet | Sheet | 삭제할 시트입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
duplicateActiveSheet()
활성 시트를 복제하여 활성 시트로 만듭니다.
// The code below makes a duplicate of the active sheet SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();
리턴
Sheet
- 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
이 시트의 활성 셀을 반환합니다.
참고: 현재 값을 반환하는 getCurrentCell()
를 사용하는 것이 좋습니다.
강조표시됩니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
리턴
Range
: 현재 활성 셀
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRange()
활성 시트에서 선택된 범위를 반환하거나 활성 범위가 없는 경우 null
를 반환합니다. 만약
여러 범위를 선택하면 마지막으로 선택한 범위만 반환됩니다.
'활성 범위'라는 용어 는 사용자가 활성 시트에서 선택한 범위를 나타냅니다. 그러나 사용자 지정 함수에서는 다시 계산되는 셀을 참조합니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
리턴
Range
: 활성 범위
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
참고 항목
getActiveRangeList()
활성 시트의 활성 범위 목록을 반환하거나 활성 범위가 없는 경우 null
를 반환합니다.
확인할 수 있습니다
단일 범위를 선택하면 getActiveRange()
호출처럼 작동합니다.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
리턴
RangeList
- 활성 범위 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
참고 항목
getActiveSheet()
스프레드시트의 활성 시트를 가져옵니다.
스프레드시트의 활성 시트는 스프레드시트에 표시되고 있는 시트입니다. 있습니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
리턴
Sheet
- 스프레드시트의 활성 시트입니다.
getAs(contentType)
이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. 이 메서드는 파일 이름에 적절한 확장자를 추가합니다(예: 'myfile.pdf'). 하지만 파일 이름에서 마지막 마침표 뒤에 오는 부분 (있는 경우)이 기존 교체해야 합니다. 따라서 'ShoppingList.12.25.2014' 위 이름이 아래와 같이 변경됩니다. 'ShoppingList.12.25.pdf'
전환수의 일일 할당량을 보려면 Google '서비스'로 이동합니다. 새로 생성된 Google Workspace 도메인에는 일시적으로 더 엄격한 정책이 적용될 수 있습니다. 할당량도 제공합니다
매개변수
이름 | 유형 | 설명 |
---|---|---|
contentType | String | 변환할 MIME 유형입니다. 대부분의 blob에서 'application/pdf' 는 다음과 같습니다.
유일하게 유효한 옵션입니다. BMP, GIF, JPEG, PNG 형식의 이미지인 경우 'image/bmp' , 'image/gif' , 'image/jpeg' , 'image/png' 중 어느 것이든 해당됩니다.
유효한지 확인합니다. Google Docs 문서의 경우 'text/markdown' 도 유효합니다. |
리턴
Blob
- blob 형식의 데이터입니다.
getBandings()
이 스프레드시트의 모든 밴딩을 반환합니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 an array of the bandings in the spreadsheet. const bandings = ss.getBandings(); // Logs the range of the first banding in the spreadsheet to the console. console.log(bandings[0].getRange().getA1Notation());
리턴
Banding[]
- 이 스프레드시트의 밴딩입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBlob()
getColumnWidth(columnPosition)
지정된 열의 너비(픽셀 단위)를 가져옵니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnPosition | Integer | 검토할 열의 위치입니다. |
리턴
Integer
— 열 너비(픽셀)
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
활성 시트의 현재 셀을 반환하거나 현재 셀이 없는 경우 null
를 반환합니다. 이
현재 셀은 Google Sheets UI에서 포커스가 있으며 어두운 색으로 강조 표시된 셀입니다.
테두리를 추가하는 것입니다. 현재 셀은 두 개 이상 없습니다. 사용자가 하나 이상의 셀 범위를 선택하면
현재 셀입니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
리턴
Range
— 현재 셀
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
데이터가 있는 측정기준에 해당하는 Range
를 반환합니다.
이는 A1로 제한된 범위를 만드는 것과 기능적으로 동일하고 (Sheet.getLastColumn(), Sheet.getLastRow()).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
리턴
Range
: 스프레드시트의 모든 데이터로 구성된 범위
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
모든 데이터 소스 수식을 가져옵니다.
// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets // file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source formulas on Sheet1. // To get an array of data source formulas for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceFormulas = sheet.getDataSourceFormulas(); // Logs the first data source formula in the array. console.log(dataSourceFormulas[0].getFormula());
리턴
DataSourceFormula[]
- 데이터 소스 수식의 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
모든 데이터 소스 피벗 테이블을 가져옵니다.
// 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 Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source pivot tables on Sheet1. // To get an array of data source pivot tables for the entire // spreadsheet, replace 'sheet' with 'ss'. const dataSourcePivotTables = sheet.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
리턴
DataSourcePivotTable[]
- 데이터 소스 피벗 테이블의 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceRefreshSchedules()
이 스프레드시트의 새로고침 일정을 가져옵니다.
// 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'); // Activates BigQuery operations for the connected spreadsheet. SpreadsheetApp.enableBigQueryExecution(); // Gets the frequency type of the first referesh schedule in the array. const frequencyType = ss.getDataSourceRefreshSchedules()[0] .getFrequency() .getFrequencyType() .toString(); // Logs the frequency type to the console. console.log(frequencyType);
리턴
DataSourceRefreshSchedule[]
- 이 스프레드시트의 새로고침 일정입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceSheets()
스프레드시트의 모든 데이터 소스 시트를 반환합니다.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the first data source sheet in the spreadsheet. const dataSource = ss.getDataSourceSheets()[0]; // Gets the name of the data source sheet. console.log(dataSource.asSheet().getName());
리턴
DataSourceSheet[]
- 모든 데이터 소스 시트의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
모든 데이터 소스 테이블을 가져옵니다.
// 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 Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of data source tables on Sheet1. // To get an array of data source tables for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceTables = sheet.getDataSourceTables(); // Logs the last completed data execution time on the first data source table. console.log(dataSourceTables[0].getStatus().getLastExecutionTime());
리턴
DataSourceTable[]
- 데이터 소스 테이블 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSources()
스프레드시트의 모든 데이터 소스를 반환합니다.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the data sources on the spreadsheet. const dataSources = ss.getDataSources(); // Logs the name of the first column on the first data source. console.log(dataSources[0].getColumns()[0].getName());
리턴
DataSource[]
- 모든 데이터 소스의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
최상위 스프레드시트와 연결된 개발자 메타데이터를 가져옵니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Adds 'Google' as a key to the spreadsheet metadata. ss.addDeveloperMetadata('Google'); // Gets the spreadsheet's metadata. const ssMetadata = ss.getDeveloperMetadata(); // Gets the first set of the spreadsheet's metadata and logs the key to the console. console.log(ssMetadata[0].getKey());
리턴
DeveloperMetadata[]
- 이 범위와 연결된 개발자 메타데이터입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getEditors()
이 Spreadsheet
의 편집자 목록을 가져옵니다.
리턴
User[]
- 수정 권한이 있는 사용자의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
이 스프레드시트로 응답을 전송하는 양식의 URL을 반환하거나, 다음인 경우 null
를 반환합니다.
이 스프레드시트에는 연결된 양식이 없습니다. 여러 양식이 이 스프레드시트에 응답을 보내는 경우
반환된 양식 URL이 확실하지 않습니다. 또는 시트당 양식 URL 연결은
Sheet.getFormUrl()
메서드를 통해 가져올 수 있습니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the form URL from the spreadsheet. const formUrl = ss.getFormUrl(); // Logs the form URL to the console. console.log(formUrl);
리턴
String
— 이 스프레드시트에 응답을 배치하는 양식의 URL 또는 null
이 스프레드시트에는 연결된 양식이 없습니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
고정된 열의 수를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
리턴
Integer
: 고정된 열의 수
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
고정된 행 수를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
리턴
Integer
- 고정된 행 수
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getId()
이 스프레드시트의 고유 식별자를 가져옵니다. URL에서 스프레드시트 ID를 추출할 수 있습니다. 예를 들어 URL의 스프레드시트 ID는 https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0에서 'abc1234567'로 지정합니다.
// The code below logs the ID for the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());
리턴
String
- 스프레드시트의 고유 ID (또는 키)입니다.
getImages()
시트의 모든 그리드 이미지를 반환합니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the over-the-grid images from Sheet1. // To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead. const images = sheet.getImages(); // For each image, logs the anchor cell in A1 notation. for (const image of images) { console.log(image.getAnchorCell().getA1Notation()); }
리턴
OverGridImage[]
- 그리드 오버 이미지의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIterativeCalculationConvergenceThreshold()
반복 계산 중에 사용된 임곗값을 반환합니다. 연속적인 계산의 차이가 이 값보다 작으면 반복 계산이 중지됩니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
리턴
Number
- 수렴 기준점입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
콘텐츠가 있는 마지막 열의 위치를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
리턴
Integer
: 콘텐츠가 포함된 시트의 마지막 열
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
콘텐츠가 있는 마지막 행의 위치를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
리턴
Integer
: 콘텐츠가 포함된 시트의 마지막 행
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxIterativeCalculationCycles()
반복 계산 중에 사용할 최대 반복 횟수를 반환합니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
리턴
Integer
- 계산 반복의 최대 횟수입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
문서의 이름을 가져옵니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getName());
리턴
String
- 스프레드시트의 이름입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
이 스프레드시트에서 이름이 지정된 모든 범위를 가져옵니다.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { Logger.log(namedRanges[i].getName()); }
리턴
NamedRange[]
- 스프레드시트에서 이름이 지정된 모든 범위의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumSheets()
이 스프레드시트의 시트 수를 반환합니다.
// The code below logs the number of sheets in the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());
리턴
Integer
- 스프레드시트의 시트 수입니다.
getOwner()
문서의 소유자를 반환하거나, 공유 드라이브에 있는 문서의 경우 null
를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var owner = ss.getOwner(); Logger.log(owner.getEmail());
리턴
User
— 문서 소유자 또는 문서가 공유 드라이브에 있는 경우 null
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPredefinedSpreadsheetThemes()
사전 정의된 테마 목록을 반환합니다.
// The code below returns the list of predefined themes. var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet() .getPredefinedSpreadsheetThemes();
리턴
SpreadsheetTheme[]
- 사전 정의된 테마 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
스프레드시트의 모든 보호된 범위 또는 시트를 나타내는 객체의 배열을 가져옵니다.
// Remove all range protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove all sheet protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
매개변수
이름 | 유형 | 설명 |
---|---|---|
type | ProtectionType | 보호 구역의 유형(SpreadsheetApp.ProtectionType.RANGE 또는
SpreadsheetApp.ProtectionType.SHEET 입니다. |
리턴
Protection[]
- 스프레드시트의 모든 보호된 범위 또는 시트를 나타내는 객체의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
A1 표기법 또는 R1C1 표기법으로 지정된 범위를 반환합니다.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
매개변수
이름 | 유형 | 설명 |
---|---|---|
a1Notation | String | A1 표기법 또는 R1C1 표기법으로 지정된 반환할 범위입니다. |
리턴
Range
: 지정된 위치의 범위
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeByName(name)
이름이 지정된 범위, 또는 지정된 이름의 범위를 찾을 수 없는 경우 null
를 반환합니다. 여러 개의
여러 개의 시트가 동일한 범위 이름을 사용하므로
따옴표(예: getRangeByName('TaxRates')
또는 getRangeByName('Sheet Name!TaxRates')
는 사용할 수 있지만 getRangeByName('"Sheet
Name"!TaxRates')
는 사용할 수 없음)
// Log the number of columns for the range named 'TaxRates' in the active spreadsheet. var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates'); if (range != null) { Logger.log(range.getNumColumns()); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 가져올 범위의 이름입니다. |
리턴
Range
- 지정된 이름을 가진 셀 범위입니다.
getRangeList(a1Notations)
지정된 동일한 시트의 범위를 나타내는 RangeList
컬렉션을 반환합니다.
A1 표기법 또는 R1C1 표기법의 비어 있지 않은 목록으로 계산됩니다.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
매개변수
이름 | 유형 | 설명 |
---|---|---|
a1Notations | String[] | A1 표기법 또는 R1C1 표기법으로 지정된 반환할 범위 목록입니다. |
리턴
RangeList
: 지정된 위치의 범위 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRecalculationInterval()
이 스프레드시트의 계산 간격을 반환합니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Logs the calculation interval for the spreadsheet to the console. console.log(ss.getRecalculationInterval().toString());
리턴
RecalculationInterval
- 이 스프레드시트의 계산 간격입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
지정된 행의 높이를 픽셀 단위로 가져옵니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowPosition | Integer | 검사할 행의 위치입니다. |
리턴
Integer
— 행 높이(픽셀)
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
스프레드시트의 현재 Selection
를 반환합니다.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
리턴
Selection
: 현재 선택 항목
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetByName(name)
지정된 이름의 시트를 반환합니다.
여러 시트의 이름이 같으면 가장 왼쪽에 있는 시트가 반환됩니다. 다음과 같은 경우 null
를 반환합니다.
지정된 이름의 시트가 없습니다.
// The code below logs the index of a sheet named "Expenses" var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses"); if (sheet != null) { Logger.log(sheet.getIndex()); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 가져올 시트의 이름입니다. |
리턴
Sheet
- 지정된 이름의 시트입니다.
getSheetId()
이 객체가 나타내는 시트의 ID를 반환합니다.
스프레드시트별로 고유한 시트 ID입니다. ID는
시트 위치와 관계없는 시트 생성 시간에 할당되는 증가하는 정수입니다. 이
는 Sheet
인스턴스가 아닌 gridId
매개변수를 사용하는 Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
와 같은 메서드와 함께 사용하면 유용합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
리턴
Integer
: 스프레드시트 고유의 시트 ID입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
시트 이름을 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
리턴
String
: 시트 이름
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
지정된 좌표에서 시작하여 이 범위에 해당하는 값의 직사각형 그리드를 반환합니다. A -1 행 또는 열 위치로 지정된 값은 맨 마지막 행이나 열을 가져오는 것과 같음 선택합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
매개변수
이름 | 유형 | 설명 |
---|---|---|
startRow | Integer | 시작 행의 위치입니다. |
startColumn | Integer | 시작 열의 위치입니다. |
numRows | Integer | 값을 반환할 행의 개수입니다. |
numColumns | Integer | 값을 반환할 열의 개수입니다. |
리턴
Object[][]
— 값의 2차원 배열
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheets()
이 스프레드시트의 모든 시트를 가져옵니다.
// The code below logs the name of the second sheet var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets(); if (sheets.length > 1) { Logger.log(sheets[1].getName()); }
리턴
Sheet[]
- 스프레드시트에 있는 모든 시트의 배열입니다.
getSpreadsheetLocale()
스프레드시트 언어를 가져옵니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
리턴
String
- 스프레드시트 언어
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpreadsheetTheme()
스프레드시트의 현재 테마를 반환하거나, 테마가 적용되지 않은 경우 null
를 반환합니다.
// The code below returns the current theme of the spreadsheet. var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();
리턴
SpreadsheetTheme
: 현재 적용된 테마입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpreadsheetTimeZone()
스프레드시트의 시간대를 가져옵니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
리턴
String
- 'long'으로 지정된 시간대 형식 (예: 'America/New_York',
Joda.org 제공).
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getUrl()
지정된 스프레드시트의 URL을 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getUrl());
리턴
String
- 지정된 스프레드시트의 URL입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getViewers()
이 Spreadsheet
의 뷰어 및 댓글 작성자 목록을 가져옵니다.
리턴
User[]
- 보기 또는 댓글 작성 권한이 있는 사용자의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
지정된 범위의 열을 숨깁니다.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
매개변수
이름 | 유형 | 설명 |
---|---|---|
column | Range | 숨길 열 범위입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
지정된 범위의 행을 숨깁니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
매개변수
이름 | 유형 | 설명 |
---|---|---|
row | Range | 숨길 행 범위입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
지정된 열 위치 뒤에 열을 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
afterPosition | Integer | 뒤에 새 열을 추가해야 하는 열입니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
지정된 열 위치 앞에 열을 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
beforePosition | Integer | 앞에 새 열을 추가해야 하는 열입니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
지정된 열 위치 뒤에 지정된 수의 열을 삽입합니다.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Inserts two columns after the first column on the first sheet of the spreadsheet. sheet.insertColumnsAfter(1,2);
매개변수
이름 | 유형 | 설명 |
---|---|---|
afterPosition | Integer | 뒤에 새 열을 추가해야 하는 열입니다. |
howMany | Integer | 삽입할 열의 개수입니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
지정된 열 위치 앞에 여러 열을 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
매개변수
이름 | 유형 | 설명 |
---|---|---|
beforePosition | Integer | 앞에 새 열을 추가해야 하는 열입니다. |
howMany | Integer | 삽입할 열의 개수입니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertDataSourceSheet(spec)
스프레드시트에 새 DataSourceSheet
를 삽입하고 데이터 실행을 시작합니다.
새 시트가 활성 시트가 됩니다.
데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution()
메서드를 사용하여 특정 데이터 소스의 데이터 실행을 사용 설정합니다.
있습니다.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // 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'); // 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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
spec | DataSourceSpec | 삽입할 데이터 소스 사양입니다. |
리턴
DataSourceSheet
- 새 데이터 소스 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
문서의 지정된 행과 열에 Spreadsheet
를 이미지로 삽입합니다. 이미지
blob의 콘텐츠에서 가져옵니다. 지원되는 최대 blob 크기는 2MB입니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
blobSource | BlobSource | 이미지 콘텐츠, MIME 유형 및 이름 (선택사항)을 포함하는 blob입니다. |
column | Integer | 열 위치입니다. |
row | Integer | 행 위치입니다. |
리턴
OverGridImage
- 삽입된 이미지입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row, offsetX, offsetY)
문서의 지정된 행과 열에 Spreadsheet
을
픽셀 오프셋입니다. 이미지 크기는 blob 콘텐츠에서 가져옵니다. 지원되는 최대 blob
크기는 2MB입니다
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
매개변수
이름 | 유형 | 설명 |
---|---|---|
blobSource | BlobSource | 이미지 콘텐츠, MIME 유형 및 이름 (선택사항)을 포함하는 blob입니다. |
column | Integer | 열 위치입니다. |
row | Integer | 행 위치입니다. |
offsetX | Integer | 셀 모서리로부터의 가로 오프셋(픽셀)입니다. |
offsetY | Integer | 셀 모서리로부터의 세로 오프셋(픽셀)입니다. |
리턴
OverGridImage
- 삽입된 이미지입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
문서의 지정된 행과 열에 이미지를 삽입합니다.
제공된 URL은 공개적으로 액세스할 수 있어야 합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
url | String | 이미지의 URL입니다. |
column | Integer | 그리드 열 위치입니다. |
row | Integer | 그리드 행 위치입니다. |
리턴
OverGridImage
- 삽입된 이미지입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
문서의 지정된 행과 열에 픽셀 오프셋을 사용하여 이미지를 삽입합니다.
제공된 URL은 공개적으로 액세스할 수 있어야 합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
매개변수
이름 | 유형 | 설명 |
---|---|---|
url | String | 이미지의 URL입니다. |
column | Integer | 열 위치입니다. |
row | Integer | 행 위치입니다. |
offsetX | Integer | 셀 모서리로부터의 가로 오프셋(픽셀)입니다. |
offsetY | Integer | 셀 모서리로부터의 세로 오프셋(픽셀)입니다. |
리턴
OverGridImage
- 삽입된 이미지입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
지정된 행 위치 뒤에 행을 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
afterPosition | Integer | 뒤에 새 행을 추가해야 하는 행입니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
지정된 행 위치 앞에 행을 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
beforePosition | Integer | 앞에 새 행을 추가해야 하는 행입니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
지정된 행 위치 뒤에 여러 행을 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
매개변수
이름 | 유형 | 설명 |
---|---|---|
afterPosition | Integer | 뒤에 새 행을 추가해야 하는 행입니다. |
howMany | Integer | 삽입할 행 수입니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
지정된 행 위치 앞에 여러 행을 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
매개변수
이름 | 유형 | 설명 |
---|---|---|
beforePosition | Integer | 앞에 새 행을 추가해야 하는 행입니다. |
howMany | Integer | 삽입할 행 수입니다. |
리턴
Sheet
: 메서드 체이닝에 유용한 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet()
insertSheet(sheetIndex)
지정된 색인의 스프레드시트에 새 시트를 삽입합니다. 새 시트가 활성 상태가 됩니다. 시트입니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
sheetIndex | Integer | 새로 만든 시트의 색인입니다. 다음 위치에 시트를 첫 번째 시트로 삽입하려면 0으로 설정합니다. |
리턴
Sheet
- 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetIndex, options)
지정된 색인의 스프레드시트에 새 시트를 삽입하고 선택적 고급을 사용합니다. 인수입니다. 새 시트가 활성 시트가 됩니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet(1, {template: templateSheet});
매개변수
이름 | 유형 | 설명 |
---|---|---|
sheetIndex | Integer | 새로 만든 시트의 색인입니다. 다음 위치에 시트를 첫 번째 시트로 삽입하려면 0으로 설정합니다. |
options | Object | 선택적 JavaScript 고급 인수입니다. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
template | Sheet | 템플릿 시트 객체의 모든 데이터가 새 시트입니다. 시트 템플릿은 스프레드시트 객체의 시트 중 하나여야 합니다. |
리턴
Sheet
- 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(options)
기본 시트 이름 및 고급 옵션(선택사항)을 사용하여 스프레드시트에 새 시트를 삽입합니다. 인수입니다. 새 시트가 활성 시트가 됩니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet({template: templateSheet});
매개변수
이름 | 유형 | 설명 |
---|---|---|
options | Object | 아래에 나열된 자바스크립트 고급 인수(선택사항). |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
template | Sheet | 템플릿 시트 객체의 모든 데이터가 새 시트입니다. 시트 템플릿은 이 스프레드시트 객체의 시트 중 하나여야 합니다. |
리턴
Sheet
- 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName)
스프레드시트에 지정된 이름의 새 시트를 삽입합니다. 새 시트가 활성 상태가 됩니다. 시트입니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet');
매개변수
이름 | 유형 | 설명 |
---|---|---|
sheetName | String | 새 시트의 이름입니다. |
리턴
Sheet
- 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, sheetIndex)
지정된 색인에 지정된 이름의 스프레드시트에 새 시트를 삽입합니다. 새 시트 활성 시트가 됩니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet', 1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
sheetName | String | 새 시트의 이름입니다. |
sheetIndex | Integer | 새로 만든 시트의 색인입니다. 다음 위치에 시트를 첫 번째 시트로 삽입하려면 0으로 설정합니다. |
리턴
Sheet
- 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, sheetIndex, options)
주어진 색인에서 지정된 이름의 스프레드시트에 새 시트를 삽입하고 고급 인수(선택사항) 새 시트가 활성 시트가 됩니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', 1, {template: templateSheet});
매개변수
이름 | 유형 | 설명 |
---|---|---|
sheetName | String | 새 시트의 이름입니다. |
sheetIndex | Integer | 새로 삽입된 시트의 색인입니다. 다음 위치에 시트를 첫 번째 시트로 삽입하려면 0으로 설정합니다. |
options | Object | 선택적 JavaScript 고급 인수입니다. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
template | Sheet | 템플릿 시트 객체의 모든 데이터가 새 시트입니다. 시트 템플릿은 스프레드시트 객체의 시트 중 하나여야 합니다. |
리턴
Sheet
- 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, options)
지정된 이름으로 스프레드시트에 새 시트를 삽입하고 선택적 고급 옵션을 사용합니다. 인수입니다. 새 시트가 활성 시트가 됩니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', {template: templateSheet});
매개변수
이름 | 유형 | 설명 |
---|---|---|
sheetName | String | 새 시트의 이름입니다. |
options | Object | 선택적 JavaScript 고급 인수입니다. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
template | Sheet | 템플릿 시트 객체의 모든 데이터가 새 시트입니다. 시트 템플릿은 스프레드시트 객체의 시트 중 하나여야 합니다. |
리턴
Sheet
- 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheetWithDataSourceTable(spec)
스프레드시트에 새 시트를 삽입하고 범위에 걸쳐 DataSourceTable
을 만듭니다.
전체 시트에 액세스하고, 데이터 실행을 시작합니다. 측면
새 시트를 활성 시트로 만듭니다.
데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution()
메서드를 사용하여 특정 데이터 소스의 데이터 실행을 사용 설정합니다.
있습니다.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // 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'); // Adds a sheet and sets cell A1 as the parameter cell. const parameterCell = ss.insertSheet('parameterSheet').getRange('A1'); // Sets the value of the parameter cell to 'Duke'. parameterCell.setValue('Duke'); const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' + '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL'; // Adds a data source with a query parameter. // TODO(developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setRawQuery(query) .setParameterFromCell('SCHOOL', 'parameterSheet!A1') .build(); // Adds sheets for the data source and data source table to the spreadsheet. ss.insertSheetWithDataSourceTable(dataSourceSpec);
매개변수
이름 | 유형 | 설명 |
---|---|---|
spec | DataSourceSpec | 삽입할 데이터 소스 사양입니다. |
리턴
Sheet
- 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
지정된 열을 사용자가 숨겼는지 여부를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnPosition | Integer | 검토할 열의 위치입니다. |
리턴
Boolean
— 열이 숨겨져 있으면 true
, 숨겨져 있으면 false
입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isIterativeCalculationEnabled()
이 스프레드시트에서 반복 계산이 활성화되었는지 여부를 반환합니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
리턴
Boolean
: 반복 계산이 활성화된 경우 true
, 그렇지 않은 경우 false
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
지정된 행이 필터 보기가 아닌 필터에 의해 숨겨졌는지 여부를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowPosition | Integer | 검사할 행의 위치입니다. |
리턴
Boolean
— 행이 숨겨져 있으면 true
, 숨겨져 있으면 false
입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
지정된 행을 사용자가 숨겼는지 여부를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowPosition | Integer | 검사할 행의 위치입니다. |
리턴
Boolean
— 행이 숨겨져 있으면 true
, 숨겨져 있으면 false
입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveActiveSheet(pos)
활성 시트를 시트 목록의 지정된 위치로 이동합니다. 다음과 같은 경우 예외가 발생합니다. 위치가 음수이거나 시트 수보다 큽니다.
// This example assumes that there are 2 sheets in the current // active spreadsheet: one named "first" in position 1 and another named "second" // in position 2. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Gets the "first" sheet and activates it. var sheet = spreadsheet.getSheetByName("first").activate(); // Logs 'Current index of sheet: 1' console.log("Current index of sheet: %s", sheet.getIndex()); spreadsheet.moveActiveSheet(2); // Logs 'New index of sheet: 2' console.log("New index of sheet: %s", sheet.getIndex());
매개변수
이름 | 유형 | 설명 |
---|---|---|
pos | Integer | 시트 목록에서 활성 시트를 이동할 색인 1자리 위치입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveChartToObjectSheet(chart)
새 SheetType.OBJECT
시트를 만들고 제공된 차트를 이 시트로 이동합니다. 차트
가 이미 자체 시트에 있는 경우 새 시트를 만들지 않고 해당 시트가 반환됩니다.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.newChart().setPosition(1, 1, 0, 0).build(); sheet.insertChart(chart); var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);
매개변수
이름 | 유형 | 설명 |
---|---|---|
chart | EmbeddedChart | 이동할 차트입니다. |
리턴
Sheet
- 차트가 있는 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshAllDataSources()
지원되는 모든 데이터 소스 및 연결된 데이터 소스 객체를 새로고침하고 잘못된 항목을 건너뜁니다. 데이터 소스 객체입니다.
SpreadsheetApp#enable...Execution()
메서드를 사용하여 다음에 대한 데이터 실행 사용 설정
특정 데이터 소스 유형을
추적할 수 있습니다
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // 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 the first data source sheet on the spreadsheet. const dataSheet = ss.getDataSourceSheets()[0]; // Refreshes all data sources on the spreadsheet. ss.refreshAllDataSources(); // Logs the last refreshed time of the first data source sheet. console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeEditor(emailAddress)
Spreadsheet
의 편집자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는
다음과 같은 사용자 클래스에 속하는 경우 사용자가 Spreadsheet
에 액세스하지 못하도록 차단합니다.
일반 액세스 권한(예: Spreadsheet
이 사용자의 전체 계정과 공유되는 경우)
또는 Spreadsheet
이(가) 사용자가 액세스할 수 있는 공유 드라이브에