기존 데이터 소스 수식에 액세스하고 수정합니다. 새 데이터 소스 수식을 만들려면 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()
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)
수식을 업데이트합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
formula | String | 새 수식 |
Return
DataSourceFormula: 체이닝할 데이터 소스 수식입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
현재 실행이 완료될 때까지 대기하고 제공된 시간(초)이 지나면 타임아웃됩니다. 시간이 초과되었을 때 실행이 완료되지 않은 경우에는 예외가 발생하지만 데이터 실행이 취소되지는 않습니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
timeoutInSeconds | Integer | 데이터 실행을 기다리는 시간(초)입니다. 최대 300초입니다. |
Return
DataExecutionStatus — 데이터 실행 상태입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets