Class OpenLink

OpenLink

Representa una acción para abrir un vínculo con algunas opciones.

Está disponible para complementos de Google Workspace y apps de 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();

Nota: Para volver a cargar los complementos después de cerrar un vínculo, no uses un vínculo que tenga habilitado el encabezado Cross-Origin-Opener-Policy (COOP). Si la cooperación está habilitada en un vínculo, los complementos no pueden detectar el estado de la ventana y no se actualiza la tarjeta del complemento.

Métodos

MétodoTipo de datos que se muestraDescripción breve
setOnClose(onClose)OpenLinkEstablece el comportamiento de la acción de URL cuando se cierra la ventana o pestaña de la URL.
setOpenAs(openAs)OpenLinkEstablece el comportamiento de la URL cuando se abre.
setUrl(url)OpenLinkEstablece la URL que se abrirá.

Documentación detallada

setOnClose(onClose)

Establece el comportamiento de la acción de URL cuando se cierra la ventana o pestaña de la URL.

Parámetros

NombreTipoDescripción
onCloseOnCloseLa configuración de cierre.

Devolvedor

OpenLink: Este objeto se usa para encadenar.


setOpenAs(openAs)

Establece el comportamiento de la URL cuando se abre.

Parámetros

NombreTipoDescripción
openAsOpenAsEs la configuración de apertura.

Devolvedor

OpenLink: Este objeto se usa para encadenar.


setUrl(url)

Establece la URL que se abrirá. La URL debe coincidir con un prefijo incluido en la lista blanca del manifiesto.

Parámetros

NombreTipoDescripción
urlStringLa URL que se abrirá.

Devolvedor

OpenLink: Este objeto se usa para encadenar.