Class Range

범위

스프레드시트 범위에 액세스하고 수정합니다. 범위는 시트의 단일 셀 또는 할 수 있습니다.

메서드

메서드반환 유형간략한 설명
activate()Range지정된 범위를 상단이 있는 active range으로 설정합니다. 범위의 왼쪽 셀은 current cell입니다.
activateAsCurrentCell()Range지정된 셀을 current cell로 설정합니다.
addDeveloperMetadata(key)Range지정된 키가 있는 개발자 메타데이터를 범위에 추가합니다.
addDeveloperMetadata(key, visibility)Range지정된 키와 공개 상태가 있는 개발자 메타데이터를 범위에 추가합니다.
addDeveloperMetadata(key, value)Range지정된 키와 값이 있는 개발자 메타데이터를 범위에 추가합니다.
addDeveloperMetadata(key, value, visibility)Range지정된 키, 값, 공개 상태가 포함된 개발자 메타데이터를 범위에 추가합니다.
applyColumnBanding()Banding범위에 기본 열 밴드 지정 테마를 적용합니다.
applyColumnBanding(bandingTheme)Banding지정된 열 밴드 지정 테마를 범위에 적용합니다.
applyColumnBanding(bandingTheme, showHeader, showFooter)Banding지정된 머리글 및 바닥글이 있는 범위에 지정된 열 밴드 지정 테마를 적용합니다. 설정을 변경할 수 있습니다.
applyRowBanding()Banding범위에 기본 행 밴딩 테마를 적용합니다.
applyRowBanding(bandingTheme)Banding지정된 행 밴딩 테마를 범위에 적용합니다.
applyRowBanding(bandingTheme, showHeader, showFooter)Banding지정된 머리글 및 바닥글 설정이 있는 범위에 지정된 행 밴드 지정 테마를 적용합니다.
autoFill(destination, series)void이 범위의 데이터를 기반으로 하는 데이터로 destinationRange를 채웁니다.
autoFillToNeighbor(series)void인접 셀을 기준으로 새 데이터로 채울 범위를 계산하고 자동으로 채웁니다. 이 범위에 포함된 데이터를 기반으로 하는 새 값으로 바꿉니다.
breakApart()Range범위의 다중 열 셀을 다시 개별 셀로 나눕니다.
canEdit()Boolean사용자에게 범위의 모든 셀을 수정할 권한이 있는지 여부를 결정합니다.
check()Range범위 내 체크박스의 상태를 '선택됨'으로 변경합니다.
clear()Range콘텐츠 및 서식 범위를 지웁니다.
clear(options)Range 사용할 수 있습니다.
clearContent()Range서식은 그대로 두고 범위의 콘텐츠를 지웁니다.
clearDataValidations()Range범위의 데이터 확인 규칙을 지웁니다.
clearFormat()Range이 범위의 서식을 지웁니다.
clearNote()Range지정한 셀에서 메모를 지웁니다.
collapseGroups()Range범위 내에 완전히 포함된 모든 그룹을 접습니다.
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)void범위 서식을 지정된 위치로 복사합니다.
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)void범위 서식을 지정된 위치로 복사합니다.
copyTo(destination)void셀 범위의 데이터를 다른 셀 범위로 복사합니다.
copyTo(destination, copyPasteType, transposed)void셀 범위의 데이터를 다른 셀 범위로 복사합니다.
copyTo(destination, options)void셀 범위의 데이터를 다른 셀 범위로 복사합니다.
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)void범위의 내용을 지정된 위치에 복사합니다.
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)void범위의 내용을 지정된 위치에 복사합니다.
createDataSourcePivotTable(dataSource)DataSourcePivotTable데이터 소스에서 빈 데이터 소스 피벗 테이블을 만들고 첫 번째 셀에 고정합니다. 이 범위 내에 있습니다.
createDataSourceTable(dataSource)DataSourceTable데이터 소스에서 빈 데이터 소스 표를 만들어 이 표의 첫 번째 셀에 고정합니다. 범위입니다.
createDeveloperMetadataFinder()DeveloperMetadataFinder이 범위 내에서 개발자 메타데이터를 찾기 위해 DeveloperMetadataFinderApi를 반환합니다. 범위입니다.
createFilter()Filter필터를 만들어 시트의 지정된 범위에 적용합니다.
createPivotTable(sourceData)PivotTable첫 번째 셀에 고정된 지정된 sourceData에서 빈 피벗 테이블을 만듭니다. 이 범위 내에 있습니다.
createTextFinder(findText)TextFinder범위에 대한 텍스트 검색기를 만들어 이 범위의 텍스트를 찾아서 바꿀 수 있습니다.
deleteCells(shiftDimension)void이 셀 범위를 삭제합니다.
expandGroups()Range범위 또는 컨트롤 토글이 이 범위와 교차하는 접힌 그룹을 펼칩니다.
getA1Notation()String범위의 문자열 설명을 A1 표기법으로 반환합니다.
getBackground()String범위에 있는 왼쪽 상단 셀의 배경 색상을 반환합니다 (예: '#ffffff').
getBackgroundObject()Color범위에 있는 왼쪽 상단 셀의 배경 색상을 반환합니다.
getBackgroundObjects()Color[][]범위 내 셀의 배경 색상을 반환합니다.
getBackgrounds()String[][]범위 내 셀의 배경 색상을 반환합니다 (예: '#ffffff').
getBandings()Banding[]이 범위의 모든 셀에 적용된 모든 밴딩을 반환합니다.
getCell(row, column)Range범위 내의 주어진 셀을 반환합니다.
getColumn()Integer이 범위의 시작 열 위치를 반환합니다.
getDataRegion()Range모든 값을 포괄하도록 4개의 기본 Direction에서 확장된 범위의 사본을 반환합니다. 배열됩니다.
getDataRegion(dimension)Range다음과 같은 경우 확장된 Direction.UPDirection.DOWN 범위의 사본을 반환합니다. 지정된 차원은 Dimension.ROWS 또는 차원이 Dimension.COLUMNS인 경우 Direction.NEXTDirection.PREVIOUS입니다.
getDataSourceFormula()DataSourceFormula범위의 첫 번째 셀에 대해 DataSourceFormula를 반환하거나 다음 경우 null를 반환합니다. 셀에 데이터 소스 수식이 포함되어 있지 않습니다.
getDataSourceFormulas()DataSourceFormula[]범위 내 셀의 DataSourceFormula를 반환합니다.
getDataSourcePivotTables()DataSourcePivotTable[]범위와 교차하는 모든 데이터 소스 피벗 테이블을 가져옵니다.
getDataSourceTables()DataSourceTable[]범위와 교차하는 모든 데이터 소스 테이블을 가져옵니다.
getDataSourceUrl()String차트와 쿼리를 만드는 데 사용할 수 있는 이 범위의 데이터 URL을 반환합니다.
getDataTable()DataTable이 객체 내의 데이터를 DataTable로 반환합니다.
getDataTable(firstRowIsHeader)DataTable이 범위 내의 데이터를 DataTable로 반환합니다.
getDataValidation()DataValidation범위의 왼쪽 상단 셀에 대한 데이터 확인 규칙을 반환합니다.
getDataValidations()DataValidation[][]범위의 모든 셀에 대한 데이터 확인 규칙을 반환합니다.
getDeveloperMetadata()DeveloperMetadata[]이 범위와 연결된 개발자 메타데이터를 가져옵니다.
getDisplayValue()String범위에서 왼쪽 상단 셀의 표시된 값을 반환합니다.
getDisplayValues()String[][]이 범위에 대한 값의 직사각형 그리드를 반환합니다.
getFilter()Filter이 범위가 속한 시트의 필터를 반환합니다. 또는 필터가 없는 경우 null를 반환합니다. 할 수 있습니다.
getFontColorObject()Color범위의 왼쪽 상단에 있는 셀의 글꼴 색상을 반환합니다.
getFontColorObjects()Color[][]범위 내 셀의 글꼴 색상을 반환합니다.
getFontFamilies()String[][]범위 내 셀의 글꼴 모음을 반환합니다.
getFontFamily()String범위의 왼쪽 상단에 있는 셀의 글꼴 모음을 반환합니다.
getFontLine()String범위 왼쪽 상단 모서리에 있는 셀의 선 스타일 ('underline', 'line-through' 또는 'none')을 입력합니다.
getFontLines()String[][]범위 ('underline', 'line-through' 또는 'none')을 입력합니다.
getFontSize()Integer범위 왼쪽 상단 모서리에 있는 셀의 글꼴 크기를 포인트 크기로 반환합니다.
getFontSizes()Integer[][]범위 내 셀의 글꼴 크기를 반환합니다.
getFontStyle()String왼쪽 상단 셀의 글꼴 스타일 ('italic' 또는 'normal')을 반환합니다. 범위를 선택합니다.
getFontStyles()String[][]범위 내 셀의 글꼴 스타일을 반환합니다.
getFontWeight()String범위의 왼쪽 상단 모서리에 있는 셀의 글꼴 두께 (보통/굵게)를 반환합니다.
getFontWeights()String[][]범위 내 셀의 글꼴 두께를 반환합니다.
getFormula()String범위의 왼쪽 상단 셀에 대한 수식 (A1 표기법)을 반환하거나, 셀이 비어 있거나 수식이 포함되어 있지 않습니다.
getFormulaR1C1()String지정된 셀에 대해 수식 (R1C1 표기법)을 반환하거나 없으면 null을 반환합니다.
getFormulas()String[][]범위 내 셀의 수식 (A1 표기법)을 반환합니다.
getFormulasR1C1()String[][]범위 내 셀의 수식 (R1C1 표기법)을 반환합니다.
getGridId()Integer범위 상위 시트의 그리드 ID를 반환합니다.
getHeight()Integer범위의 높이를 반환합니다.
getHorizontalAlignment()String왼쪽 상단 셀의 텍스트 (왼쪽/가운데/오른쪽)의 가로 정렬을 반환합니다. 범위를 선택합니다.
getHorizontalAlignments()String[][]범위 내 셀의 가로 정렬을 반환합니다.
getLastColumn()Integer종료 열 위치를 반환합니다.
getLastRow()Integer끝 행 위치를 반환합니다.
getMergedRanges()Range[]완전히 병합된 셀을 나타내는 Range 객체의 배열을 반환합니다. 현재 범위 내에 있거나 현재 범위 내에 최소 1개의 셀을 포함해야 합니다.
getNextDataCell(direction)Range범위의 첫 번째 열과 행에 있는 셀에서 시작하여 데이터가 있는 셀 또는 셀의 연속된 범위의 가장자리인 지정된 방향 그 방향으로 스프레드시트의 가장자리에서 선을 그리세요.
getNote()String지정된 범위와 연결된 메모를 반환합니다.
getNotes()String[][]범위의 셀과 연결된 메모를 반환합니다.
getNumColumns()Integer이 범위의 열 수를 반환합니다.
getNumRows()Integer이 범위의 행 수를 반환합니다.
getNumberFormat()String지정된 범위의 왼쪽 상단 셀의 숫자 또는 날짜 형식을 가져옵니다.
getNumberFormats()String[][]범위 내 셀의 숫자 또는 날짜 형식을 반환합니다.
getRichTextValue()RichTextValue범위의 왼쪽 상단 셀의 서식 있는 텍스트 값을 반환하거나, 셀이 왼쪽 상단 셀인 경우 null를 반환합니다. 값이 텍스트가 아닙니다.
getRichTextValues()RichTextValue[][]범위 내 셀의 서식 있는 텍스트 값을 반환합니다.
getRow()Integer이 범위의 행 위치를 반환합니다.
getRowIndex()Integer이 범위의 행 위치를 반환합니다.
getSheet()Sheet이 범위가 속한 시트를 반환합니다.
getTextDirection()TextDirection범위의 왼쪽 상단 셀의 텍스트 방향을 반환합니다.
getTextDirections()TextDirection[][]범위 내 셀의 텍스트 방향을 반환합니다.
getTextRotation()TextRotation범위의 왼쪽 상단 셀에 대한 텍스트 회전 설정을 반환합니다.
getTextRotations()TextRotation[][]범위 내 셀의 텍스트 회전 설정을 반환합니다.
getTextStyle()TextStyle범위의 왼쪽 상단 셀의 텍스트 스타일을 반환합니다.
getTextStyles()TextStyle[][]범위 내 셀의 텍스트 스타일을 반환합니다.
getValue()Object범위에서 왼쪽 상단 셀의 값을 반환합니다.
getValues()Object[][]이 범위에 대한 값의 직사각형 그리드를 반환합니다.
getVerticalAlignment()String다음 셀의 왼쪽 상단에 있는 셀의 세로 정렬 (상단/중간/하단)을 반환합니다. 범위입니다.
getVerticalAlignments()String[][]범위 내 셀의 세로 정렬을 반환합니다.
getWidth()Integer열에서 범위의 너비를 반환합니다.
getWrap()Boolean셀의 텍스트 줄바꿈 여부를 반환합니다.
getWrapStrategies()WrapStrategy[][]범위 내 셀의 텍스트 줄바꿈 전략을 반환합니다.
getWrapStrategy()WrapStrategy범위의 왼쪽 상단 셀에 대한 텍스트 줄바꿈 전략을 반환합니다.
getWraps()Boolean[][]셀의 텍스트 줄바꿈 여부를 반환합니다.
insertCells(shiftDimension)Range이 범위에 빈 셀을 삽입합니다.
insertCheckboxes()Range범위의 각 셀에 체크박스를 삽입합니다. 선택 및 선택에 대해 true로 구성되어 있습니다. 선택 해제된 경우 false.
insertCheckboxes(checkedValue)Range범위의 각 셀에 체크박스를 삽입합니다. 선택 및 선택에 대한 맞춤 값으로 구성된 선택 해제를 위한 빈 문자열입니다.
insertCheckboxes(checkedValue, uncheckedValue)Range선택한 셀에 대한 커스텀 값으로 구성된 범위의 각 셀에 체크박스를 삽입합니다. 확인할 수 있습니다
isBlank()Boolean범위가 완전히 비어 있으면 true를 반환합니다.
isChecked()Boolean범위의 모든 셀의 체크박스 상태가 '선택됨'인지 여부를 반환합니다.
isEndColumnBounded()Boolean범위의 끝이 특정 열에 결합되는지 여부를 결정합니다.
isEndRowBounded()Boolean범위의 끝이 특정 행에 결합되는지 여부를 결정합니다.
isPartOfMerge()Boolean현재 범위의 셀이 병합된 셀과 겹치는 경우 true를 반환합니다.
isStartColumnBounded()Boolean범위의 시작이 특정 열에 바인딩되는지 여부를 결정합니다.
isStartRowBounded()Boolean범위의 시작이 특정 행에 바인딩되는지 여부를 결정합니다.
merge()Range범위의 셀을 하나의 블록으로 병합합니다.
mergeAcross()Range범위의 열에서 범위의 셀을 병합합니다.
mergeVertically()Range범위 내 셀을 병합합니다.
moveTo(target)void이 범위에서 형식 및 값 모두를 잘라내어 대상 범위로 붙여넣습니다.
offset(rowOffset, columnOffset)Range이 범위에서 주어진 행과 열의 수만큼 오프셋되는 새 범위를 반환합니다. (음수일 수 있음)
offset(rowOffset, columnOffset, numRows)Range왼쪽 상단 지점이 오프셋인 현재 범위를 기준으로 한 새 범위를 반환합니다. 현재 범위에서 주어진 행 및 열과 셀의 주어진 높이를 기준으로 하여 얻습니다.
offset(rowOffset, columnOffset, numRows, numColumns)Range왼쪽 상단 지점이 오프셋인 현재 범위를 기준으로 한 새 범위를 반환합니다. 현재 범위에서 주어진 행과 열로, 그리고 주어진 높이와 너비로 셀입니다.
protect()Protection다음 권한이 있는 사용자를 제외한 범위가 수정되지 않도록 보호할 수 있는 객체를 만듭니다. 권한을 부여했는지 확인합니다.
randomize()Range지정된 범위에서 행의 순서를 무작위로 지정합니다.
removeCheckboxes()Range범위에서 모든 체크박스를 삭제합니다.
removeDuplicates()Range이 범위 내에서 모든 값과 중복된 값이 포함된 행을 삭제합니다. 이전 행입니다.
removeDuplicates(columnsToCompare)Range이 범위 내에서 지정된 열에 중복된 값이 포함된 행을 삭제합니다. 값이 표시됩니다.
setBackground(color)RangeCSS 표기법으로 범위에 있는 모든 셀의 배경 색상을 설정합니다 (예: '#ffffff'). 또는 'white').
setBackgroundObject(color)Range범위 내 모든 셀의 배경 색상을 설정합니다.
setBackgroundObjects(color)Range배경 색상의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setBackgroundRGB(red, green, blue)RangeRGB 값 (0~255 사이의 정수)을 사용하여 배경을 지정된 색상으로 설정합니다.
setBackgrounds(color)Range배경 색상의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setBorder(top, left, bottom, right, vertical, horizontal)Range테두리 속성을 설정합니다.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)Range색상 및/또는 스타일로 테두리 속성을 설정합니다.
setDataValidation(rule)Range범위의 모든 셀에 하나의 데이터 확인 규칙을 설정합니다.
setDataValidations(rules)Range범위의 모든 셀에 대한 데이터 확인 규칙을 설정합니다.
setFontColor(color)RangeCSS 표기법 (예: '#ffffff' 또는 'white')으로 글꼴 색상을 설정합니다.
setFontColorObject(color)Range지정된 범위의 글꼴 색상을 설정합니다.
setFontColorObjects(colors)Range글꼴 색상의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setFontColors(colors)Range글꼴 색상의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setFontFamilies(fontFamilies)Range글꼴 모음의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setFontFamily(fontFamily)Range글꼴 모음을 설정합니다(예: "Arial"). 또는 'Helvetica'입니다.
setFontLine(fontLine)Range지정된 범위 ('underline', 'line-through' 또는 'none')을 입력합니다.
setFontLines(fontLines)Range선 스타일의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setFontSize(size)Range사용할 포인트 크기로 글꼴 크기를 설정합니다.
setFontSizes(sizes)Range글꼴 크기의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setFontStyle(fontStyle)Range지정된 범위 ('italic' 또는 'normal')의 글꼴 스타일을 설정합니다.
setFontStyles(fontStyles)Range글꼴 스타일의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setFontWeight(fontWeight)Range주어진 범위 (일반/굵게)의 글꼴 두께를 설정합니다.
setFontWeights(fontWeights)Range글꼴 두께의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setFormula(formula)Range이 범위의 수식을 업데이트합니다.
setFormulaR1C1(formula)Range이 범위의 수식을 업데이트합니다.
setFormulas(formulas)Range수식의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setFormulasR1C1(formulas)Range수식의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setHorizontalAlignment(alignment)Range지정된 범위 (왼쪽/가운데/오른쪽)의 가로 (왼쪽에서 오른쪽) 정렬을 설정합니다.
setHorizontalAlignments(alignments)Range가로 정렬의 직사각형 그리드를 설정합니다.
setNote(note)Range메모를 지정된 값으로 설정합니다.
setNotes(notes)Range메모의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setNumberFormat(numberFormat)Range숫자 또는 날짜 형식을 지정된 서식 문자열로 설정합니다.
setNumberFormats(numberFormats)Range숫자 또는 날짜 형식의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setRichTextValue(value)Range범위 내 셀의 서식 있는 텍스트 값을 설정합니다.
setRichTextValues(values)Range서식 있는 텍스트 값의 직사각형 그리드를 설정합니다.
setShowHyperlink(showHyperlink)Range범위에 하이퍼링크를 표시할지 여부를 설정합니다.
setTextDirection(direction)Range범위 내 셀의 텍스트 방향을 설정합니다.
setTextDirections(directions)Range텍스트 방향의 직사각형 그리드를 설정합니다.
setTextRotation(degrees)Range범위 내 셀의 텍스트 회전 설정을 지정합니다.
setTextRotation(rotation)Range범위 내 셀의 텍스트 회전 설정을 지정합니다.
setTextRotations(rotations)Range텍스트 회전의 직사각형 그리드를 설정합니다.
setTextStyle(style)Range범위 내 셀의 텍스트 스타일을 설정합니다.
setTextStyles(styles)Range텍스트 스타일의 직사각형 그리드를 설정합니다.
setValue(value)Range범위의 값을 설정합니다.
setValues(values)Range값의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setVerticalAlignment(alignment)Range지정된 범위 (상단/중간/하단)의 수직 (위에서 아래로) 정렬을 설정합니다.
setVerticalAlignments(alignments)Range수직 정렬의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
setVerticalText(isVertical)Range범위 내 셀의 텍스트를 쌓을지 여부를 설정합니다.
setWrap(isWrapEnabled)Range지정된 범위의 셀 줄바꿈을 설정합니다.
setWrapStrategies(strategies)Range래핑 전략의 직사각형 그리드를 설정합니다.
setWrapStrategy(strategy)Range범위 내 셀의 텍스트 줄바꿈 전략을 설정합니다.
setWraps(isWrapEnabled)Range단어 줄바꿈 정책의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).
shiftColumnGroupDepth(delta)Range범위의 열 그룹화 깊이를 지정된 양만큼 변경합니다.
shiftRowGroupDepth(delta)Range범위의 행 그룹화 깊이를 지정된 양만큼 변경합니다.
sort(sortSpecObj)Range지정된 범위의 셀을 지정된 열 및 순서에 따라 정렬합니다.
splitTextToColumns()void자동 감지된 구분 기호를 기반으로 텍스트 열을 여러 열로 분할합니다.
splitTextToColumns(delimiter)void지정된 문자열을 커스텀 구분 기호로 사용하여 텍스트 열을 여러 열로 분할합니다.
splitTextToColumns(delimiter)void지정된 구분 기호에 따라 텍스트 열을 여러 열로 분할합니다.
trimWhitespace()Range이 범위의 모든 셀에서 공백 (예: 공백, 탭, 새 줄)을 자릅니다.
uncheck()Range범위 내 체크박스의 상태를 '선택 해제됨'으로 변경합니다.

