Class CardHeader

카드헤더

Card의 헤더입니다.

Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다. 

const cardHeader = CardService.newCardHeader()
                       .setTitle('Card header title')
                       .setSubtitle('Card header subtitle')
                       .setImageStyle(CardService.ImageStyle.CIRCLE)
                       .setImageUrl('https://image.png');

메서드

메서드반환 유형간략한 설명
setImageAltText(imageAltText)CardHeader헤더 이미지의 대체 텍스트를 설정합니다.
setImageStyle(imageStyle)CardHeader카드 헤더에서 아이콘 자르기를 설정합니다.
setImageUrl(imageUrl)CardHeaderURL 또는 데이터 문자열을 제공하여 헤더에 사용할 이미지를 설정합니다.
setSubtitle(subtitle)CardHeader카드 헤더의 부제목을 설정합니다.
setTitle(title)CardHeader카드 헤더의 제목을 설정합니다.

자세한 문서

setImageAltText(imageAltText)

헤더 이미지의 대체 텍스트를 설정합니다.

매개변수

이름유형설명
imageAltTextString헤더 이미지의 대체 텍스트입니다.

리턴

CardHeader: 연결을 위한 객체입니다.

setImageStyle(imageStyle)

카드 헤더에서 아이콘 자르기를 설정합니다. 기본값은 자르지 않음입니다. 선택사항입니다.

매개변수

이름유형설명
imageStyleImageStyle스타일 설정입니다.

리턴

CardHeader: 연결을 위한 객체입니다.

setImageUrl(imageUrl)

URL 또는 데이터 문자열을 제공하여 헤더에 사용할 이미지를 설정합니다.

제공된 URL은 공개적으로 액세스 가능한 URL 또는 base64로 인코딩된 이미지 문자열일 수 있습니다. 후자를 얻으려면 다음 코드를 사용하여 Google Drive의 이미지에서 인코딩된 이미지 문자열을 만든 다음 나중에 setImageUrl(imageUrl)와 함께 사용할 수 있도록 이 문자열을 저장하면 됩니다. 이 방법을 사용하면 부가기능이 공개적으로 사용 가능한 이미지 URL에 액세스할 필요가 없습니다. 

// The following assumes you have the image to use in Google Drive and have its
// ID.
const imageBytes = DriveApp.getFileById('123abc').getBlob().getBytes();
const encodedImageURL =
    `data:image/jpeg;base64,${Utilities.base64Encode(imageBytes)}`;

// You can store encodeImageURL and use it as a parameter to
// CardHeader.setImageUrl(imageUrl).

매개변수

이름유형설명
imageUrlString사용할 호스팅된 이미지의 URL 주소 또는 인코딩된 이미지 문자열입니다.

리턴

CardHeader: 연결을 위한 객체입니다.

setSubtitle(subtitle)

카드 헤더의 부제목을 설정합니다. 선택사항입니다.

매개변수

이름유형설명
subtitleString헤더 부제목 텍스트입니다.

리턴

CardHeader: 연결을 위한 객체입니다.

setTitle(title)

카드 헤더의 제목을 설정합니다. 필수 항목입니다.

매개변수

이름유형설명
titleString헤더 텍스트입니다.

리턴

CardHeader: 연결을 위한 객체입니다.