Class CellImageBuilder

CellImageBuilder

CellImage의 빌더입니다. 이 빌더는 셀에 이미지를 추가하는 데 필요한 이미지 값을 만듭니다.

속성

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

메서드

메서드반환 유형간략한 설명
build()CellImage셀에 이미지를 추가하는 데 필요한 이미지 값 유형을 만듭니다.
getAltTextDescription()String이 이미지의 대체 텍스트 설명을 반환합니다.
getAltTextTitle()String이 이미지의 대체 텍스트 제목을 반환합니다.
getContentUrl()StringGoogle에서 호스팅하는 이미지 URL을 반환합니다.
setAltTextDescription(description)CellImage이 이미지의 대체 텍스트 설명을 설정합니다.
setAltTextTitle(title)CellImage이 이미지의 대체 텍스트 제목을 설정합니다.
setSourceUrl(url)CellImageBuilder이미지 소스 URL을 설정합니다.
toBuilder()CellImageBuilder현재 이미지 속성을 기반으로 셀 이미지 빌더를 만듭니다.

자세한 문서

build()

셀에 이미지를 추가하는 데 필요한 이미지 값 유형을 만듭니다. 이미지 값은 소스 URL과 같이 빌더에 추가된 이미지 속성에서 빌드됩니다.

리턴

CellImage: 셀에 추가할 이미지의 표현입니다.

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입니다.

setAltTextDescription(description)

이 이미지의 대체 텍스트 설명을 설정합니다.

매개변수

이름유형설명
descriptionString이미지의 새 대체 텍스트 설명입니다.

리턴

CellImage: 체이닝에 이 이미지가 반환됩니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

setAltTextTitle(title)

이 이미지의 대체 텍스트 제목을 설정합니다.

매개변수

이름유형설명
titleString이미지의 새 대체 텍스트 제목입니다.

리턴

CellImage: 체이닝에 이 이미지가 반환됩니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

setSourceUrl(url)

이미지 소스 URL을 설정합니다.

매개변수

이름유형설명
urlString이미지의 URL입니다.

리턴

CellImageBuilder: 체이닝을 위한 이 빌더

toBuilder()

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

지원 중단된 메서드