Class CellImage

CellImage

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

속성

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