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