Class OpenLink

ApriLink

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 = CardService.newActionResponseBuilder()
                           .setOpenLink(
                               CardService.newOpenLink()
                                   .setUrl('https://www.google.com')
                                   .setOpenAs(CardService.OpenAs.FULL_SIZE)
                                   .setOnClose(CardService.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 la funzionalità COOP è attivata 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.

Invio

OpenLink: questo oggetto, per l'accodamento.

---

setOpenAs(openAs)

Imposta il comportamento dell'URL quando viene aperto.

Parametri

Nome	Tipo	Descrizione
openAs	OpenAs	L'impostazione di apertura.

Invio

OpenLink: questo oggetto, per l'accodamento.

---

setUrl(url)

Imposta l'URL da aprire. L'URL deve corrispondere a un prefisso presente nella lista consentita nel manifest.

Parametri

Nome	Tipo	Descrizione
url	String	L'URL da aprire.

Invio

OpenLink: questo oggetto, per l'accodamento.