Class CardHeader

Encabezado de la tarjeta

El encabezado de un Card.

Disponible para los complementos de Google Workspace y las apps de Google Chat.

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

Métodos

MétodoTipo de datos que se muestraDescripción breve
setImageAltText(imageAltText)CardHeaderEstablece el texto alternativo para la imagen del encabezado.
setImageStyle(imageStyle)CardHeaderEstablece el recorte del ícono en el encabezado de la tarjeta.
setImageUrl(imageUrl)CardHeaderEstablece la imagen que se usará en el encabezado proporcionando su URL o cadena de datos.
setSubtitle(subtitle)CardHeaderEstablece el subtítulo del encabezado de la tarjeta.
setTitle(title)CardHeaderEstablece el título del encabezado de la tarjeta.

Documentación detallada

setImageAltText(imageAltText)

Establece el texto alternativo para la imagen del encabezado.

Parámetros

NombreTipoDescripción
imageAltTextStringEs el texto alternativo de la imagen del encabezado.

Volver

CardHeader: Este objeto, para encadenar.


setImageStyle(imageStyle)

Establece el recorte del ícono en el encabezado de la tarjeta. La configuración predeterminada es sin recorte. Opcional.

Parámetros

NombreTipoDescripción
imageStyleImageStyleLa configuración de estilo

Volver

CardHeader: Este objeto, para encadenar.


setImageUrl(imageUrl)

Establece la imagen que se usará en el encabezado proporcionando su URL o cadena de datos.

La URL proporcionada puede ser una URL de acceso público o una cadena de imagen codificada en base64. Para obtener lo último, puedes usar el siguiente código para crear una cadena de imagen codificada a partir de una imagen en tu Google Drive y, luego, almacenar esa cadena para usarla más adelante con setImageUrl(imageUrl). Este método evita que el complemento deba acceder a una URL de imagen disponible públicamente:

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

Parámetros

NombreTipoDescripción
imageUrlStringEs la dirección URL de una imagen alojada que se usará o una cadena de imagen codificada.

Volver

CardHeader: Este objeto, para encadenar.


setSubtitle(subtitle)

Establece el subtítulo del encabezado de la tarjeta. Opcional.

Parámetros

NombreTipoDescripción
subtitleStringEs el texto del subtítulo del encabezado.

Volver

CardHeader: Este objeto, para encadenar.


setTitle(title)

Establece el título del encabezado de la tarjeta. Obligatorio.

Parámetros

NombreTipoDescripción
titleStringEs el texto del encabezado.

Volver

CardHeader: Este objeto, para encadenar.