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.
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();
Nota: per ricaricare i componenti aggiuntivi dopo aver chiuso un collegamento, non utilizzare un link con l'intestazione Cross-Origin-Opener-Policy (COOP) abilitata. Se COOP viene attivato in un link, i componenti aggiuntivi non riescono a 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 è chiusa. |
setOpenAs(openAs) | OpenLink | Imposta il comportamento dell'URL quando viene aperto. |
setUrl(url) | OpenLink | Imposta l'URL da aprire. |
Documentazione dettagliata
setOnClose(onClose)
setOpenAs(openAs)
setUrl(url)
Imposta l'URL da aprire. L'URL deve corrispondere a un prefisso autorizzato nel file manifest.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
url | String | L'URL da aprire. |
Ritorni
OpenLink: questo oggetto per il concatenamento.