Class DataSourceFormula

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
데이터 소스 수식

기존 데이터 소스 수식에 액세스하고 수정합니다. 새 데이터 소스 수식을 만들려면 Range.setFormula(formula)를 사용하세요.

메서드

메서드반환 유형간략한 설명
forceRefreshData()DataSourceFormula현재 상태에 관계없이 이 객체의 데이터를 새로고침합니다.
getAnchorCell()Range이 데이터 소스 수식이 고정되어 있는 셀을 나타내는 Range를 반환합니다.
getDataSource()DataSource객체가 연결된 데이터 소스를 가져옵니다.
getDisplayValue()String데이터 소스 수식의 표시 값을 반환합니다.
getFormula()String이 데이터 소스 수식의 수식을 반환합니다.
getStatus()DataExecutionStatus객체의 데이터 실행 상태를 가져옵니다.
refreshData()DataSourceFormula객체의 데이터를 새로고침합니다.
setFormula(formula)DataSourceFormula수식을 업데이트합니다.
waitForCompletion(timeoutInSeconds)DataExecutionStatus현재 실행이 완료될 때까지 대기하고 제공된 시간(초)이 지나면 타임아웃됩니다.

자세한 문서

forceRefreshData()

현재 상태에 관계없이 이 객체의 데이터를 새로고침합니다. 자세한 내용은 refreshData()를 참고하세요.

데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution() 메서드를 사용하여 특정 데이터 소스 유형의 데이터 실행을 사용 설정합니다.

Return

DataSourceFormula: 데이터 객체입니다.

승인

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

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

getAnchorCell()

이 데이터 소스 수식이 고정되어 있는 셀을 나타내는 Range를 반환합니다.

Return

Range — 앵커 셀입니다.

승인

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

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

getDataSource()

객체가 연결된 데이터 소스를 가져옵니다.

Return

DataSource: 데이터 소스입니다.

승인

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

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

getDisplayValue()

데이터 소스 수식의 표시 값을 반환합니다.

Return

String: 표시 값입니다.

승인

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

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

getFormula()

이 데이터 소스 수식의 수식을 반환합니다.

Return

String — 수식

승인

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

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

getStatus()

객체의 데이터 실행 상태를 가져옵니다.

Return

DataExecutionStatus — 데이터 실행 상태입니다.

승인

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

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

refreshData()

객체의 데이터를 새로고침합니다.

현재 error 상태인 경우 예외가 발생합니다. DataSource#updateSpec()를 사용하여 사양을 업데이트합니다. 데이터 소스에서 예기치 않은 수정을 방지하기 위해 이 메서드는 forceRefreshData()보다 선호됩니다.

데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution() 메서드를 사용하여 특정 데이터 소스 유형의 데이터 실행을 사용 설정합니다.

Return

DataSourceFormula: 데이터 객체입니다.

승인

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

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

setFormula(formula)

수식을 업데이트합니다.

매개변수

이름유형설명
formulaString새 수식

Return

DataSourceFormula: 체이닝할 데이터 소스 수식입니다.

승인

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

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

waitForCompletion(timeoutInSeconds)

현재 실행이 완료될 때까지 대기하고 제공된 시간(초)이 지나면 타임아웃됩니다. 시간이 초과되었을 때 실행이 완료되지 않은 경우에는 예외가 발생하지만 데이터 실행이 취소되지는 않습니다.

매개변수

이름유형설명
timeoutInSecondsInteger데이터 실행을 기다리는 시간(초)입니다. 최대 300초입니다.

Return

DataExecutionStatus — 데이터 실행 상태입니다.

승인

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

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