Class OpenLink

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

Biểu thị một thao tác để mở một đường liên kết có một số tuỳ chọn.

Có sẵn cho các ứng dụng Tiện ích bổ sung của Google Workspace và 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();

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 đã bật tiêu đề Cross-Origin-Opener-Policy (COOP). Nếu bạn bật tính năng COOP 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ứcLoại 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 URL được mở.
setUrl(url)OpenLinkĐặt URL cần 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.

Tham số

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

Cầu thủ trả bóng

OpenLink – Đối tượng này, để tạo chuỗi.


setOpenAs(openAs)

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

Tham số

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

Cầu thủ trả bóng

OpenLink – Đối tượng này, để tạo chuỗi.


setUrl(url)

Đặt URL cần 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.

Tham số

TênLoạiMô tả
urlStringURL cần mở.

Cầu thủ trả bóng

OpenLink – Đối tượng này, để tạo chuỗi.