Class CardHeader

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)CardHeader提供圖片網址或資料字串，設定要在標題中使用的圖片。
setSubtitle(subtitle)CardHeader設定資訊卡標題的副標題。
setTitle(title)CardHeader設定資訊卡標題。

內容詳盡的說明文件

setImageAltText(imageAltText)

設定標題圖片的替代文字。

參數

名稱類型說明
imageAltTextString標題圖片的替代文字。

回攻員

CardHeader - 這個物件，用於鏈結。

setImageStyle(imageStyle)

設定資訊卡標題中的圖示裁剪方式。預設為不裁剪。選填。

參數

名稱類型說明
imageStyleImageStyle樣式設定。

回攻員

CardHeader - 這個物件，用於鏈結。

setImageUrl(imageUrl)

提供圖片網址或資料字串，設定要在標題中使用的圖片。

提供的網址可以是可公開存取的網址，也可以是 base64 編碼的圖片字串。 如要取得後者，可以使用下列程式碼從 Google 雲端硬碟中的圖片建立編碼圖片字串，然後儲存該字串，以便稍後搭配 setImageUrl(imageUrl) 使用。這個方法可避免外掛程式存取公開圖片網址：

// 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要使用的代管圖片網址，或編碼圖片字串。

回攻員

CardHeader - 這個物件，用於鏈結。

setSubtitle(subtitle)

設定資訊卡標題的副標題。選填。

參數

名稱類型說明
subtitleString標題副標題文字。

回攻員

CardHeader - 這個物件，用於鏈結。

setTitle(title)

設定資訊卡標題。必填。

參數

名稱類型說明
titleString標頭文字。

回攻員

CardHeader - 這個物件，用於鏈結。