Class OpenLink

OpenLink

Stellt eine Aktion zum Öffnen eines Links mit einigen Optionen dar.

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 aktiviertem COOP-Header (Cross-Origin-Opener-Policy). Wenn COOP in einem Link aktiviert ist, können Add-ons den Fensterstatus nicht erkennen und die Add-on-Karte wird nicht aktualisiert.

Methoden

MethodeRückgabetypKurzbeschreibung
setOnClose(onClose)OpenLinkLegt das Verhalten der URL-Aktion beim Schließen des URL-Fensters oder -Tabs fest.
setOpenAs(openAs)OpenLinkLegt das Verhalten der URL beim Öffnen fest.
setUrl(url)OpenLinkLegt die URL fest, die geöffnet werden soll.

Detaillierte Dokumentation

setOnClose(onClose)

Legt das Verhalten der URL-Aktion beim Schließen des URL-Fensters oder -Tabs fest.

Parameters

NameTypBeschreibung
onCloseOnCloseDie Einstellung für den Abschluss des Vorgangs.

Return

OpenLink: Dieses Objekt zur Verkettung.


setOpenAs(openAs)

Legt das Verhalten der URL beim Öffnen fest.

Parameters

NameTypBeschreibung
openAsOpenAsDie öffnende Einstellung.

Return

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 im Manifest auf die weiße Liste gesetzt wurde.

Parameters

NameTypBeschreibung
urlStringDie zu öffnende URL.

Return

OpenLink: Dieses Objekt zur Verkettung.