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)
setOpenAs(openAs)
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.