자세한 문서

activate()

지정된 범위를 상단이 있는 active range으로 설정합니다. 범위의 왼쪽 셀은 current cell입니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:D10');
range.activate();

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D10
var activeRange = selection.getActiveRange();

리턴

Range - 체이닝을 위한 범위입니다.


activateAsCurrentCell()

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

지정된 셀이 기존 범위에 있으면 해당 범위가 활성 상태가 됩니다. 범위를 지정합니다.

지정된 셀이 기존 범위에 없는 경우 기존 선택사항은 이 셀이 현재 셀과 활성 범위가 됩니다.

참고: 지정된 Range는 하나의 셀로 구성되어야 합니다. 그렇지 않으면 예외가 인정됩니다.

// Gets the first sheet of the spreadsheet.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
var range = sheet.getRange('B5');
var currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

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

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

매개변수

이름유형설명
keyString새 개발자 메타데이터의 키입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

매개변수

이름유형설명
keyString새 개발자 메타데이터의 키입니다.
visibilityDeveloperMetadataVisibility새 개발자 메타데이터의 공개 상태입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 of Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

매개변수

이름유형설명
keyString새 개발자 메타데이터의 키입니다.
valueString새 개발자 메타데이터의 값입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
  'NAME',
  'GOOGLE',
  SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

