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. 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 aktiviertem COOP-Header (Cross-Origin-Opener-Policy). 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 beim Schließen des URL-Fensters oder -Tabs fest. |
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)
setOpenAs(openAs)
setUrl(url)
Legt die URL fest, die geöffnet werden soll. Die URL muss mit einem Präfix übereinstimmen, das im Manifest auf die weiße Liste gesetzt wurde.
Parameters
Name | Typ | Beschreibung |
---|---|---|
url | String | Die zu öffnende URL. |
Return
OpenLink
: Dieses Objekt zur Verkettung.