Class OpenLink

OpenLink

Eine Aktion zum Öffnen eines Links mit einigen Optionen.

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

// A button that opens as a link in an overlay and
// requires a reload when closed.
var button = CardService.newTextButton()
    .setText("This button opens a link in an overlay window")
    .setOpenLink(CardService.newOpenLink()
        .setUrl("https://www.google.com")
        .setOpenAs(CardService.OpenAs.OVERLAY)
        .setOnClose(CardService.OnClose.RELOAD_ADD_ON));

// An action response that opens a link in full screen and
// requires no action when closed.
var actionResponse = CardService.newActionResponseBuilder()
    .setOpenLink(CardService.newOpenLink()
        .setUrl("https://www.google.com")
        .setOpenAs(CardService.OpenAs.FULL_SIZE)
        .setOnClose(CardService.OnClose.NOTHING))
    .build();

Hinweis:Wenn Sie Add-ons nach dem Schließen eines Links neu laden möchten, verwenden Sie keinen Link mit COOP-Header (Cross-Origin-Opener-Policy) aktiviert. Wenn COOP in einer Verknüpfung aktiviert ist, können Add-ons nicht den Fensterstatus erkennen und die Add-on-Karte nicht aktualisiert wird.

Methoden

MethodeRückgabetypKurzbeschreibung
setOnClose(onClose)OpenLinkLegt das Verhalten der URL-Aktion fest, wenn das URL-Fenster oder der Tab geschlossen wird.
setOpenAs(openAs)OpenLinkLegt das Verhalten der URL fest, wenn sie geöffnet wird.
setUrl(url)OpenLinkLegt die URL fest, die geöffnet werden soll.

Detaillierte Dokumentation

setOnClose(onClose)

Legt das Verhalten der URL-Aktion fest, wenn das URL-Fenster oder der Tab geschlossen wird.

Parameter

NameTypBeschreibung
onCloseOnCloseDie Abschlusseinstellung.

Rückflug

OpenLink: Dieses Objekt zur Verkettung.


setOpenAs(openAs)

Legt das Verhalten der URL fest, wenn sie geöffnet wird.

Parameter

NameTypBeschreibung
openAsOpenAsDie Anfangseinstellung.

Rückflug

OpenLink: Dieses Objekt zur Verkettung.


setUrl(url)

Legt die URL fest, die geöffnet werden soll. Die URL muss mit einem Präfix übereinstimmen, das in der weißen Liste Manifestdatei.

Parameter

NameTypBeschreibung
urlStringDie zu öffnende URL.

Rückflug

OpenLink: Dieses Objekt zur Verkettung.