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();

注意：如要在關閉連結後重新載入外掛程式，請勿使用已啟用跨來源開啟者政策 (COOP) 標頭的連結。如果在連結中啟用 COOP，外掛程式就無法偵測視窗狀態，且外掛程式資訊卡不會更新。

方法

方法傳回類型簡短說明
setOnClose(onClose)OpenLink設定網址動作在關閉網址視窗或分頁時的行為。
setOpenAs(openAs)OpenLink設定網址在開啟時的行為。
setUrl(url)OpenLink設定要開啟的網址。

內容詳盡的說明文件

setOnClose(onClose)

設定網址動作在關閉網址視窗或分頁時的行為。

參數

名稱類型說明
onCloseOnClose關閉設定。

回攻員

OpenLink：這個物件用於鏈結。

setOpenAs(openAs)

設定網址在開啟時的行為。

參數

名稱類型說明
openAsOpenAs開啟設定。

回攻員

OpenLink：這個物件用於鏈結。

setUrl(url)

設定要開啟的網址。網址必須與資訊清單中加入許可清單的字串相符。

參數

名稱類型說明
urlString要開啟的網址。

回攻員

OpenLink：這個物件用於鏈結。