셀의 이미지 값을 나타냅니다. 셀에 이미지를 추가하려면 SpreadsheetApp.newCellImage() 및 CellImageBuilder를 사용하여 이미지의 새 이미지 값을 만들어야 합니다. 그런 다음 Range.setValue(value) 또는 Range.setValues(values)를 사용하여 이미지 값을 셀에 추가할 수 있습니다.
속성
| 속성 | 유형 | 설명 |
|---|---|---|
value | Value | 셀 이미지의 값 유형으로, Value입니다. |
메서드
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
get | String | 이 이미지의 대체 텍스트 설명을 반환합니다. |
get | String | 이 이미지의 대체 텍스트 제목을 반환합니다. |
get | String | 이미지의 Google 호스팅 URL을 반환합니다. |
to | Cell | 현재 이미지 속성을 기반으로 셀 이미지 작성기를 만듭니다. |
자세한 문서
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은 짧은 시간 후에 만료됩니다.
const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { console.log(value.getContentUrl()); }
리턴
String — 이미지의 Google 호스팅 URL입니다.
toBuilder()
현재 이미지 속성을 기반으로 셀 이미지 작성기를 만듭니다. CellImageBuilder.setSourceUrl(url)을 사용하여 새 이미지의 소스 URL을 설정합니다. 그런 다음 Range.setValue(value) 또는 Range.setValues(values)를 사용하여 셀에 추가할 수 있습니다.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const range = ss.getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { const newImage = value.toBuilder() .setSourceUrl( 'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png', ) .build(); const newRange = ss.getRange("Sheet1!A2"); newRange.setValue(newImage); }
리턴
CellImageBuilder — 지정된 이미지 속성을 기반으로 이미지 값 유형을 만드는 작성기입니다.