매개변수

이름유형설명
keyString새 개발자 메타데이터의 키입니다.
valueString새 개발자 메타데이터의 값입니다.
visibilityDeveloperMetadataVisibility새 개발자 메타데이터의 공개 상태입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

applyColumnBanding()

범위에 기본 열 밴드 지정 테마를 적용합니다. 기본적으로 밴딩에는 헤더가 있지만 바닥글 색상

// 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 row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString());

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

리턴

Banding - 새 밴딩입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

applyColumnBanding(bandingTheme)

지정된 열 밴드 지정 테마를 범위에 적용합니다. 기본적으로 밴딩에는 헤더와 바닥글 색상이 없습니다.

// 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 row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

매개변수

이름유형설명
bandingThemeBandingTheme범위의 열에 적용할 색상 테마입니다.

리턴

Banding - 새 밴딩입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

applyColumnBanding(bandingTheme, showHeader, showFooter)

지정된 머리글 및 바닥글이 있는 범위에 지정된 열 밴드 지정 테마를 적용합니다. 설정을 변경할 수 있습니다.

// 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 rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true);

// Gets the banding color and logs it to the console.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

// Gets the header color object and logs it to the console. Returns null because the header
// visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());

매개변수

이름유형설명
bandingThemeBandingTheme범위의 열에 적용할 색상 테마입니다.
showHeaderBooleantrue인 경우 밴딩 테마 헤더 색상이 첫 번째 를 클릭합니다.
showFooterBooleantrue인 경우 밴딩 테마 바닥글 색상이 마지막 를 클릭합니다.

리턴

Banding - 새 밴딩입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

applyRowBanding()

범위에 기본 행 밴딩 테마를 적용합니다. 기본적으로 밴딩에는 헤더가 있지만 바닥글 색상

// Opens the spreadsheet 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 rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies row banding to rows 1-30.
range.applyRowBanding();

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

리턴

Banding - 밴딩입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

applyRowBanding(bandingTheme)

지정된 행 밴딩 테마를 범위에 적용합니다. 기본적으로 밴딩에는 헤더가 있지만 바닥글 색상

// Opens the spreadsheet 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 rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding theme to rows 1-30.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

매개변수

이름유형설명
bandingThemeBandingTheme범위의 행에 적용할 색상 테마

리턴

Banding - 새 밴딩입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

applyRowBanding(bandingTheme, showHeader, showFooter)

지정된 머리글 및 바닥글 설정이 있는 범위에 지정된 행 밴드 지정 테마를 적용합니다.

// Opens the spreadsheet 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 rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding to rows 1-30 and
// specifies to hide the header and show the footer.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);

매개변수

이름유형설명
bandingThemeBandingTheme범위의 행에 적용할 색상 테마
showHeaderBooleantrue인 경우 밴딩 테마 헤더 색상이 첫 번째 행에 적용됩니다.
showFooterBooleantrue인 경우 밴딩 테마 바닥글 색상이 마지막 행에 적용됩니다.

리턴

Banding - 새 밴딩입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

autoFill(destination, series)

이 범위의 데이터를 기반으로 하는 데이터로 destinationRange를 채웁니다. 새 값 지정된 series 유형에 의해서도 결정됩니다. 대상 범위에는 한 방향으로만 확장합니다. 예를 들어 다음은 A1:A20를 채웁니다. 다음과 같이 A1:A4의 현재 값에 따라 증가하는 숫자를 사용합니다.

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var destination = sheet.getRange("A1:A20");

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

매개변수

이름유형설명
destinationRange값으로 자동 입력될 범위입니다. 대상 범위는 이 범위를 포함하고 한 방향 (위쪽, 아래쪽, 왼쪽 또는 참조).
seriesAutoFillSeries새 값을 계산하는 데 사용해야 하는 자동완성 계열의 유형입니다. 이 이 시리즈의 효과는 소스 데이터의 유형과 양에 따라 달라집니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

autoFillToNeighbor(series)

인접 셀을 기준으로 새 데이터로 채울 범위를 계산하고 자동으로 채웁니다. 이 범위에 포함된 데이터를 기반으로 하는 새 값으로 바꿉니다. 이러한 새로운 값은 지정된 series 유형에 따라 결정됩니다.

계산된 목적지 범위에서는 주변 데이터를 고려하여 새 데이터가 값을 삽입해야 합니다. 자동으로 채워지기 때문에 새 값은 이 인접한 데이터까지만 확장됩니다.

예를 들어 A1:A20가 일련의 증가하는 숫자로 채워지고 이 메서드는 일련의 날짜가 포함된 B1:B4 범위에서 호출되며 새 값은 B5:B20에 삽입되었습니다. 이렇게 하면 새 값이 값을 값을 입력합니다.

var sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
var sourceRange = sheet.getRange("B1:B4");

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

매개변수

이름유형설명
seriesAutoFillSeries새 값을 계산하는 데 사용해야 하는 자동완성 계열의 유형입니다. 이 이 시리즈의 효과는 소스 데이터의 유형과 양에 따라 달라집니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

breakApart()

범위의 다중 열 셀을 다시 개별 셀로 나눕니다.

범위에 대해 이 함수를 호출하는 것은 범위를 선택하고 서식 > 셀 병합 > 병합 취소를 탭합니다.

// Opens the spreadsheet 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 range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Unmerges the range A1:C6 into individual cells.
range.breakApart();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

canEdit()

사용자에게 범위의 모든 셀을 수정할 권한이 있는지 여부를 결정합니다. 스프레드시트 소유자는 항상 보호된 범위와 시트를 수정할 수 있습니다.

// Opens the spreadsheet 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 range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Logs whether the user has permission to edit every cell in the range.
console.log(range.canEdit());

리턴

Boolean: true, 사용자에게 범위 내 모든 셀을 수정할 권한이 있는 경우 <ph type="x-smartling-placeholder">false</ph> 없습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

check()

범위 내 체크박스의 상태를 '선택됨'으로 변경합니다. 범위의 셀을 무시합니다. 현재 선택된 값 또는 선택 해제된 값이 포함되어 있지 않습니다.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'checked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

clear()

콘텐츠 및 서식 범위를 지웁니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clear();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

clear(options)

사용할 수 있습니다. 기본적으로 모든 데이터가 지워집니다.

// The code below clears range C2:G7 in the active sheet, but preserves the format,
// data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});

매개변수

이름유형설명
optionsObject아래와 같이 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

이름유형설명
commentsOnlyBoolean주석만 삭제할지 여부입니다.
contentsOnlyBoolean콘텐츠만 삭제할지 여부입니다.
formatOnlyBoolean형식만 지울지 여부입니다. 한 번 더 형식은 데이터 유효성 검사 규칙도 지웁니다.
validationsOnlyBoolean데이터 유효성 검사 규칙만 삭제할지 여부입니다.
skipFilteredRowsBoolean필터링된 행을 삭제하지 않을지 여부입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

clearContent()

서식은 그대로 두고 범위의 콘텐츠를 지웁니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearContent();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

clearDataValidations()

범위의 데이터 확인 규칙을 지웁니다.

// Clear the data validation rules for cells A1:B5.
var range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

clearFormat()

이 범위의 서식을 지웁니다.

이렇게 하면 범위 내 셀의 텍스트 서식이 지워지지만 아무것도 재설정되지는 않습니다. 숫자 서식 규칙

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearFormat();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

clearNote()

지정한 셀에서 메모를 지웁니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearNote();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

collapseGroups()

범위 내에 완전히 포함된 모든 그룹을 접습니다. 그룹 내에 완전히 범위 안에 있는 가장 깊은 부분까지 펼친 그룹이 접힙니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are collapsed.
range.collapseGroups();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

copyFormatToRange(gridId, column, columnEnd, row, rowEnd)

범위 서식을 지정된 위치로 복사합니다. 목적지가 더 크거나 작은 경우 원본 범위보다 크면 소스가 이에 따라 반복되거나 잘립니다. 이 메서드는 서식만 복사합니다.

그리드 ID 매개변수에 관한 자세한 설명은 getGridId()를 참고하세요.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

매개변수

이름유형설명
gridIdInteger위치와 관계없이 스프레드시트 내 시트의 고유 ID입니다.
columnInteger목표 범위의 첫 번째 열입니다.
columnEndInteger목표 범위의 끝 열입니다.
rowInteger목표 범위의 시작 행입니다.
rowEndInteger목표 범위의 끝 행입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

참고 항목


copyFormatToRange(sheet, column, columnEnd, row, rowEnd)

범위 서식을 지정된 위치로 복사합니다. 목적지가 더 크거나 작은 경우 원본 범위보다 크면 소스가 이에 따라 반복되거나 잘립니다. 이 메서드는 서식만 복사합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

매개변수

이름유형설명
sheetSheet대상 시트입니다.
columnInteger목표 범위의 첫 번째 열입니다.
columnEndInteger목표 범위의 끝 열입니다.
rowInteger목표 범위의 시작 행입니다.
rowEndInteger목표 범위의 끝 행입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

copyTo(destination)

셀 범위의 데이터를 다른 셀 범위로 복사합니다. 값과 형식 모두 복사됩니다

// The code below copies the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

매개변수

이름유형설명
destinationRange복사할 대상 범위입니다. 왼쪽 상단 셀 위치만 관련이 있습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

copyTo(destination, copyPasteType, transposed)

셀 범위의 데이터를 다른 셀 범위로 복사합니다.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES,
false);

매개변수

이름유형설명
destinationRange복사할 대상 범위입니다. 왼쪽 상단 셀 위치만 관련이 있습니다.
copyPasteTypeCopyPasteType범위 콘텐츠를 있습니다.
transposedBoolean행과 열을 바꾼 방향으로 붙여넣을지 여부입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

copyTo(destination, options)

셀 범위의 데이터를 다른 셀 범위로 복사합니다. 기본적으로 값과 서식은 복사되지만 고급 인수를 사용하여 재정의할 수 있습니다.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});

매개변수

이름유형설명
destinationRange복사할 대상 범위입니다. 왼쪽 상단 셀 위치만 관련이 있습니다.
optionsObject아래와 같이 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 매개변수

