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.
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, bei dem 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	Legt das Verhalten der URL-Aktion fest, wenn das URL-Fenster oder der URL-Tab geschlossen wird.
setOpenAs(openAs)	OpenLink	Legt das Verhalten der URL fest, wenn sie geöffnet wird.
setUrl(url)	OpenLink	Legt die zu öffnende URL fest.

Detaillierte Dokumentation

setOnClose(onClose)

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

Parameter

Name	Typ	Beschreibung
onClose	OnClose	Die Schließeinstellung.

Rückflug

OpenLink : Dieses Objekt zum Verketten.

---

setOpenAs(openAs)

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

Parameter

Name	Typ	Beschreibung
openAs	OpenAs	Die Öffnungseinstellung.

Rückflug

OpenLink : Dieses Objekt zum Verketten.

---

setUrl(url)

Legt die zu öffnende URL fest. Die URL muss mit einem Präfix in der Zulassungsliste des Manifests übereinstimmen.

Parameter

Name	Typ	Beschreibung
url	String	Die zu öffnende URL.

Rückflug

OpenLink : Dieses Objekt zum Verketten.