Diese Seite wurde von der Cloud Translation API übersetzt.

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`setOnClose(onClose)`	`OpenLink`	Hiermit wird das Verhalten der URL-Aktion festgelegt, wenn das URL-Fenster oder der URL-Tab geschlossen wird.
`setOpenAs(openAs)`	`OpenLink`	Hiermit wird das Verhalten der URL beim Öffnen festgelegt.
`setUrl(url)`	`OpenLink`	Legt die zu öffnende URL fest.

Detaillierte Dokumentation

`setOnClose(onClose)`

Hiermit wird das Verhalten der URL-Aktion festgelegt, wenn das URL-Fenster oder der URL-Tab geschlossen wird.

Parameter

Name	Typ	Beschreibung
`onClose`	`OnClose`	Die Einstellung für das Schließen.

Rückflug

OpenLink – dieses Objekt, zur Verkettung

`setOpenAs(openAs)`

Hiermit wird das Verhalten der URL beim Öffnen festgelegt.

Parameter

Name	Typ	Beschreibung
`openAs`	`OpenAs`	Die Öffnungseinstellung.

Rückflug

OpenLink – dieses Objekt, zur Verkettung

`setUrl(url)`

Legt die zu öffnende URL fest. Die URL muss mit einem Präfix übereinstimmen, das im Manifest auf der Zulassungsliste steht.

Parameter

Name	Typ	Beschreibung
`url`	`String`	Die URL, die geöffnet werden soll.

Rückflug

OpenLink – dieses Objekt, zur Verkettung