Class OpenLink

OpenLink

表示用于打开包含某些选项的链接的操作。

适用于 Google Workspace 插件和 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();

注意:如需在关闭链接后重新加载插件,请勿使用启用了 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 - 此对象,用于链接。