Class OpenLink

Link öffnen

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

MethodeRückgabetypKurzbeschreibung
setOnClose(onClose)OpenLinkHiermit wird das Verhalten der URL-Aktion festgelegt, wenn das URL-Fenster oder der URL-Tab geschlossen wird.
setOpenAs(openAs)OpenLinkHiermit wird das Verhalten der URL beim Öffnen festgelegt.
setUrl(url)OpenLinkLegt 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

NameTypBeschreibung
onCloseOnCloseDie 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

NameTypBeschreibung
openAsOpenAsDie Ö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

NameTypBeschreibung
urlStringDie URL, die geöffnet werden soll.

Rückflug

OpenLink – dieses Objekt, zur Verkettung