Class CellImage

셀이미지

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

속성

속성유형설명
valueTypeValueType이미지 값 유형을 나타내며 ValueType.IMAGE로 설정된 필드입니다.

메서드

메서드반환 유형간략한 설명
getAltTextDescription()String이 이미지의 대체 텍스트 설명을 반환합니다.
getAltTextTitle()String이 이미지의 대체 텍스트 제목을 반환합니다.
getContentUrl()StringGoogle에서 호스팅하는 이미지 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: 지정된 이미지 속성을 기반으로 이미지 값 유형을 만드는 빌더입니다.