本頁面由 Cloud Translation API 翻譯而成。

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：這個物件用於鏈結。