셀에 추가할 이미지를 나타냅니다. 셀에 이미지를 추가하려면 SpreadsheetApp.newCellImage() 및 CellImageBuilder를 사용하여 이미지의 새 이미지 값을 만들어야 합니다. 그런 다음 Range.setValue(value) 또는 Range.setValues(values)를 사용하여 셀에 이미지 값을 추가할 수 있습니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
valueType | ValueType | 이미지 값 유형을 나타내는 ValueType.IMAGE로 설정된 필드 |
방법
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
getAltTextDescription() | String | 이미지의 대체 텍스트 설명을 반환합니다. |
getAltTextTitle() | String | 이미지의 대체 텍스트 제목을 반환합니다. |
getContentUrl() | String | 이미지에 Google 호스팅 URL을 반환합니다. |
getUrl() | String | 이미지의 소스 URL을 가져옵니다. URL을 사용할 수 없으면 null를 반환합니다. |
toBuilder() | CellImageBuilder | 셀에 이미지를 배치할 수 있도록 이미지를 이미지 값 유형으로 변환하는 빌더를 만듭니다. |
자세한 문서
getAltTextDescription()
이미지의 대체 텍스트 설명을 반환합니다.
리턴
String - 대체 텍스트 설명입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
이미지의 대체 텍스트 제목을 반환합니다.
리턴
String - 대체 텍스트 제목입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getContentUrl()
이미지에 Google 호스팅 URL을 반환합니다. 이 URL에는 요청자의 계정으로 태그가 지정되므로 URL이 있는 모든 사용자는 실질적으로 원래 요청자로서 이미지에 액세스할 수 있습니다. 스프레드시트의 공유 설정이 변경되면 이미지에 대한 액세스 권한이 손실될 수 있습니다. 반환된 URL은 잠시 후에 만료됩니다.
리턴
String - Google에서 호스팅하는 이미지의 URL입니다.
getUrl()
이미지의 소스 URL을 가져옵니다. URL을 사용할 수 없으면 null를 반환합니다. API를 사용하여 URL로 이미지를 삽입한 경우 이 메서드는 이미지 삽입 중에 제공된 URL을 반환합니다.
리턴
String - 이미지 URL(사용 가능한 경우). 이미지를 사용할 수 없거나 소스 URL이 없으면 null를 반환합니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
toBuilder()
셀에 이미지를 배치할 수 있도록 이미지를 이미지 값 유형으로 변환하는 빌더를 만듭니다. 이미지를 셀에 배치하려면 먼저 이미지를 이미지 값 유형으로 만들어야 합니다.
그런 다음 Range.setValue(value) 또는 Range.setValues(values)를 사용하여 셀에 추가하면 됩니다.
리턴
CellImageBuilder - 지정된 이미지 속성을 기반으로 이미지 값 유형을 만드는 빌더입니다.