Class CardHeader

CardHeader

Der Header eines Card.

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

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

Methoden

MethodeRückgabetypKurzbeschreibung
setImageAltText(imageAltText)CardHeaderLegt den alternativen Text für das Kopfzeilenbild fest.
setImageStyle(imageStyle)CardHeaderLegt fest, wie das Symbol in der Kopfzeile der Karte zugeschnitten wird.
setImageUrl(imageUrl)CardHeaderLegt die URL oder die Datenzeichenfolge des Bildes fest, das im Header verwendet werden soll.
setSubtitle(subtitle)CardHeaderLegt den Untertitel der Kartenüberschrift fest.
setTitle(title)CardHeaderLegt den Titel der Kartenüberschrift fest.

Detaillierte Dokumentation

setImageAltText(imageAltText)

Legt den alternativen Text für das Kopfzeilenbild fest.

Parameter

NameTypBeschreibung
imageAltTextStringDer alternative Text für das Kopfzeilenbild.

Rückflug

CardHeader: Dieses Objekt zur Verkettung.


setImageStyle(imageStyle)

Legt fest, wie das Symbol in der Kopfzeile der Karte zugeschnitten wird. Die Standardeinstellung ist „Kein Zuschneiden“. Optional.

Parameter

NameTypBeschreibung
imageStyleImageStyleDie Stileinstellung.

Rückflug

CardHeader: Dieses Objekt zur Verkettung.


setImageUrl(imageUrl)

Legt die URL oder die Datenzeichenfolge des Bildes fest, das im Header verwendet werden soll.

Die angegebene URL kann entweder eine öffentlich zugängliche URL oder ein base64-codierter Bildstring sein. Um Letzteres zu erhalten, können Sie mit dem folgenden Code eine codierte Image-Zeichenfolge aus einem Bild in Google Drive und speichern Sie diesen String zur späteren Verwendung mit setImageUrl(imageUrl). Mit dieser Methode ist es nicht notwendig, dass Ihr Add-on auf ein öffentliches Verfügbare Bild-URL:

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

Parameter

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

Rückflug

CardHeader: Dieses Objekt zur Verkettung.


setSubtitle(subtitle)

Legt den Untertitel der Kartenüberschrift fest. Optional.

Parameter

NameTypBeschreibung
subtitleStringUntertiteltext der Überschrift

Rückflug

CardHeader: Dieses Objekt zur Verkettung.


setTitle(title)

Legt den Titel der Kartenüberschrift fest. Erforderlich.

Parameter

NameTypBeschreibung
titleStringDer Text der Überschrift.

Rückflug

CardHeader: Dieses Objekt zur Verkettung.