Représente une action permettant d'ouvrir un lien avec certaines options.
Disponible pour les modules complémentaires Google Workspace et les applications Google Chat.
// 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();
Remarque:Pour actualiser les modules complémentaires après avoir fermé un lien, n'utilisez pas de lien avec En-tête COOP (Cross-Origin-Opener-Policy) activé. Si COOP est activé dans un lien, les modules complémentaires ne peuvent pas l'état de la fenêtre, et la carte du module complémentaire n'est pas mise à jour.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
setOnClose(onClose) | OpenLink | Définit le comportement de l'action d'URL lorsque la fenêtre ou l'onglet de l'URL sont fermés. |
setOpenAs(openAs) | OpenLink | Définit le comportement de l'URL lors de son ouverture. |
setUrl(url) | OpenLink | Définit l'URL à ouvrir. |
Documentation détaillée
setOnClose(onClose)
setOpenAs(openAs)
setUrl(url)
Définit l'URL à ouvrir. L'URL doit correspondre à un préfixe ajouté à la liste blanche dans le fichier manifeste.
Paramètres
Nom | Type | Description |
---|---|---|
url | String | URL à ouvrir. |
Renvois
OpenLink
: objet utilisé pour le chaînage.