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 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)`

Définit le comportement de l'action d'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 : 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 : 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 : objet pour le chaînage.