Diese Seite wurde von der Cloud Translation API übersetzt.

Class 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

Methode	Rückgabetyp	Kurzbeschreibung
`setOnClose(onClose)`	`OpenLink`	Legt das Verhalten der URL-Aktion fest, wenn das URL-Fenster oder der Tab geschlossen wird.
`setOpenAs(openAs)`	`OpenLink`	Legt das Verhalten der URL fest, wenn sie geöffnet wird.
`setUrl(url)`	`OpenLink`	Legt 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

Name	Typ	Beschreibung
`onClose`	`OnClose`	Die Abschlusseinstellung.

Rückflug

OpenLink: Dieses Objekt zur Verkettung.

`setOpenAs(openAs)`

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

Parameter

Name	Typ	Beschreibung
`openAs`	`OpenAs`	Die 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

Name	Typ	Beschreibung
`url`	`String`	Die zu öffnende URL.

Rückflug

OpenLink: Dieses Objekt zur Verkettung.