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