Class OpenLink

OpenLink

Reprezentuje działanie polegające na otwarciu linku z pewnymi opcjami.

Dostępne w przypadku dodatków do Google Workspace i aplikacji Google Chat.

// A button that opens as a link in an overlay and
// requires a reload when closed.
var 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.
var actionResponse = CardService.newActionResponseBuilder()
    .setOpenLink(CardService.newOpenLink()
        .setUrl("https://www.google.com")
        .setOpenAs(CardService.OpenAs.FULL_SIZE)
        .setOnClose(CardService.OnClose.NOTHING))
    .build();

Uwaga: aby ponownie załadować dodatki po zamknięciu linku, nie używaj linku z włączonym nagłówkiem Cross-Origin-Opener-Policy (COOP). Jeśli funkcja COOP jest włączona w linku, dodatki nie mogą wykrywać stanu okna, a karta dodatku się nie aktualizuje.

Metody

MetodaTyp zwracanej wartościKrótki opis
setOnClose(onClose)OpenLinkOkreśla zachowanie działania adresu URL po zamknięciu okna lub karty adresu URL.
setOpenAs(openAs)OpenLinkOkreśla zachowanie adresu URL po jego otwarciu.
setUrl(url)OpenLinkUstawia adres URL, który ma być otwierany.

Szczegółowa dokumentacja

setOnClose(onClose)

Określa zachowanie działania adresu URL po zamknięciu okna lub karty adresu URL.

Parametry

NazwaTypOpis
onCloseOnCloseZamknięcie.

Powroty

OpenLink – ten obiekt do tworzenia łańcuchów.


setOpenAs(openAs)

Określa zachowanie adresu URL po jego otwarciu.

Parametry

NazwaTypOpis
openAsOpenAsUstawienie otwierające.

Powroty

OpenLink – ten obiekt do tworzenia łańcuchów.


setUrl(url)

Ustawia adres URL, który ma być otwierany. Adres URL musi być zgodny z prefiksem umieszczonym na białej liście w pliku manifestu.

Parametry

NazwaTypOpis
urlStringAdres URL do otwarcia.

Powroty

OpenLink – ten obiekt do tworzenia łańcuchów.