Representa uma ação para abrir um link com algumas opções.
Disponível nos complementos do Google Workspace e nos apps do Google Chat.
// A button that opens as a link in an overlay and // requires a reload when closed. var 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. var 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 complementos depois de fechar um link, não utilize 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 cartão complementar não será atualizado.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
setOnClose(onClose) | OpenLink | Define o comportamento da ação do URL quando a janela ou a 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)
setOpenAs(openAs)
setUrl(url)
Define o URL a ser aberto. O URL precisa corresponder a um prefixo incluído na lista de permissões em o manifesto.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
url | String | O URL a ser aberto. |
Retornar
OpenLink
: este objeto, para encadeamento.