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:這個物件用於鏈結。