Class CellImageBuilder

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

리턴

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

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

리턴

String — 대체 텍스트 설명입니다.

승인

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

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

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

리턴

String — 대체 텍스트 제목입니다.

승인

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

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

이미지의 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입니다.

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

매개변수

리턴

CellImage — 이 이미지(연결용)

승인

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

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

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

매개변수

리턴

CellImage — 이 이미지(연결용)

승인

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

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

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

매개변수

리턴

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