Cette page a été traduite par l'API Cloud Translation.

Class OpenLink

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.
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 = CardService.newActionResponseBuilder()
                           .setOpenLink(
                               CardService.newOpenLink()
                                   .setUrl('https://www.google.com')
                                   .setOpenAs(CardService.OpenAs.FULL_SIZE)
                                   .setOnClose(CardService.OnClose.NOTHING),
                               )
                           .build();

Remarque:Pour recharger les modules complémentaires après la fermeture d'un lien, n'utilisez pas de lien avec l'en-tête COOP (Cross-Origin-Opener-Policy) 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 ne s'actualise pas.

Méthodes

Méthode	Type renvoyé	Brève description
`setOnClose(onClose)`	`OpenLink`	Définit le comportement de l'action de l'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)`

Définit le comportement de l'action de l'URL lorsque la fenêtre ou l'onglet de l'URL est fermé.

Paramètres

Nom	Type	Description
`onClose`	`OnClose`	Paramètre de fermeture.

Renvois

OpenLink : cet objet, pour le chaînage.

`setOpenAs(openAs)`

Définit le comportement de l'URL lorsqu'elle est ouverte.

Paramètres

Nom	Type	Description
`openAs`	`OpenAs`	Paramètre d'ouverture.

Renvois

OpenLink : cet objet, pour le chaînage.

`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 : cet objet, pour le chaînage.