Risorsa manifest di Gmail

La configurazione della risorsa utilizzata per definire i contenuti e il comportamento del componente aggiuntivo di Google Workspace all'interno di Gmail. I file manifest dei componenti aggiuntivi di Google Workspace devono avere tutti i componenti contrassegnati come Obbligatorio se estendono Gmail.

Gmail

La configurazione del manifest del componente aggiuntivo di Google Workspace per le estensioni di Gmail. Per ulteriori informazioni, consulta la pagina Estensione di Gmail con i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
Campi
authorizationCheckFunction

string

Deprecato. Il nome di una funzione Apps Script che esegue i controlli dei requisiti di autorizzazione di terze parti. Questa funzione viene chiamata prima di ogni chiamata al componente aggiuntivo di Google Workspace.

Questa funzione è stata ritirata per evitare latenza di esecuzione non necessarie. Al contrario, il componente aggiuntivo deve generare un'eccezione dalla chiamata principale, come mostrato in questo esempio.

composeTrigger

object (ComposeTrigger)

Obbligatorio per le azioni di scrittura Definisce l'insieme di UI disponibili per l'utente durante la composizione di un'email.

Per maggiori dettagli, consulta la sezione Estensione dell'interfaccia utente di composizione con le azioni di scrittura.

contextualTriggers[]

object (ContextualTrigger)

Obbligatorio. Un elenco di attivatori che si attivano quando un messaggio viene aperto in Gmail. Quando viene attivato, il trigger esegue una specifica funzione di Apps Script, di solito per creare nuove schede e aggiornare la UI.
homepageTrigger

object (HomepageTrigger)

Le specifiche della funzione di attivazione per la creazione della home page del componente aggiuntivo nell'host Gmail. Questa operazione sostituisce addOns.common.homepageTrigger.

Scrivi composito

La configurazione di un'azione di scrittura. Per ulteriori informazioni, consulta la sezione Estensione dell'interfaccia utente di Scrivi.

Rappresentazione JSON 
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
Campi
draftAccess

string

Definisce il livello di accesso ai dati disponibile per una funzione di trigger di scrittura. Le opzioni valide sono:

  • NONE, l'impostazione predefinita. Di conseguenza, l'oggetto evento passato alla funzione di trigger di scrittura è per lo più vuoto.
  • METADATA, che compila l'oggetto evento passato alla funzione di trigger di scrittura con gli elenchi di destinatari del messaggio. Questa impostazione richiede che il componente aggiuntivo includa l' ambito gmail.addons.current.message.metadata.
selectActions[]

object (SelectAction)

Un elenco di azioni di scrittura che creano interfacce utente di scrittura; tuttavia, questo elenco è limitato a una singola azione per componente aggiuntivo. L'azione di scrittura è caratterizzata dall'icona corrispondente visualizzata nella finestra di composizione di Gmail. L'icona è specificata da gmail.logoUrl.

Trigger contestuale

La configurazione di un attivatore che si attiva quando l'utente apre un messaggio di Gmail e questo soddisfa determinati criteri. Per ulteriori informazioni, consulta la pagina relativa all'estensione dell'interfaccia utente dei messaggi.

Rappresentazione JSON 
{
  "onTriggerFunction": string,
  "unconditional": {},
}
Campi
onTriggerFunction

string

Obbligatorio per ogni attivatore di contesto. Il nome della funzione Apps Script che viene eseguita quando viene attivato il trigger.

Per informazioni dettagliate su come definire questa funzione, vedi Funzione di trigger contestuale.

unconditional

object

Obbligatorio per ogni attivatore di contesto. Utilizzato per specificare che l'attivatore contestuale si attiva per tutti i messaggi di Gmail all'apertura. Al momento questa è l'unica opzione, quindi deve sempre essere un oggetto vuoto.

Seleziona azione

La configurazione dell'azione di scrittura definisce la funzione da eseguire quando l'utente seleziona l'azione di scrittura.

Rappresentazione JSON 
{
  "runFunction": string,
  "text": string
}
Campi
runFunction

string

Obbligatorio per le azioni di scrittura Il nome della funzione Apps Script che viene eseguita quando è selezionata questa azione di scrittura. Questa funzione di attivazione della composizione crea l'UI di composizione del componente aggiuntivo.

Per maggiori dettagli, consulta Scrivere funzione trigger.

text

string

Obbligatorio per le azioni di scrittura Una breve descrizione testuale di questa azione di scrittura.