Class OpenLink

Link öffnen

Entwicklervorschau:Im Rahmen des Google Workspace-Entwicklervorschauprogramms verfügbar, das Vorabzugriff auf bestimmte Funktionen bietet.

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 =
    AddOnsResponseService.newActionResponseBuilder()
        .setOpenLink(
            AddOnsResponseService.newOpenLink()
                .setUrl('https://www.google.com')
                .setOpenAs(AddOnsResponseService.OpenAs.FULL_SIZE)
                .setOnClose(AddOnsResponseService.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 COOP-Header (Cross-Origin-Opener-Policy) 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 beim Öffnen fest.
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 URL-Tab geschlossen wird.

Parameter

Name	Typ	Beschreibung
onClose	OnClose	Die Schließeinstellung.

Rückflug

OpenLink: Dieses offene Linkobjekt für die Verkettung.

---

setOpenAs(openAs)

Legt das Verhalten der URL beim Öffnen fest.

Parameter

Name	Typ	Beschreibung
openAs	OpenAs	Die Öffnungseinstellung.

Rückflug

OpenLink: Dieses offene Linkobjekt für die Verkettung.

---

setUrl(url)

Legt die URL fest, die geöffnet werden soll. Die URL muss mit einem im Manifest auf der Zulassungsliste stehenden Präfix übereinstimmen.

Parameter

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

Rückflug

OpenLink: Dieses offene Linkobjekt für die Verkettung.