Class CardHeader

KarteHeader

Der Header einer Card.

Verfügbar für Google Workspace-Add-ons und Google Chat-Apps.

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

Methoden

MethodeRückgabetypKurzbeschreibung
setImageAltText(imageAltText)CardHeaderHiermit wird der alternative Text für das Kopfzeilenbild festgelegt.
setImageStyle(imageStyle)CardHeaderHiermit wird das Zuschneiden des Symbols in der Kartenüberschrift festgelegt.
setImageUrl(imageUrl)CardHeaderHiermit wird das Bild festgelegt, das im Header verwendet werden soll. Geben Sie dazu die URL oder den Datenstring an.
setSubtitle(subtitle)CardHeaderHiermit wird der Untertitel der Kartenüberschrift festgelegt.
setTitle(title)CardHeaderHiermit wird der Titel der Kartenüberschrift festgelegt.

Detaillierte Dokumentation

setImageAltText(imageAltText)

Hiermit wird der alternative Text für das Kopfzeilenbild festgelegt.

Parameter

NameTypBeschreibung
imageAltTextStringDer alternative Text für das Kopfzeilenbild.

Rückflug

CardHeader – dieses Objekt, zur Verkettung


setImageStyle(imageStyle)

Hiermit wird das Zuschneiden des Symbols in der Kartenüberschrift festgelegt. Standardmäßig ist „Kein Zuschneiden“ ausgewählt. Optional.

Parameter

NameTypBeschreibung
imageStyleImageStyleDie Stileinstellung.

Rückflug

CardHeader – dieses Objekt, zur Verkettung


setImageUrl(imageUrl)

Hiermit wird das Bild festgelegt, das im Header verwendet werden soll. Geben Sie dazu die URL oder den Datenstring an.

Die angegebene URL kann entweder eine öffentlich zugängliche URL oder ein Base64-codierter Bildstring sein. Mit dem folgenden Code können Sie einen codierten Bildstring aus einem Bild in Google Drive erstellen und dann für die spätere Verwendung mit setImageUrl(imageUrl) speichern. Mit dieser Methode muss Ihr Add-on nicht auf eine öffentlich verfügbare Bild-URL zugreifen:

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

Parameter

NameTypBeschreibung
imageUrlStringDie URL-Adresse eines zu verwendenden gehosteten Bildes oder ein codierter Bildstring.

Rückflug

CardHeader – dieses Objekt, zur Verkettung


setSubtitle(subtitle)

Hiermit wird der Untertitel der Kartenüberschrift festgelegt. Optional.

Parameter

NameTypBeschreibung
subtitleStringDer Text des Anzeigenuntertitels.

Rückflug

CardHeader – dieses Objekt, zur Verkettung


setTitle(title)

Hiermit wird der Titel der Kartenüberschrift festgelegt. Erforderlich.

Parameter

NameTypBeschreibung
titleStringDen Headertext.

Rückflug

CardHeader – dieses Objekt, zur Verkettung