Class OpenLink

AbrirVínculo

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

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.
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();

Nota: Para volver a cargar los complementos después de cerrar un vínculo, no uses un vínculo con el encabezado de política de apertura de origen cruzado (COOP) habilitado. Si la COOP está habilitada en un vínculo, los complementos no pueden detectar el estado de la ventana y la tarjeta del complemento no se actualiza.

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 la 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 la pestaña de la URL.

Parámetros

NombreTipoDescripción
onCloseOnCloseEl parámetro de configuración de cierre.

Volver

OpenLink: Este objeto, para encadenar.

setOpenAs(openAs)

Establece el comportamiento de la URL cuando se abre.

Parámetros

NombreTipoDescripción
openAsOpenAsEs el parámetro de configuración de apertura.

Volver

OpenLink: Este objeto, para encadenar.

setUrl(url)

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

Parámetros

NombreTipoDescripción
urlStringLa URL que se abrirá.

Volver

OpenLink: Este objeto, para encadenar.