Representa uma ação para abrir um link com algumas opções.
Disponível para os apps do Google Workspace Add-ons e 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 = CardService.newActionResponseBuilder() .setOpenLink( CardService.newOpenLink() .setUrl('https://www.google.com') .setOpenAs(CardService.OpenAs.FULL_SIZE) .setOnClose(CardService.OnClose.NOTHING), ) .build();
Observação:para recarregar os complementos após fechar um link, não use um link com cabeçalho Cross-Origin-Opener-Policy (COOP) ativado. Se a COOP estiver ativada 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 |
---|---|---|
set | Open | Define o comportamento da ação do URL quando a janela ou guia do URL é fechada. |
set | Open | Define o comportamento do URL quando ele é aberto. |
set | Open | Define o URL a ser aberto. |
Documentação detalhada
set On Close(onClose)
set Open As(openAs)
set Url(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 a ser aberto. |
Retornar
Open
: este objeto, para encadeamento.