Class CardHeader

CardHeader (link em inglês)

O cabeçalho de um Card.

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

Métodos

MétodoTipo de retornoBreve descrição
setImageAltText(imageAltText)CardHeaderDefine o texto alternativo para a imagem do cabeçalho.
setImageStyle(imageStyle)CardHeaderDefine o corte do ícone no cabeçalho do cartão.
setImageUrl(imageUrl)CardHeaderDefine a imagem a ser usada no cabeçalho fornecendo o URL ou a string de dados.
setSubtitle(subtitle)CardHeaderDefine o subtítulo do cabeçalho do cartão.
setTitle(title)CardHeaderDefine o título do cabeçalho do card.

Documentação detalhada

setImageAltText(imageAltText)

Define o texto alternativo para a imagem do cabeçalho.

Parâmetros

NomeTipoDescrição
imageAltTextStringÉ o texto alternativo da imagem do cabeçalho.

Retornar

CardHeader: este objeto, para encadeamento.


setImageStyle(imageStyle)

Define o corte do ícone no cabeçalho do cartão. O padrão é sem corte. Opcional.

Parâmetros

NomeTipoDescrição
imageStyleImageStyleA configuração de estilo.

Retornar

CardHeader: este objeto, para encadeamento.


setImageUrl(imageUrl)

Define a imagem a ser usada no cabeçalho fornecendo o URL ou a string de dados.

O URL fornecido pode ser acessível publicamente ou uma string de imagem codificada em base64. Para ver a última opção, você pode usar o código a seguir para criar uma string de imagem codificada de uma imagem no Google Drive e, em seguida, armazenar essa string para uso posterior com setImageUrl(imageUrl). Esse método evita que o complemento acesse um URL de imagem disponível publicamente:

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

Parâmetros

NomeTipoDescrição
imageUrlStringEndereço de URL de uma imagem hospedada a ser usada ou uma string de imagem codificada.

Retornar

CardHeader: este objeto, para encadeamento.


setSubtitle(subtitle)

Define o subtítulo do cabeçalho do cartão. Opcional.

Parâmetros

NomeTipoDescrição
subtitleStringO texto do subtítulo do cabeçalho.

Retornar

CardHeader: este objeto, para encadeamento.


setTitle(title)

Define o título do cabeçalho do card. Obrigatório.

Parâmetros

NomeTipoDescrição
titleStringO texto do cabeçalho.

Retornar

CardHeader: este objeto, para encadeamento.