이름유형설명
formatOnlyBoolean는 형식만 복사해야 함을 나타냅니다.
contentsOnlyBoolean콘텐츠만 복사되어야 함을

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

copyValuesToRange(gridId, column, columnEnd, row, rowEnd)

범위의 내용을 지정된 위치에 복사합니다. 목적지가 더 크거나 작은 경우 원본 범위보다 크면 소스가 이에 따라 반복되거나 잘립니다.

그리드 ID 매개변수에 관한 자세한 설명은 getGridId()를 참고하세요.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

매개변수

이름유형설명
gridIdInteger위치와 관계없이 스프레드시트 내 시트의 고유 ID입니다.
columnInteger목표 범위의 첫 번째 열입니다.
columnEndInteger목표 범위의 끝 열입니다.
rowInteger목표 범위의 시작 행입니다.
rowEndInteger목표 범위의 끝 행입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

참고 항목


copyValuesToRange(sheet, column, columnEnd, row, rowEnd)

범위의 내용을 지정된 위치에 복사합니다. 목적지가 더 크거나 작은 경우 원본 범위보다 크면 소스가 이에 따라 반복되거나 잘립니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

매개변수

이름유형설명
sheetSheet대상 시트입니다.
columnInteger목표 범위의 첫 번째 열입니다.
columnEndInteger목표 범위의 끝 열입니다.
rowInteger목표 범위의 시작 행입니다.
rowEndInteger목표 범위의 끝 행입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

createDataSourcePivotTable(dataSource)

데이터 소스에서 빈 데이터 소스 피벗 테이블을 만들고 첫 번째 셀에 고정합니다. 이 범위 내에 있습니다.

이 예에서는 새 데이터 소스 피벗 테이블을 만들고 구성하는 방법을 보여줍니다.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM);
pivotTable.addFilter('dataColumnA',
                     SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());

매개변수

이름유형설명
dataSourceDataSource피벗 테이블을 만들 데이터 소스입니다.

리턴

DataSourcePivotTable - 새로 만든 데이터 소스 피벗 테이블입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

createDataSourceTable(dataSource)

데이터 소스에서 빈 데이터 소스 표를 만들어 이 표의 첫 번째 셀에 고정합니다. 범위입니다.

