Class OpenLink

Abrirvínculo

Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.

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

Nota: Para volver a cargar 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étodo	Tipo de datos que se muestra	Descripción breve
setOnClose(onClose)	OpenLink	Establece el comportamiento de la acción de URL cuando se cierra la ventana o la pestaña de la URL.
setOpenAs(openAs)	OpenLink	Establece el comportamiento de la URL cuando se abre.
setUrl(url)	OpenLink	Establece 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

Nombre	Tipo	Descripción
onClose	OnClose	Es el parámetro de configuración de cierre.

Volver

OpenLink: Es este objeto de vínculo abierto, para encadenar.

---

setOpenAs(openAs)

Establece el comportamiento de la URL cuando se abre.

Parámetros

Nombre	Tipo	Descripción
openAs	OpenAs	Es el parámetro de configuración de apertura.

Volver

OpenLink: Es este objeto de vínculo abierto, 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

Nombre	Tipo	Descripción
url	String	Es la URL de destino que se abrirá.

Volver

OpenLink: Es este objeto de vínculo abierto, para encadenar.