Représente une action permettant d'ouvrir un lien avec certaines options.
Disponible avec 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 pour lequel l'en-tête Cross-Origin-Opener-Policy (COOP) est activé. Si COOP est activé dans un lien, les modules complémentaires ne peuvent pas détecter l'état de la fenêtre et la fiche 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 est fermé. |
setOpenAs(openAs) | OpenLink | Définit le comportement de l'URL lorsqu'elle est ouverte. |
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 pour le chaînage.