이 예에서는 새 데이터 소스 표를 만들고 구성하는 방법을 보여줍니다.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var dataSourceTable = anchorCell.createDataSourceTable(dataSource);
    .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
    .addSortSpec('dataColumnA', /* ascending= *\/ true)
    .addSortSpec('dataColumnB', /* ascending= *\/ false);

매개변수

이름유형설명
dataSourceDataSource피벗 테이블을 만들 데이터 소스입니다.

리턴

DataSourceTable - 새로 만든 데이터 소스 테이블입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

createDeveloperMetadataFinder()

이 범위 내에서 개발자 메타데이터를 찾기 위해 DeveloperMetadataFinderApi를 반환합니다. 범위입니다. 메타데이터는 해당 범위 내에 완전히 포함된 경우에만 해당 범위 내에 있음 범위입니다. 예를 들어 '3:3' 행과 연결된 메타데이터가 범위 범위에 없습니다. ‘A1:D5’이지만 ‘1:5’ 범위 내에 있습니다.

// 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 the range A1:C6.
const range = sheet.getRange('A1:C6');

// Creates a developer metadata finder to search for metadata in the scope of this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

리턴

DeveloperMetadataFinder - 이 범위 내의 메타데이터를 검색하기 위한 개발자 메타데이터 파인더입니다.


createFilter()

필터를 만들어 시트의 지정된 범위에 적용합니다. 만들 수 있는 최대 한도는 다음과 같습니다. 필터 1개를 설정할 수 있습니다 필터를 만든 후 액세스하고 수정하려면 getFilter() 또는 Sheet.getFilter()를 사용합니다.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}
드림 이 방법을 사용하여 기본 유형의 시트인 Grid 시트에 대한 필터를 만들 수 있습니다. 그리드 시트는 데이터베이스에 연결되지 않은 시트입니다. 다른 유형의 필터를 만들려면 다음을 참고하세요. <ph type="x-smartling-placeholder">

리턴

Filter - 새 필터입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

createPivotTable(sourceData)

첫 번째 셀에 고정된 지정된 sourceData에서 빈 피벗 테이블을 만듭니다. 이 범위 내에 있습니다.

// 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 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

매개변수

이름유형설명
sourceDataRange피벗 테이블을 만들 데이터입니다.

리턴

PivotTable - 새로 만든 PivotTable입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

createTextFinder(findText)

범위에 대한 텍스트 검색기를 만들어 이 범위의 텍스트를 찾아서 바꿀 수 있습니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// Creates  a text finder for the range.
var textFinder = range.createTextFinder('dog');

// Returns the first occurrence of 'dog'.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = textFinder.replaceWith('cat');

매개변수

이름유형설명
findTextString검색할 텍스트입니다.

리턴

TextFinder - 범위의 TextFinder


deleteCells(shiftDimension)

이 셀 범위를 삭제합니다. 입력한 측정기준을 따라 시트의 기존 데이터가 이동됩니다. 감소합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

매개변수

이름유형설명
shiftDimensionDimension기존 데이터를 이동할 측정기준입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

expandGroups()

범위 또는 컨트롤 토글이 이 범위와 교차하는 접힌 그룹을 펼칩니다. 이 컨트롤 전환 위치는 그룹 뒤의 색깔을 바꿀 수 있습니다. 동일한 위치에 둘 이상의 그룹이 있는 경우 가장 얕은 그룹이 확장됩니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are expanded.
range.expandGroups();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getA1Notation()

범위의 문자열 설명을 A1 표기법으로 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

리턴

String - A1 표기법으로 나타낸 범위의 문자열 설명입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getBackground()

범위에 있는 왼쪽 상단 셀의 배경 색상을 반환합니다 (예: '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

리턴

String - 배경의 색상 코드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getBackgroundObject()

범위에 있는 왼쪽 상단 셀의 배경 색상을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

리턴

Color - 범위 내 왼쪽 상단 셀의 배경 색상입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getBackgroundObjects()

범위 내 셀의 배경 색상을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgroundObjects();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

리턴

Color[][] - 배경 색상의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getBackgrounds()

범위 내 셀의 배경 색상을 반환합니다 (예: '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgrounds();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

리턴

String[][] - 배경 색상 코드의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getBandings()

이 범위의 모든 셀에 적용된 모든 밴딩을 반환합니다.

// 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 a range.
const range = sheet.getRange('A1:K50');

// Gets the banding info for the range.
const bandings = range.getBandings();

// Logs the second row color for each banding to the console.
for (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

리턴

Banding[] - 이 범위의 모든 셀에 적용된 모든 밴딩입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getCell(row, column)

범위 내의 주어진 셀을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

매개변수

이름유형설명
rowInteger범위를 기준으로 한 셀의 행입니다.
columnInteger범위를 기준으로 한 셀의 열입니다.

리턴

Range - 지정된 좌표에 단일 셀을 포함하는 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getColumn()

이 범위의 시작 열 위치를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "2.0"
Logger.log(range.getColumn());

리턴

Integer - 스프레드시트에서 범위의 시작 열 위치입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDataRegion()

모든 값을 포괄하도록 4개의 기본 Direction에서 확장된 범위의 사본을 반환합니다. 배열됩니다. 범위가 이러한 셀을 포함하지 않는 빈 셀로 둘러싸여 있는 경우 범위 자체가 반환됩니다. 이는 범위를 선택하고 편집기에 Ctrl+A를 입력합니다.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());

리턴

Range - 범위의 데이터 리전 또는 전체 스프레드시트의 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDataRegion(dimension)

다음과 같은 경우 확장된 Direction.UPDirection.DOWN 범위의 사본을 반환합니다. 지정된 차원은 Dimension.ROWS 또는 차원이 Dimension.COLUMNS인 경우 Direction.NEXTDirection.PREVIOUS입니다. 범위 확장 표처럼 구성된 범위 옆의 데이터를 감지하는 것을 기반으로 합니다. 확장된 범위 표를 포함하여 지정된 측정기준에 따라 데이터가 있는 모든 인접한 셀을 덮습니다. 경계선에 위치해 있습니다 지정된 측정기준에서 원래 범위가 빈 셀로 둘러싸여 있으면 범위 자체가 반환됩니다. 이 방법은 편집기에서 범위를 선택하고 열에 Ctrl+Space을, 행에 Shift+Space를 입력하는 것과 비슷합니다.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "C2:C4"
Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation());
// Logs "B3:D3"
Logger.log(
    sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());

매개변수

이름유형설명
dimensionDimension범위를 확장할 측정기준입니다.

리턴

Range - 범위의 데이터 리전 또는 각 열 또는 원본 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDataSourceFormula()

범위의 첫 번째 셀에 대해 DataSourceFormula를 반환하거나 다음 경우 null를 반환합니다. 셀에 데이터 소스 수식이 포함되어 있지 않습니다.

// 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 the range A1 on Sheet1.
const range = sheet.getRange('A1');

// Gets the data source formula from cell A1.
const dataSourceFormula = range.getDataSourceFormula();

// Gets the formula.
const formula = dataSourceFormula.getFormula();

// Logs the formula.
console.log(formula);

리턴

DataSourceFormula - 셀의 DataSourceFormula입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDataSourceFormulas()

범위 내 셀의 DataSourceFormula를 반환합니다.

// 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 the range A1:B5 on Sheet1.
const range = sheet.getRange('A1:B5');

// Gets an array of the data source formulas in the range A1:B5.
const dataSourceFormulas = range.getDataSourceFormulas();

// Logs the first formula in the array.
console.log(dataSourceFormulas[0].getFormula());

리턴

DataSourceFormula[] - 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 the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets an array of the data source pivot tables in the range A1:G50.
const dataSourcePivotTables = range.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

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 the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets the first data source table in the range A1:G50.
const dataSourceTable = range.getDataSourceTables()[0];

// Logs the time of the last completed data execution on the data source table.
console.log(dataSourceTable.getStatus().getLastExecutionTime());

리턴

DataSourceTable[] - 데이터 소스 테이블 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDataSourceUrl()

차트와 쿼리를 만드는 데 사용할 수 있는 이 범위의 데이터 URL을 반환합니다.

Code.gs

function doGet() {
  var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c');
  var sheet = ss.getSheetByName('ContinentData');
  var range = sheet.getRange('A1:B8');

  var template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

piechart.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

리턴

String - 차트와 같은 다른 API에 전달할 수 있는 데이터 소스로 이 범위의 URL입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDataTable()

이 객체 내의 데이터를 DataTable로 반환합니다.

// 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 the range A1:B7 on Sheet1.
const range = sheet.getRange('A1:B7');

// Gets the range A1:B7 as a data table. The values in each column must be of the same type.
const datatable = range.getDataTable();

// Uses the Charts service to build a bar chart from the data table.
// This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Chart Title Here')
                  .build();

리턴

DataTable: 데이터 테이블로서의 데이터입니다.


getDataTable(firstRowIsHeader)

이 범위 내의 데이터를 DataTable로 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B7");

// Calling this method with "true" sets the first line to be the title of the axes
var datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

매개변수

이름유형설명
firstRowIsHeaderBoolean첫 번째 행을 헤더로 처리할지 여부입니다.

리턴

DataTable - 데이터 테이블로서의 데이터입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDataValidation()

범위의 왼쪽 상단 셀에 대한 데이터 확인 규칙을 반환합니다. 데이터 검증이 완료되지 않은 경우 셀에 설정된 경우 이 메서드는 null를 반환합니다.

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

리턴

DataValidation - 범위의 왼쪽 상단 셀에 대한 데이터 확인 규칙입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDataValidations()

범위의 모든 셀에 대한 데이터 확인 규칙을 반환합니다. 데이터 유효성 검사가 완료되지 않은 경우 지정된 셀에 설정된 경우 이 메서드는 배열에서 해당 셀의 위치에 대해 null를 반환합니다.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

리턴

DataValidation[][] - 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • 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 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 row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds metadata to row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Logs the metadata to console.
for (const metadata of range.getDeveloperMetadata()) {
  console.log(`${metadata.getKey()}: ${metadata.getValue()}`);
}

리턴

DeveloperMetadata[] - 이 범위와 연결된 개발자 메타데이터입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDisplayValue()

범위에서 왼쪽 상단 셀의 표시된 값을 반환합니다. 값은 String입니다. 표시된 값은 날짜, 시간, 통화 형식(예: 스프레드시트의 언어 설정에 의해 자동으로 적용됩니다. 빈 셀은 빈 셀을 반환합니다. 문자열.

// 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 A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

// Gets the value and logs it to the console.
console.log(cell.getDisplayValue());

리턴

String - 이 셀에 표시되는 값입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getDisplayValues()

이 범위에 대한 값의 직사각형 그리드를 반환합니다.

행별로, 그 다음 열별로 색인이 생성된 표시된 값의 2차원 배열을 반환합니다. 이 값은 String 객체입니다. 표시된 값은 날짜, 시간 및 통화 서식(스프레드시트 언어별 자동으로 적용되는 형식 포함) 설정을 변경합니다. 빈 셀은 배열에서 빈 문자열로 표시됩니다. 작업을 수행하는 동안 범위 색인은 1, 1에서 시작하며 JavaScript 배열은 [0][0]에서 색인이 생성됩니다.

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

리턴

String[][] - 값의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFilter()

이 범위가 속한 시트의 필터를 반환하거나, 필터가 없는 경우 null을 반환합니다. 할 수 있습니다.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Gets the existing filter on the sheet that the given range belongs to.
let filter = range.getFilter();

리턴

Filter - 필터입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontColorObject()

범위의 왼쪽 상단에 있는 셀의 글꼴 색상을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

리턴

Color - 범위 내 왼쪽 상단 셀의 글꼴 색상입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontColorObjects()

범위 내 셀의 글꼴 색상을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColorObjects();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

리턴

Color[][] - 범위 내 셀과 연결된 글꼴 색상의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontFamilies()

범위 내 셀의 글꼴 모음을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontFamilies();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

리턴

String[][] - 범위 내 셀과 연결된 글꼴 모음의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontFamily()

범위의 왼쪽 상단에 있는 셀의 글꼴 모음을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontFamily());

리턴

String - 셀의 글꼴 모음입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontLine()

범위 왼쪽 상단 모서리에 있는 셀의 선 스타일 ('underline', 'line-through' 또는 'none')을 입력합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontLine());

리턴

String - 글꼴 선입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontLines()

범위 ('underline', 'line-through' 또는 'none')을 입력합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontLines();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

리턴

String[][] - 범위 내 셀과 연결된 2차원 글꼴 선의 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontSize()

범위 왼쪽 상단 모서리에 있는 셀의 글꼴 크기를 포인트 크기로 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontSize());

리턴

Integer - 글꼴 크기(포인트 크기)입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontSizes()

범위 내 셀의 글꼴 크기를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontSizes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

리턴

Integer[][] - 범위 내 셀과 연결된 텍스트의 글꼴 크기의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontStyle()

왼쪽 상단 셀의 글꼴 스타일 ('italic' 또는 'normal')을 반환합니다. 범위를 선택합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontStyle());

리턴

String - 셀에 있는 텍스트의 글꼴 스타일입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontStyles()

범위 내 셀의 글꼴 스타일을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontStyles();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

리턴

String[][] - 범위 내 셀과 연결된 텍스트의 글꼴 스타일의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontWeight()

범위의 왼쪽 상단 모서리에 있는 셀의 글꼴 두께 (보통/굵게)를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontWeight());

리턴

String - 셀에 있는 텍스트의 글꼴 두께입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFontWeights()

범위 내 셀의 글꼴 두께를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontWeights();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

리턴

String[][] - 범위 내 셀과 연결된 텍스트의 글꼴 두께의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFormula()

범위의 왼쪽 상단 셀에 대한 수식 (A1 표기법)을 반환하거나, 셀이 비어 있거나 수식이 포함되어 있지 않습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This assumes you have a function in B5 that sums up
// B2:B4
var range = sheet.getRange("B5");

// Logs the calculated value and the formula
Logger.log("Calculated value: %s Formula: %s",
           range.getValue(),
           range.getFormula());

리턴

String - 셀의 수식입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFormulaR1C1()

지정된 셀에 대해 수식 (R1C1 표기법)을 반환하거나 없으면 null을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

리턴

String - R1C1 표기법의 수식입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFormulas()

범위 내 셀의 수식 (A1 표기법)을 반환합니다. 2차원 배열의 항목은 수식이 없는 셀의 빈 문자열입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulas();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

리턴

String[][] - 문자열 형식의 2차원 배열 수식입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getFormulasR1C1()

범위 내 셀의 수식 (R1C1 표기법)을 반환합니다. 2차원 배열의 항목은 수식이 없는 셀의 경우 null

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulasR1C1();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

리턴

String[][] - R1C1 표기법으로 표시된 수식의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getGridId()

범위 상위 시트의 그리드 ID를 반환합니다. ID는 음수가 아닌 임의의 정수 값입니다.

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getGridId());

리턴

Integer - 상위 시트의 그리드 ID입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getHeight()

범위의 높이를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// logs 3.0
Logger.log(range.getHeight());

리턴

Integer - 범위의 높이입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getHorizontalAlignment()

왼쪽 상단 셀의 텍스트 (왼쪽/가운데/오른쪽)의 가로 정렬을 반환합니다. 범위를 선택합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getHorizontalAlignment());

리턴

String - 셀 내 텍스트의 가로 정렬입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getHorizontalAlignments()

범위 내 셀의 가로 정렬을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getHorizontalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

리턴

String[][] - 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getLastColumn()

종료 열 위치를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastColumn());

리턴

Integer - 스프레드시트에서 범위의 끝 열 위치입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getLastRow()

끝 행 위치를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastRow());

리턴

Integer - 스프레드시트에서 범위의 끝 행 위치입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getMergedRanges()

완전히 병합된 셀을 나타내는 Range 객체의 배열을 반환합니다. 현재 범위 내에 있거나 현재 범위 내에 최소 1개의 셀을 포함해야 합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

var mergedRanges = range.getMergedRanges();
for (var i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

리턴

Range[] - 범위와 겹치는 병합된 셀을 나타내는 Range 객체의 배열입니다.


getNextDataCell(direction)

범위의 첫 번째 열과 행에 있는 셀에서 시작하여 데이터가 있는 셀 또는 셀의 연속된 범위의 가장자리인 지정된 방향 그 방향으로 스프레드시트의 가장자리에서 선을 그리세요. 편집기에 Ctrl+[arrow key]를 입력하는 것과 같습니다.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("C3:E5");
// Logs "C1"
Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());

매개변수

이름유형설명
directionDirection다음 데이터 리전 에지 셀을 찾을 방향입니다.

리턴

Range — 데이터 리전 가장자리 셀 또는 스프레드시트 가장자리의 셀입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getNote()

지정된 범위와 연결된 메모를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getNote());

리턴

String - 지정된 셀과 연결된 메모입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getNotes()

범위의 셀과 연결된 메모를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getNotes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

리턴

String[][] - 범위 내 셀과 연결된 메모의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getNumColumns()

이 범위의 열 수를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumColumns());

리턴

Integer - 이 범위의 열 수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getNumRows()

이 범위의 행 수를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumRows());

리턴

Integer - 이 범위의 행 수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getNumberFormat()

지정된 범위의 왼쪽 상단 셀의 숫자 또는 날짜 형식을 가져옵니다. 반환된 형식 패턴은 Sheets API에 설명되어 있습니다. 문서를 참조하세요.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

리턴

String - 범위의 왼쪽 상단 셀의 숫자 형식입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getNumberFormats()

범위 내 셀의 숫자 또는 날짜 형식을 반환합니다. 반환되는 형식 패턴은 Sheets API 문서에 설명되어 있습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formats = range.getNumberFormats();
for (var i in formats) {
  for (var j in formats[i]) {
    Logger.log(formats[i][j]);
  }
}

리턴

String[][] - 숫자 형식의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getRichTextValue()

범위의 왼쪽 상단 셀의 서식 있는 텍스트 값을 반환하거나, 셀이 왼쪽 상단 셀인 경우 null를 반환합니다. 값이 텍스트가 아닙니다.

// Gets the Rich Text value of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var richText = range.getRichTextValue();
console.log(richText.getText());

리턴

RichTextValue - 범위 왼쪽 상단 셀의 서식 있는 텍스트 값 또는 셀인 경우 null 값이 텍스트가 아닙니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getRichTextValues()

범위 내 셀의 서식 있는 텍스트 값을 반환합니다.

// Gets the Rich Text values for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var values = range.getRichTextValues();

for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    console.log(values[i][j].getText());
  }
}

리턴

RichTextValue[][] - 서식 있는 텍스트 값의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getRow()

이 범위의 행 위치를 반환합니다. getRowIndex()와 동일합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRow());

리턴

Integer - 범위의 행 위치입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getRowIndex()

이 범위의 행 위치를 반환합니다. getRow()와 동일합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

리턴

Integer - 범위의 행 위치입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

참고 항목


getSheet()

이 범위가 속한 시트를 반환합니다.

// 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 the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the sheet that the range belongs to.
const rangeSheet = range.getSheet();

// Gets the sheet name and logs it to the console.
console.log(rangeSheet.getName());

리턴

Sheet - 이 범위가 속한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTextDirection()

범위의 왼쪽 상단 셀의 텍스트 방향을 반환합니다. 셀의 값이 null인 경우 텍스트 방향은 자동 감지를 통해 결정됩니다.

// Get the text direction of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getTextDirection());

리턴

TextDirection - 범위 내 왼쪽 상단 셀의 텍스트 방향입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTextDirections()

범위 내 셀의 텍스트 방향을 반환합니다. 자동 감지 기능을 사용하는 셀의 경우 2차원 배열의 항목은 null입니다.

// Get the text directions for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var directions = range.getTextDirections();

for (var i = 0; i < directions.length; i++) {
  for (var j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

리턴

TextDirection[][] - 텍스트 경로의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTextRotation()

범위의 왼쪽 상단 셀에 대한 텍스트 회전 설정을 반환합니다.

// Log the text rotation settings for a cell.
var sheet = SpreadsheetApp.getActiveSheet();

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

리턴

TextRotation - 텍스트 회전 설정입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTextRotations()

범위 내 셀의 텍스트 회전 설정을 반환합니다.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

var results = range.getTextRotations();

for (var i in results) {
  for (var j in results[i]) {
    var rotation = results[i][j];
    Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation);
  }
}

리턴

TextRotation[][] - 범위 내 셀과 연결된 텍스트 회전의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTextStyle()

범위의 왼쪽 상단 셀의 텍스트 스타일을 반환합니다.

// Get the text style of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var style = range.getTextStyle();
Logger.log(style);

리턴

TextStyle - 범위 내 왼쪽 상단 셀의 텍스트 스타일입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTextStyles()

범위 내 셀의 텍스트 스타일을 반환합니다.

// Get the text styles for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var styles = range.getTextStyles();

for (var i = 0; i < styles.length; i++) {
  for (var j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

리턴

TextStyle[][] - 텍스트 스타일의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getValue()

범위에서 왼쪽 상단 셀의 값을 반환합니다. 값은 Number 유형일 수 있습니다. 셀 값에 따라 Boolean, Date 또는 String입니다. 비어 있음 셀은 빈 문자열을 반환합니다.

// 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 the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the value of the top-left cell in the range and logs it to the console.
console.log(range.getValue());

리턴

Object - 이 셀의 값입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getValues()

이 범위에 대한 값의 직사각형 그리드를 반환합니다.

행별로, 그 다음 열별로 색인이 생성된 값의 2차원 배열을 반환합니다. 값은 Number, Boolean, Date 또는 String 유형인 셀 값입니다. 빈 셀은 배열에서 빈 문자열로 표시됩니다. 기억할 사항 범위 색인은 1, 1에서 시작하지만 JavaScript 배열은 [0][0]에서 색인이 생성됩니다.

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);
드림 웹 앱에서 Date 값은 유효한 매개변수가 아닙니다. getValues() 반환 실패 범위에 Date 값이 있는 셀이 포함된 경우 데이터를 웹 앱으로 전송합니다. 대신 Number, Boolean 또는 String 등 지원되는 JavaScript 프리미티브로 시트에서 가져온 모든 값을 반환합니다.

리턴

Object[][] - 값의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getVerticalAlignment()

다음 셀의 왼쪽 상단에 있는 셀의 세로 정렬 (상단/중간/하단)을 반환합니다. 범위입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getVerticalAlignment());

리턴

String - 셀에 있는 텍스트의 세로 정렬입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getVerticalAlignments()

범위 내 셀의 세로 정렬을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

리턴

String[][] - 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getWidth()

열에서 범위의 너비를 반환합니다.

// 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 the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the width of the range in number of columns and logs it to the console.
console.log(range.getWidth());

리턴

Integer - 범위에 있는 열의 개수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getWrap()

셀의 텍스트 줄바꿈 여부를 반환합니다. 더 세분화된 래핑 전략을 얻으려면 getWrapStrategy()를 사용하세요.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getWrap());

리턴

Boolean - 이 셀의 텍스트 줄바꿈 여부입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getWrapStrategies()

범위 내 셀의 텍스트 줄바꿈 전략을 반환합니다.

// Get the text wrapping strategies for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var strategies = range.getWrapStrategies();

for (var i = 0; i < strategies.length; i++) {
  for (var j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

리턴

WrapStrategy[][] - 텍스트 줄바꿈 전략의 2차원 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getWrapStrategy()

범위의 왼쪽 상단 셀에 대한 텍스트 줄바꿈 전략을 반환합니다.

// Get the text wrapping strategy of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getWrapStrategy());

리턴

WrapStrategy - 범위 내 왼쪽 상단 셀의 텍스트 줄바꿈 전략입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getWraps()

셀의 텍스트 줄바꿈 여부를 반환합니다. 더 세분화된 래핑 전략을 얻으려면 getWrapStrategies()를 사용하세요.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    var isWrapped = results[i][j];
    if (isWrapped) {
       Logger.log("Cell [%s, %s] has wrapped text", i, j);
    }
  }
}

리턴

Boolean[][] - 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

insertCells(shiftDimension)

이 범위에 빈 셀을 삽입합니다. 새 셀은 셀에 있는 서식을 유지합니다. 이 범위를 차지할 수 있습니다. 제공된 측정기준에 따라 시트의 기존 데이터는 다음과 같습니다. 다른 값으로 이동하도록 할 수 있습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

매개변수

이름유형설명
shiftDimensionDimension기존 데이터를 이동할 측정기준입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

insertCheckboxes()

범위의 각 셀에 체크박스를 삽입합니다. 선택 및 선택에 대해 true로 구성되어 있습니다. 선택 해제된 경우 false. 범위에 있는 모든 셀의 값을 false로 설정합니다.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'.
range.insertCheckboxes();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

insertCheckboxes(checkedValue)

범위의 각 셀에 체크박스를 삽입합니다. 선택 및 선택에 대한 맞춤 값으로 구성된 선택 해제를 위한 빈 문자열입니다. 범위에 있는 각 셀의 값을 빈 문자열로 설정합니다.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

매개변수

이름유형설명
checkedValueObject체크박스 데이터 유효성 검사에 선택된 값입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

insertCheckboxes(checkedValue, uncheckedValue)

선택한 셀에 대한 커스텀 값으로 구성된 범위의 각 셀에 체크박스를 삽입합니다. 확인할 수 있습니다 범위 내 각 셀의 값을 선택 해제된 맞춤 값으로 설정합니다.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

매개변수

이름유형설명
checkedValueObject체크박스 데이터 유효성 검사에 선택된 값입니다.
uncheckedValueObject체크박스 데이터 유효성 검사에서 선택 해제된 값입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

isBlank()

범위가 완전히 비어 있으면 true를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.isBlank());

리턴

Boolean: 범위가 비어 있으면 true이고, 그 외에는 false입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

isChecked()

범위의 모든 셀의 체크박스 상태가 '선택됨'인지 여부를 반환합니다. 일부 셀은 선택하고 나머지는 선택 해제하거나 일부 셀에 체크박스가 없는 경우 null를 반환합니다. 데이터 검증

var range = SpreadsheetApp.getActive().getRange('A1:A3');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:A3.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
var isRange1Checked = range1.isChecked();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked value.
var isRange2Checked = range2.isChecked();

var range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox value.
var isRange3Checked = range3.isChecked();

리턴

Boolean — 범위의 모든 셀이 선택된 경우 true, 범위의 모든 셀이 선택된 경우 false 범위가 선택 해제되거나, 선택 해제되었거나 셀이 없는 경우 null입니다. 체크박스를 선택합니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

isEndColumnBounded()

범위의 끝이 특정 열에 결합되는지 여부를 결정합니다. 예를 들어 범위 A1:B10 또는 B:B이며 범위 끝의 열에 바인딩되어 있습니다. 이 메서드가 true를 반환합니다. 경계만 있는 3:7 또는 A1:5 범위 범위 끝의 특정 행에 추가하면 이 메서드는 false를 반환합니다.

 // 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 the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular column and logs it to the
// console.
console.log(range.isEndColumnBounded());

리턴

Boolean: 범위의 끝이 특정 열에 바인딩된 경우 true입니다. <ph type="x-smartling-placeholder">false</ph> 없습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

isEndRowBounded()

범위의 끝이 특정 행에 결합되는지 여부를 결정합니다. 예를 들어 범위가 A1:B10 또는 3:7이며, 이 값은 범위 끝의 행에 결합되어 있습니다. 메서드가 true를 반환합니다. 경계만 있는 B:B 또는 A1:C 범위 범위 끝의 특정 열에 추가하면 이 메서드는 false를 반환합니다.

// 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 the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular row and logs it to the console.
console.log(range.isEndRowBounded());

리턴

Boolean: 범위의 끝이 특정 행에 결합되는 경우 true입니다. <ph type="x-smartling-placeholder">false</ph> 없습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

isPartOfMerge()

현재 범위의 셀이 병합된 셀과 겹치는 경우 true를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

// True if any of the cells in A1:B3 is included in a merge.
var isPartOfMerge = range.isPartOfMerge();

리턴

Boolean — 범위가 병합된 셀과 겹치는 경우 true, 그렇지 않으면 false을 반환합니다.


isStartColumnBounded()

범위의 시작이 특정 열에 바인딩되는지 여부를 결정합니다. 예를 들어 범위 A1:B10 또는 B:B(범위 시작 부분의 열에 바인딩됨) 이 메서드는 true를 반환합니다. 의 행에만 바인딩된 3:7 범위 범위의 시작인 경우 이 메서드는 false를 반환합니다.

// 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 the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular column and logs it to the
// console.
console.log(range.isStartColumnBounded());

리턴

Boolean: 범위의 시작이 특정 열에 바인딩된 경우 true <ph type="x-smartling-placeholder">false</ph> 없습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

isStartRowBounded()

범위의 시작이 특정 행에 바인딩되는지 여부를 결정합니다. 예를 들어 범위 A1:B10 또는 3:7 - 범위 시작 부분의 행에 결합되어 있는 경우 메서드가 true를 반환합니다. 특정에만 바인딩된 B:B 범위에 대해 열이 있으면 이 메서드는 false를 반환합니다.

// 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 the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular row and logs it to the
// console.
console.log(range.isStartRowBounded());

리턴

Boolean: 범위의 시작이 특정 행에 바인딩된 경우 true입니다. <ph type="x-smartling-placeholder">false</ph> 없습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

merge()

범위의 셀을 하나의 블록으로 병합합니다.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

mergeAcross()

범위의 열에서 범위의 셀을 병합합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

mergeVertically()

범위 내 셀을 병합합니다.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

moveTo(target)

이 범위에서 형식 및 값 모두를 잘라내어 대상 범위로 붙여넣습니다.

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

매개변수

이름유형설명
targetRange이 범위를 복사할 대상 범위입니다. 왼쪽 상단 셀 위치만 관련이 있습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

offset(rowOffset, columnOffset)

이 범위에서 주어진 행과 열의 수만큼 오프셋되는 새 범위를 반환합니다. (음수일 수 있음) 새 범위의 크기는 원래 범위와 같습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

매개변수

이름유형설명
rowOffsetInteger범위의 왼쪽 상단 셀에서 내려가는 행 수입니다. 음수 값 범위의 왼쪽 상단 셀부터 위쪽의 행을 나타냅니다.
columnOffsetInteger범위의 왼쪽 상단 셀에서 오른쪽에 있는 열의 개수입니다. 음수 값 범위의 왼쪽 상단 셀에서 왼쪽에 있는 열을 나타냅니다.

리턴

Range - 체이닝을 위한 범위입니다.


offset(rowOffset, columnOffset, numRows)

왼쪽 상단 지점이 오프셋인 현재 범위를 기준으로 한 새 범위를 반환합니다. 현재 범위에서 주어진 행 및 열과 셀의 주어진 높이로 곱셈을 수행합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:B3
var newRange = cell.offset(1, 1, 2);

매개변수

이름유형설명
rowOffsetInteger범위의 왼쪽 상단 셀에서 내려가는 행 수입니다. 음수 값 범위의 왼쪽 상단 셀부터 위쪽의 행을 나타냅니다.
columnOffsetInteger범위의 왼쪽 상단 셀에서 오른쪽에 있는 열의 개수입니다. 음수 값 범위의 왼쪽 상단 셀에서 왼쪽에 있는 열을 나타냅니다.
numRowsInteger새 범위의 행의 높이입니다.

리턴

Range - 체이닝을 위한 범위입니다.


offset(rowOffset, columnOffset, numRows, numColumns)

왼쪽 상단 지점이 오프셋인 현재 범위를 기준으로 한 새 범위를 반환합니다. 현재 범위에서 주어진 행과 열로, 그리고 주어진 높이와 너비로 셀입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:C3
var newRange = cell.offset(1, 1, 2, 2);

매개변수

이름유형설명
rowOffsetInteger범위의 왼쪽 상단 셀에서 내려가는 행 수입니다. 음수 값 범위의 왼쪽 상단 셀부터 위쪽의 행을 나타냅니다.
columnOffsetInteger범위의 왼쪽 상단 셀에서 오른쪽에 있는 열의 개수입니다. 음수 값 범위의 왼쪽 상단 셀에서 왼쪽에 있는 열을 나타냅니다.
numRowsInteger새 범위의 행의 높이입니다.
numColumnsInteger새 범위의 열에 있는 너비입니다.

리턴

Range - 체이닝을 위한 범위입니다.


protect()

다음 권한이 있는 사용자를 제외한 범위가 수정되지 않도록 보호할 수 있는 객체를 만듭니다. 권한을 부여했는지 확인합니다. 스크립트가 범위에 대한 편집자 목록을 실제로 변경하기 전에는 Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) 또는 새로 설정 값 Protection.setDomainEdit(editable)), 권한은 이는 실질적으로 범위가 보호되지 않음을 의미합니다. 범위가 이 메서드는 기존 범위와 겹치는 새 보호 범위를 만듭니다. 만약 셀이 여러 보호된 범위에 의해 보호되고 있으며, 이러한 범위 중 어떤 것이든 특정 사용자가 이 경우 해당 사용자는 셀을 수정할 권한이 없습니다.

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

리턴

Protection - 보호 설정을 나타내는 객체입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

randomize()

지정된 범위에서 행의 순서를 무작위로 지정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Randomizes the range
range.randomize();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

removeCheckboxes()

범위에서 모든 체크박스를 삭제합니다. 각 셀의 데이터 확인을 삭제합니다. 셀에 선택된 값 또는 선택 해제된 값이 있는 경우 해당 값을 추가로 지웁니다.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

removeDuplicates()

이 범위 내에서 모든 값과 중복된 값이 포함된 행을 삭제합니다. 이전 행입니다. 값은 동일하지만 대소문자, 형식, 수식이 다른 행 중복으로 간주됩니다. 이 방법은 또한 보기에서 숨겨진 중복 행을 삭제( 필터로 인해 발생할 수 있음). 이 범위를 벗어나는 콘텐츠는 삭제되지 않습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove duplicate rows in the range.
range.removeDuplicates();

리턴

Range - 중복을 삭제한 후의 결과 범위입니다. 범위 크기가 개의 행이 있습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

removeDuplicates(columnsToCompare)

이 범위 내에서 지정된 열에 중복된 값이 포함된 행을 삭제합니다. 값이 표시됩니다. 값은 동일하지만 대소문자, 서식, 형식이 다른 행이 또는 공식은 중복으로 간주됩니다. 이 방법은 숨겨진 중복 행도 삭제합니다. 삭제할 수 없습니다. 이 범위를 벗어나는 콘텐츠는 삭제되지 않습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2,4]);

매개변수

이름유형설명
columnsToCompareInteger[]중복 값을 분석할 열입니다. 열이 제공되지 않는 경우 모든 열의 중복 데이터가 분석됩니다.

리턴

Range - 중복을 삭제한 후의 결과 범위입니다. 범위 크기가 개의 행이 있습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBackground(color)

CSS 표기법으로 범위에 있는 모든 셀의 배경 색상을 설정합니다 (예: '#ffffff'). 또는 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
range.setBackground("red");

매개변수

이름유형설명
colorStringCSS 표기법의 색상 코드 (예: '#ffffff' 또는 'white') a null 값은 색상을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBackgroundObject(color)

범위에 있는 모든 셀의 배경 색상을 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

매개변수

이름유형설명
colorColor설정할 배경 색상입니다. null 값은 배경 색상을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBackgroundObjects(color)

배경 색상의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

매개변수

이름유형설명
colorColor[][]색상의 2차원 배열입니다. null 값은 색상을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBackgroundRGB(red, green, blue)

RGB 값 (0~255 사이의 정수)을 사용하여 배경을 지정된 색상으로 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

매개변수

이름유형설명
redIntegerRGB 표기법의 빨간색 값입니다.
greenIntegerRGB 표기법의 녹색 값입니다.
blueIntegerRGB 표기법의 파란색 값입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBackgrounds(color)

배경 색상의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 색상 CSS 표기법 (예: '#ffffff' 또는 'white')으로 되어 있습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

매개변수

이름유형설명
colorString[][]CSS 표기법으로 작성된 색상의 2차원 배열 (예: '#ffffff' 또는 'white'); null 값은 색상을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBorder(top, left, bottom, right, vertical, horizontal)

테두리 속성을 설정합니다. 유효한 값은 true (사용), false (사용 중지) 및 null (변동 없음)입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

매개변수

이름유형설명
topBoolean테두리는 true, 테두리는 false, 변경하지 않으려면 null입니다.
leftBoolean테두리는 true, 테두리는 false, 변경하지 않으려면 null입니다.
bottomBoolean테두리는 true, 테두리는 false, 변경하지 않으려면 null입니다.
rightBoolean테두리는 true, 테두리는 false, 변경하지 않으려면 null입니다.
verticalBoolean안쪽 세로 테두리는 true, 없음은 false, 변경하지 않으려면 null입니다.
horizontalBoolean안쪽 가로 테두리는 true, 없는 경우 false, 변경사항이 없는 경우 null입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

색상 및/또는 스타일로 테두리 속성을 설정합니다. 유효한 값은 true (사용), false (사용 중지) 및 null (변동 없음)입니다. 색상의 경우 CSS 표기법으로 색상 (예: '#ffffff' 또는 'white')을 사용합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);

매개변수

이름유형설명
topBoolean테두리는 true, 테두리는 false, 변경하지 않으려면 null입니다.
leftBoolean테두리는 true, 테두리는 false, 변경하지 않으려면 null입니다.
bottomBoolean테두리는 true, 테두리는 false, 변경하지 않으려면 null입니다.
rightBoolean테두리는 true, 테두리는 false, 변경하지 않으려면 null입니다.
verticalBoolean안쪽 세로 테두리는 true, 없음은 false, 변경하지 않으려면 null입니다.
horizontalBoolean안쪽 가로 테두리는 true, 없는 경우 false, 변경사항이 없는 경우 null입니다.
colorStringCSS 표기법의 색상 (예: '#ffffff' 또는 'white'), 기본 색상 (검은색)은 null입니다.
styleBorderStyle테두리의 스타일, 기본 스타일 (실선)의 경우 null

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setDataValidation(rule)

범위의 모든 셀에 하나의 데이터 확인 규칙을 설정합니다.

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

매개변수

이름유형설명
ruleDataValidation설정할 데이터 확인 규칙 또는 데이터 확인을 삭제하려면 null입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setDataValidations(rules)

범위의 모든 셀에 대한 데이터 확인 규칙을 설정합니다. 이 방법은 2차원 행별로 열별로 색인이 생성된 데이터 유효성 검사 배열입니다. 배열 차원은 범위 차원에 추가합니다.

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

매개변수

이름유형설명
rulesDataValidation[][]설정할 데이터 확인 규칙의 2차원 배열입니다. 값 null개 데이터 확인을 삭제합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontColor(color)

CSS 표기법 (예: '#ffffff' 또는 'white')으로 글꼴 색상을 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontColor("red");

매개변수

이름유형설명
colorStringCSS 표기법의 글꼴 색상 (예: '#ffffff' 또는 'white')입니다. a null 값은 색상을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontColorObject(color)

지정된 범위의 글꼴 색상을 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

매개변수

이름유형설명
colorColor설정할 글꼴 색상입니다. null 값은 색상을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontColorObjects(colors)

글꼴 색상의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

매개변수

이름유형설명
colorsColor[][]색상의 2차원 배열입니다. null 값은 글꼴 색상을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontColors(colors)

글꼴 색상의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 색상은 다음과 같습니다. CSS 표기법 (예: '#ffffff' 또는 'white')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

매개변수

이름유형설명
colorsObject[][]CSS 표기법으로 작성된 색상의 2차원 배열 (예: '#ffffff' 또는 'white'); null 값은 색상을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontFamilies(fontFamilies)

글꼴 모음의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 예시 글꼴 모음은 'Arial'입니다. 또는 'Helvetica'입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

매개변수

이름유형설명
fontFamiliesObject[][]글꼴 모음의 2차원 배열 null 값은 있습니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontFamily(fontFamily)

글꼴 모음을 설정합니다(예: "Arial"). 또는 'Helvetica'입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

매개변수

이름유형설명
fontFamilyString설정할 글꼴 모음입니다. null 값은 글꼴 모음을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontLine(fontLine)

지정된 범위 ('underline', 'line-through' 또는 'none')을 입력합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

매개변수

이름유형설명
fontLineString글꼴 선 스타일('underline', 'line-through' 또는 'none' null 값은 글꼴 선 스타일을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontLines(fontLines)

선 스타일의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

매개변수

이름유형설명
fontLinesObject[][]글꼴 선 스타일의 2차원 배열 ('underline', 'line-through' 또는 'none')입니다. null 값은 글꼴 선 스타일을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontSize(size)

사용할 포인트 크기로 글꼴 크기를 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontSize(20);

매개변수

이름유형설명
sizeInteger포인트 크기의 글꼴 크기입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontSizes(sizes)

글꼴 크기의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 크기는 포인트

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

매개변수

이름유형설명
sizesObject[][]크기의 2차원 배열입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontStyle(fontStyle)

지정된 범위 ('italic' 또는 'normal')의 글꼴 스타일을 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

매개변수

이름유형설명
fontStyleString글꼴 스타일('italic' 또는 'normal')입니다. null 값은 글꼴 스타일을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontStyles(fontStyles)

글꼴 스타일의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

매개변수

이름유형설명
fontStylesObject[][]글꼴 스타일의 2차원 배열('italic' 또는 'normal')입니다. null 값은 글꼴 스타일을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontWeight(fontWeight)

주어진 범위 (일반/굵게)의 글꼴 두께를 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

매개변수

이름유형설명
fontWeightString글꼴 두께('bold' 또는 'normal') null value는 글꼴 두께를 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontWeights(fontWeights)

글꼴 두께의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 예시 글꼴 두께가 '굵게' 표시되어 있습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

매개변수

이름유형설명
fontWeightsObject[][]글꼴 두께의 2차원 배열('bold' 또는 'normal')입니다. null 값은 글꼴 두께를 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFormula(formula)

이 범위의 수식을 업데이트합니다. 주어진 수식은 A1 표기법을 사용해야 합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

매개변수

이름유형설명
formulaString셀에 설정할 수식을 나타내는 문자열입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFormulaR1C1(formula)

이 범위의 수식을 업데이트합니다. 주어진 수식은 R1C1 표기법을 사용해야 합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

매개변수

이름유형설명
formulaString문자열 수식.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFormulas(formulas)

수식의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 주어진 공식 A1 표기법으로 표기해야 합니다. 이 메서드는 행별로 색인이 지정된 수식의 2차원 배열을 취하여 열 기준으로 그룹화합니다. 배열 차원은 범위 차원과 일치해야 합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

매개변수

이름유형설명
formulasString[][]수식의 2차원 문자열 배열입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFormulasR1C1(formulas)

수식의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 주어진 공식 R1C1 표기법을 사용해야 합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

매개변수

이름유형설명
formulasString[][]R1C1 형식의 2차원 배열 수식입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setHorizontalAlignment(alignment)

지정된 범위 (왼쪽/가운데/오른쪽)의 가로 (왼쪽에서 오른쪽) 정렬을 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

매개변수

이름유형설명
alignmentString정렬('left', 'center' 또는 'normal') a null 값은 정렬을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setHorizontalAlignments(alignments)

가로 정렬의 직사각형 그리드를 설정합니다. setHorizontalAlignment(alignment) 보기

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

매개변수

이름유형설명
alignmentsObject[][]정렬의 2차원 배열('left', 'center' 또는 'normal')입니다. null 값은 정렬을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

참고 항목


setNote(note)

메모를 지정된 값으로 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

매개변수

이름유형설명
noteString범위에 설정할 참고 값입니다. null 값은 메모를 삭제합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setNotes(notes)

메모의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

매개변수

이름유형설명
notesObject[][]메모의 2차원 배열입니다. null 값은 메모를 삭제합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

참고 항목


setNumberFormat(numberFormat)

숫자 또는 날짜 형식을 지정된 서식 문자열로 설정합니다. 허용되는 형식 패턴은 다음과 같습니다. Sheets API 문서에 설명되어 있습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

매개변수

이름유형설명
numberFormatString숫자 서식 문자열입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setNumberFormats(numberFormats)

숫자 또는 날짜 형식의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 이 값은 Sheets API 문서를 참조하세요.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

매개변수

이름유형설명
numberFormatsObject[][]숫자 형식의 2차원 배열입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setRichTextValue(value)

범위 내 셀의 서식 있는 텍스트 값을 설정합니다.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

매개변수

이름유형설명
valueRichTextValue원하는 서식 있는 텍스트 값입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setRichTextValues(values)

서식 있는 텍스트 값의 직사각형 그리드를 설정합니다.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

매개변수

이름유형설명
valuesRichTextValue[][]원하는 서식 있는 텍스트 값입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

범위에 하이퍼링크를 표시할지 여부를 설정합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can useSpreadsheetApp.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 A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

// Sets cell A30 to show hyperlinks.
range.setShowHyperlink(true);

매개변수

이름유형설명
showHyperlinkBoolean하이퍼링크를 표시할지 여부입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setTextDirection(direction)

범위 내 셀의 텍스트 방향을 설정합니다. 지정된 방향이 null인 경우 방향을 추론한 다음 설정합니다.

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

매개변수

이름유형설명
directionTextDirection원하는 텍스트 방향입니다. null이면 설정을 변경합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setTextDirections(directions)

텍스트 방향의 직사각형 그리드를 설정합니다. 지정된 방향이 null인 경우 추론된 다음 설정됩니다.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

매개변수

이름유형설명
directionsTextDirection[][]원하는 텍스트 방향입니다. 지정된 방향이 null인 경우 유추한 값을 기반으로 합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setTextRotation(degrees)

범위 내 셀의 텍스트 회전 설정을 지정합니다. 입력은 각 수정할 수 있습니다. 입력이 0이면 텍스트가 표준 방향으로 설정되어 있습니다.

텍스트 방향에서 양의 각도는 시계 반대 방향이므로 오른쪽에서 왼쪽으로는 시계 방향입니다.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

매개변수

이름유형설명
degreesInteger표준 방향과 원하는 방향 사이의 원하는 각도입니다. 왼쪽에서 오른쪽으로 쓰는 텍스트의 경우 양의 각도는 시계 반대 방향입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setTextRotation(rotation)

범위 내 셀의 텍스트 회전 설정을 지정합니다.

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

매개변수

이름유형설명
rotationTextRotation원하는 텍스트 회전 설정입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setTextRotations(rotations)

텍스트 회전의 직사각형 그리드를 설정합니다.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

매개변수

이름유형설명
rotationsTextRotation[][]원하는 텍스트 회전 설정입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setTextStyle(style)

범위 내 셀의 텍스트 스타일을 설정합니다.

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

매개변수

이름유형설명
styleTextStyle원하는 텍스트 스타일입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setTextStyles(styles)

텍스트 스타일의 직사각형 그리드를 설정합니다.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

매개변수

이름유형설명
stylesTextStyle[][]원하는 텍스트 스타일입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setValue(value)

범위의 값을 설정합니다. 이 값은 숫자, 문자열, 부울 또는 날짜일 수 있습니다. 시작하는 경우 '='이면 수식으로 해석됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setValue(100);

매개변수

이름유형설명
valueObject범위의 값입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setValues(values)

값의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 값이 =이면 수식으로 해석됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

매개변수

이름유형설명
valuesObject[][]값의 2차원 배열입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setVerticalAlignment(alignment)

지정된 범위 (상단/중간/하단)의 수직 (위에서 아래로) 정렬을 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

매개변수

이름유형설명
alignmentString정렬('top', 'middle' 또는 'bottom') a null 값은 정렬을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setVerticalAlignments(alignments)

수직 정렬의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

매개변수

이름유형설명
alignmentsObject[][]정렬의 2차원 배열('top', 'middle') 또는 'bottom' null 값은 정렬을 재설정합니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

참고 항목


setVerticalText(isVertical)

범위 내 셀의 텍스트를 쌓을지 여부를 설정합니다. 텍스트가 겹쳐서 표시되는 경우 세로 방향으로 기울이면 도 텍스트 회전 설정이 무시됩니다.

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

매개변수

이름유형설명
isVerticalBoolean텍스트를 쌓을지 여부를 나타냅니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setWrap(isWrapEnabled)

지정된 범위의 셀 줄바꿈을 설정합니다.

줄바꿈이 사용 설정된 셀 (기본값)은 크기가 조절되어 전체 콘텐츠를 표시합니다. 줄바꿈이 있는 셀 셀의 크기를 조절하거나 여러 줄로 실행하지 않고 셀에 최대한 많이 표시합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setWrap(true);

매개변수

이름유형설명
isWrapEnabledBoolean텍스트 줄바꿈 여부입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setWrapStrategies(strategies)

래핑 전략의 직사각형 그리드를 설정합니다.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

매개변수

이름유형설명
strategiesWrapStrategy[][]원하는 래핑 전략입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setWrapStrategy(strategy)

범위 내 셀의 텍스트 줄바꿈 전략을 설정합니다.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

매개변수

이름유형설명
strategyWrapStrategy원하는 래핑 전략입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setWraps(isWrapEnabled)

단어 줄바꿈 정책의 직사각형 그리드를 설정합니다 (이 범위의 크기와 일치해야 함). 다음이 포함된 셀 wrap 사용 설정 (기본값)의 크기를 조절하여 전체 콘텐츠를 표시합니다. 줄바꿈이 사용 중지된 셀 셀에 최대한 많이 표시되도록 하는 것이 좋습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

매개변수

이름유형설명
isWrapEnabledObject[][]래핑할지 여부를 결정하는 래핑 변수의 2차원 배열입니다. 지정할 수 있습니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

참고 항목


shiftColumnGroupDepth(delta)

범위의 열 그룹화 깊이를 지정된 양만큼 변경합니다.

이렇게 하면 상위 요소와 교차하는 그룹을 만들거나 수정 또는 삭제할 수 있습니다. 범위입니다. 양의 델타의 경우 그룹이 생성되거나 수정됩니다. 음수 델타의 경우 그룹은 손상되거나 수정되는 것입니다.

그룹 깊이를 0 미만 또는 8 이상으로 줄일 때는 아무런 영향을 미치지 않습니다.

column group control position가 다음과 같은 경우 BEFORE: 이동을 시도할 때 오류가 발생합니다. 첫 번째 행의 깊이입니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

매개변수

이름유형설명
deltaInteger이 범위의 열 그룹 깊이를 변경할 금액입니다.

리턴

Range - 체이닝을 위한 범위입니다.

생성 값

Error: 대조군 위치가 GroupControlTogglePosition.BEFORE입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

shiftRowGroupDepth(delta)

범위의 행 그룹화 깊이를 지정된 양만큼 변경합니다.

이렇게 하면 상위 요소와 교차하는 그룹을 만들거나 수정 또는 삭제할 수 있습니다. 범위입니다. 양의 델타의 경우 그룹이 생성되거나 수정됩니다. 음수 델타의 경우 그룹은 손상되거나 수정되는 것입니다.

그룹 깊이를 0 미만 또는 8 이상으로 줄일 때는 아무런 영향을 미치지 않습니다.

row group control positionBEFORE이면 첫 번째 행의 깊이입니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

매개변수

이름유형설명
deltaInteger이 범위의 행 그룹 깊이를 변경할 금액입니다.

리턴

Range - 체이닝을 위한 범위입니다.

생성 값

Error: 컨트롤이 실행될 때 첫 번째 행의 깊이를 이동하려고 하는 경우 게재순위: GroupControlTogglePosition.BEFORE

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

sort(sortSpecObj)

지정된 범위의 셀을 지정된 열 및 순서에 따라 정렬합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

매개변수

이름유형설명
sortSpecObjObject정렬 기준으로 사용할 열입니다.

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

splitTextToColumns()

자동 감지된 구분 기호를 기반으로 텍스트 열을 여러 열로 분할합니다.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

splitTextToColumns(delimiter)

지정된 문자열을 커스텀 구분 기호로 사용하여 텍스트 열을 여러 열로 분할합니다.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

매개변수

이름유형설명
delimiterString분할할 맞춤 구분 기호입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

splitTextToColumns(delimiter)

지정된 구분 기호에 따라 텍스트 열을 여러 열로 분할합니다.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

매개변수

이름유형설명
delimiterTextToColumnsDelimiter분할할 사전 설정된 구분 기호입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

trimWhitespace()

이 범위의 모든 셀에서 공백 (예: 공백, 탭, 새 줄)을 자릅니다. 삭제 각 셀 텍스트의 시작과 끝에서 모든 공백을 제거하고 공백 문자를 단일 공백으로 변환합니다.

<ph type="x-smartling-placeholder">

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

uncheck()

범위 내 체크박스의 상태를 '선택 해제됨'으로 변경합니다. 범위의 셀을 무시합니다. 현재 선택된 값 또는 선택 해제된 값이 포함되어 있지 않습니다.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'unchecked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

리턴

Range - 체이닝을 위한 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

지원 중단된 메서드