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)

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

參數

名稱	類型	說明
onClose	OnClose	關閉設定。

回攻員

OpenLink：這個物件用於鏈結。

---

setOpenAs(openAs)

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

參數

名稱	類型	說明
openAs	OpenAs	開啟設定。

回攻員

OpenLink：這個物件用於鏈結。

---

setUrl(url)

設定要開啟的網址。網址必須與資訊清單中核准的字首相符。

參數

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

回攻員

OpenLink：這個物件用於鏈結。