Class CellImage

셀 이미지

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

속성

속성유형설명
valueTypeValueTypeValueType.IMAGE로 설정된 필드. 이미지 값 유형을 나타냅니다.

메서드

메서드반환 유형간략한 설명
getAltTextDescription()String이 이미지의 대체 텍스트 설명을 반환합니다.
getAltTextTitle()String이 이미지의 대체 텍스트 제목을 반환합니다.
getContentUrl()StringGoogle에서 호스팅하는 이미지의 URL을 반환합니다.
getUrl()String이미지의 소스 URL을 가져옵니다. URL을 사용할 수 없는 경우 null를 반환합니다.
toBuilder()CellImageBuilder이미지를 셀 안에 배치할 수 있도록 이미지를 이미지 값 유형으로 변환하는 빌더를 만듭니다.

자세한 문서

getAltTextDescription()

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

Return

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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

getAltTextTitle()

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

Return

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

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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

getContentUrl()

Google에서 호스팅하는 이미지의 URL을 반환합니다. 이 URL은 요청자의 계정으로 태그되므로 URL이 있는 사용자는 누구나 원래 요청자로서 이미지에 효과적으로 액세스할 수 있습니다. 스프레드시트의 공유 설정이 변경되면 이미지에 액세스할 수 없게 됩니다. 반환된 URL은 짧은 시간 후에 만료됩니다.

Return

String: Google에서 호스팅하는 이미지의 URL입니다.


getUrl()

이미지의 소스 URL을 가져옵니다. URL을 사용할 수 없는 경우 null를 반환합니다. API를 사용하여 URL로 이미지를 삽입한 경우 이 메서드는 이미지 삽입 중에 제공된 URL을 반환합니다.

Return

String: 이미지 URL이 있는 경우, 이미지를 사용할 수 없거나 소스 URL이 없는 경우 null를 반환합니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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

toBuilder()

이미지를 셀 안에 배치할 수 있도록 이미지를 이미지 값 유형으로 변환하는 빌더를 만듭니다. 이미지를 셀에 배치하기 전에 이미지 값 유형으로 생성해야 합니다. 그런 다음 Range.setValue(value) 또는 Range.setValues(values)를 사용하여 셀에 추가할 수 있습니다.

Return

CellImageBuilder — 지정된 이미지 속성을 기반으로 이미지 값 유형을 만드는 빌더입니다.