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

Class CardHeader

Card 的標頭。

適用於 Google Workspace 外掛程式和 Google Chat 應用程式。

var 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.
var imageBytes = DriveApp.getFileById(imageID).getBlob().getBytes();
var 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：這個物件用於鏈結。