Class CellImage

셀이미지

셀의 이미지 값을 나타냅니다. 셀에 이미지를 추가하려면 SpreadsheetApp.newCellImage() 및 CellImageBuilder를 사용하여 이미지의 새 이미지 값을 만들어야 합니다. 그런 다음 Range.setValue(value) 또는 Range.setValues(values)를 사용하여 이미지 값을 셀에 추가할 수 있습니다.

속성

속성유형설명
valueTypeValueType셀 이미지의 값 유형으로 ValueType.IMAGE입니다.

메서드

메서드반환 유형간략한 설명
getAltTextDescription()String이 이미지의 대체 텍스트 설명을 반환합니다.
getAltTextTitle()String이 이미지의 대체 텍스트 제목을 반환합니다.
getContentUrl()StringGoogle에서 호스팅하는 이미지 URL을 반환합니다.
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은 잠시 후 만료됩니다. 

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: 지정된 이미지 속성을 기반으로 이미지 값 유형을 만드는 빌더입니다.

지원 중단된 메서드