Class OpenLink

打开链接

表示打开链接的操作，并带有一些选项。

适用于 Google Workspace 加载项和 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();

注意：如需在关闭链接后重新加载插件，请勿使用启用了 Cross-Origin-Opener-Policy (COOP) 标头的链接。如果链接中启用了 COOP，插件将无法检测窗口状态，并且插件卡不会更新。

方法

方法返回类型简介
setOnClose(onClose)OpenLink设置在关闭网址窗口或标签页时网址操作的行为。
setOpenAs(openAs)OpenLink设置网址打开时的行为。
setUrl(url)OpenLink设置要打开的网址。

详细文档

setOnClose(onClose)

设置在关闭网址窗口或标签页时网址操作的行为。

参数

名称类型说明
onCloseOnClose关闭设置。

返回

OpenLink - 用于链式调用的开放链接对象。

setOpenAs(openAs)

设置网址打开时的行为。

参数

名称类型说明
openAsOpenAs开场设置。

返回

OpenLink - 用于链式调用的开放链接对象。

setUrl(url)

设置要打开的网址。网址必须与清单中列入白名单的前缀匹配。

参数

名称类型说明
urlString要打开的目标网址。

返回

OpenLink - 用于链式调用的开放链接对象。