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 =
    AddOnsResponseService.newActionResponseBuilder()
        .setOpenLink(
            AddOnsResponseService.newOpenLink()
                .setUrl('https://www.google.com')
                .setOpenAs(AddOnsResponseService.OpenAs.FULL_SIZE)
                .setOnClose(AddOnsResponseService.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 - 這個開啟連結物件，用於鏈結。