Class OpenLink

MởĐường liên kết

Biểu thị một thao tác mở đường liên kết bằng một số lựa chọn.

Dành cho tiện ích bổ sung của Google Workspace và ứng dụng 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();

Lưu ý: Để tải lại các tiện ích bổ sung sau khi đóng một đường liên kết, đừng sử dụng đường liên kết có tiêu đề Cross-Origin-Opener-Policy (COOP) được bật. Nếu COOP được bật trong một đường liên kết, thì các tiện ích bổ sung sẽ không thể phát hiện trạng thái cửa sổ và thẻ tiện ích bổ sung sẽ không cập nhật.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
setOnClose(onClose)OpenLinkĐặt hành vi của thao tác URL khi cửa sổ hoặc thẻ URL bị đóng.
setOpenAs(openAs)OpenLinkĐặt hành vi của URL khi được mở.
setUrl(url)OpenLinkĐặt URL sẽ được mở.

Tài liệu chi tiết

setOnClose(onClose)

Đặt hành vi của thao tác URL khi cửa sổ hoặc thẻ URL bị đóng.

Thông số

TênLoạiMô tả
onCloseOnCloseChế độ cài đặt đóng.

Cầu thủ trả bóng

OpenLink – Đối tượng đường liên kết mở này, để liên kết.


setOpenAs(openAs)

Đặt hành vi của URL khi được mở.

Thông số

TênLoạiMô tả
openAsOpenAsChế độ cài đặt mở.

Cầu thủ trả bóng

OpenLink – Đối tượng đường liên kết mở này, để liên kết.


setUrl(url)

Đặt URL sẽ được mở. URL phải khớp với một tiền tố có trong danh sách cho phép trong tệp kê khai.

Thông số

TênLoạiMô tả
urlStringURL đích để mở.

Cầu thủ trả bóng

OpenLink – Đối tượng đường liên kết mở này, để liên kết.