Class OpenLink

AbrirLink

Prévia para desenvolvedores:disponível no Programa de prévia para desenvolvedores do Google Workspace, que concede acesso antecipado a determinados recursos.

Representa uma ação para abrir um link com algumas opções.

Disponível para complementos do Google Workspace e apps do 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();

Observação:para recarregar complementos depois de fechar um link, não use um link com o cabeçalho Cross-Origin-Opener-Policy (COOP) ativado. Se o COOP estiver ativado em um link, os complementos não poderão detectar o estado da janela, e o card do complemento não será atualizado.

Métodos

Método	Tipo de retorno	Breve descrição
setOnClose(onClose)	OpenLink	Define o comportamento da ação de URL quando a janela ou guia do URL é fechada.
setOpenAs(openAs)	OpenLink	Define o comportamento do URL quando ele é aberto.
setUrl(url)	OpenLink	Define o URL a ser aberto.

Documentação detalhada

setOnClose(onClose)

Define o comportamento da ação de URL quando a janela ou guia do URL é fechada.

Parâmetros

Nome	Tipo	Descrição
onClose	OnClose	A configuração de fechamento.

Retornar

OpenLink: esse objeto de link aberto, para encadeamento.

---

setOpenAs(openAs)

Define o comportamento do URL quando ele é aberto.

Parâmetros

Nome	Tipo	Descrição
openAs	OpenAs	A configuração de abertura.

Retornar

OpenLink: esse objeto de link aberto, para encadeamento.

---

setUrl(url)

Define o URL a ser aberto. O URL precisa corresponder a um prefixo autorizado no manifesto.

Parâmetros

Nome	Tipo	Descrição
url	String	O URL de destino a ser aberto.

Retornar

OpenLink: esse objeto de link aberto, para encadeamento.