Esta página foi traduzida pela API Cloud Translation.

Class OpenLink

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)`

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

Parâmetros

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

Retornar

OpenLink: este objeto, para encadeamento.

`setOpenAs(openAs)`

Define o comportamento do URL quando ele é aberto.

Parâmetros

Nome	Tipo	Descrição
`openAs`	`OpenAs`	A configuração inicial.

Retornar

OpenLink: este objeto, para encadeamento.

`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.