Class OpenLink

Otwórzlink

Reprezentuje działanie polegające na otwarciu linku z kilkoma 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.
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();

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

Metody

MetodaZwracany typKrótki opis
setOnClose(onClose)OpenLinkOkreśla zachowanie działania związanego z adresem URL, gdy okno lub karta z adresem URL są zamknięte.
setOpenAs(openAs)OpenLinkOkreśla sposób działania adresu URL po jego otwarciu.
setUrl(url)OpenLinkUstawia adres URL do otwarcia.

Szczegółowa dokumentacja

setOnClose(onClose)

Określa zachowanie działania związanego z adresem URL, gdy okno lub karta z adresem URL są zamknięte.

Parametry

NazwaTypOpis
onCloseOnCloseUstawienie zamknięcia.

Powrót

OpenLink – ten obiekt do łańcucha.


setOpenAs(openAs)

Określa sposób działania adresu URL po jego otwarciu.

Parametry

NazwaTypOpis
openAsOpenAsOtwieranie ustawienia.

Powrót

OpenLink – ten obiekt do łańcucha.


setUrl(url)

Ustawia adres URL do otwarcia. Adres URL musi być zgodny z preiksem znajdującym się na białej liście w pliku manifestu.

Parametry

NazwaTypOpis
urlStringAdres URL do otwarcia.

Powrót

OpenLink – ten obiekt do łańcucha.