Class OpenLink

ApriLink

Anteprima per sviluppatori: disponibile nell'ambito del programma di anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima a determinate funzionalità.

Rappresenta un'azione per aprire un link con alcune opzioni.

Disponibile per i componenti aggiuntivi di Google Workspace e le app 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();

Nota:per ricaricare i componenti aggiuntivi dopo aver chiuso un link, non utilizzare un link con l'intestazione Cross-Origin-Opener-Policy (COOP) abilitata. Se COOP è abilitato in un link, i componenti aggiuntivi non possono rilevare lo stato della finestra e la scheda del componente aggiuntivo non si aggiorna.

Metodi

Metodo	Tipo restituito	Breve descrizione
setOnClose(onClose)	OpenLink	Imposta il comportamento dell'azione URL quando la finestra o la scheda dell'URL viene chiusa.
setOpenAs(openAs)	OpenLink	Imposta il comportamento dell'URL quando viene aperto.
setUrl(url)	OpenLink	Imposta l'URL da aprire.

Documentazione dettagliata

setOnClose(onClose)

Imposta il comportamento dell'azione URL quando la finestra o la scheda dell'URL viene chiusa.

Parametri

Nome	Tipo	Descrizione
onClose	OnClose	L'impostazione di chiusura.

Indietro

OpenLink: questo oggetto di collegamento aperto, per il concatenamento.

---

setOpenAs(openAs)

Imposta il comportamento dell'URL quando viene aperto.

Parametri

Nome	Tipo	Descrizione
openAs	OpenAs	L'impostazione di apertura.

Indietro

OpenLink: questo oggetto di collegamento aperto, per il concatenamento.

---

setUrl(url)

Imposta l'URL da aprire. L'URL deve corrispondere a un prefisso inserito nella whitelist del manifest.

Parametri

Nome	Tipo	Descrizione
url	String	L'URL di destinazione da aprire.

Indietro

OpenLink: questo oggetto di collegamento aperto, per il concatenamento.