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

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

参数

名称	类型	说明
onClose	OnClose	结束设置。

返回

OpenLink - 此对象，用于链式调用。

---

setOpenAs(openAs)

设置网址在打开时的行为。

参数

名称	类型	说明
openAs	OpenAs	打开设置。

返回

OpenLink - 此对象，用于链式调用。

---

setUrl(url)

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

参数

名称	类型	说明
url	String	要打开的网址。

返回

OpenLink - 此对象，用于链式调用。