Class OpenLink

OpenLink

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

Está disponible para los complementos de Google Workspace y las 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 Cross-Origin-Opener-Policy (COOP) habilitado. Si COOP está habilitado 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 devuelveDescripción breve
setOnClose(onClose)OpenLinkEstablece el comportamiento de la acción de la 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 la 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
openAsOpenAsEl 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 en la lista de entidades permitidas del manifiesto.

Parámetros

NombreTipoDescripción
urlStringLa URL que se abrirá.

Volver

OpenLink — Este objeto, para encadenar.