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

內容詳盡的說明文件

setImageAltText(imageAltText)

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

參數

名稱	類型	說明
imageAltText	String	標頭圖片的替代文字。

回攻員

CardHeader：這個物件用於鏈結。

---

setImageStyle(imageStyle)

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

參數

名稱	類型	說明
imageStyle	ImageStyle	樣式設定。

回攻員

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).

參數

名稱	類型	說明
imageUrl	String	要使用的代管圖片網址或編碼圖片字串。

回攻員

CardHeader：這個物件用於鏈結。

---

setSubtitle(subtitle)

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

參數

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

回攻員

CardHeader：這個物件用於鏈結。

---

setTitle(title)

設定資訊卡標題的標題。必填。

參數

名稱	類型	說明
title	String	標頭文字。

回攻員

CardHeader：這個物件用於鏈結。