Risorsa manifest di Gmail

La configurazione della risorsa utilizzata per definire i contenuti e il comportamento dei componenti aggiuntivi di Google Workspace in Gmail. I file manifest dei componenti aggiuntivi di Google Workspace devono contenere tutti i componenti contrassegnati come obbligatori se estendono Gmail.

Gmail

La configurazione del file manifest del componente aggiuntivo Google Workspace per le estensioni di Gmail. Per ulteriori informazioni, consulta 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

Obsoleta. 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 deprecata per evitare latenza di esecuzione non necessaria. Il componente aggiuntivo dovrebbe invece 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 scrittura di un'email.

Per maggiori dettagli, vedi Estensione dell'interfaccia utente di scrittura con azioni di scrittura.

contextualTriggers[]

object (ContextualTrigger)

Obbligatorio. Un elenco di attivatori che si attivano quando un messaggio viene aperto in Gmail. Quando si attiva, l'attivatore esegue una funzione Apps Script specifica, in genere per creare nuove schede e aggiornare l'interfaccia utente.
homepageTrigger

object (HomepageTrigger)

La specifica della funzione di attivazione per creare la home page del componente aggiuntivo nell'host di Gmail. Questo sostituisce addOns.common.homepageTrigger.

ComposeTrigger

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

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 le seguenti:

  • NONE è l'impostazione predefinita. Di conseguenza, l'oggetto evento passato alla funzione di trigger di scrittura è quasi vuoto.
  • METADATA, che compila l'oggetto evento passato alla funzione di trigger di scrittura con gli elenchi dei 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 UI di scrittura; tuttavia, questo elenco è limitato a una singola azione per componente aggiuntivo. All'azione di scrittura è corrispondente un'icona visualizzata nella finestra di scrittura di Gmail. L'icona è specificata da gmail.logoUrl.

ContextualTrigger

La configurazione di un attivatore che si attiva quando l'utente apre un messaggio di Gmail e tale messaggio soddisfa determinati criteri. Per ulteriori informazioni, consulta Estensione dell'interfaccia utente dei messaggi.

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

string

Obbligatorio per ogni attivatore contestuale. Il nome della funzione Apps Script che viene eseguita quando si attiva l'attivatore.

Per maggiori dettagli su come definire questa funzione, consulta Funzione di trigger contestuale.

unconditional

object

Obbligatorio per ogni attivatore contestuale. Utilizzato per specificare che l'attivatore contestuale si attiva per tutti i messaggi di Gmail quando vengono aperti. Questa è attualmente l'unica opzione, quindi deve sempre essere un oggetto vuoto.

SelectAction

La configurazione dell'azione di scrittura che 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 viene selezionata questa azione di scrittura. Questa funzione di trigger di scrittura crea l'interfaccia utente di scrittura del componente aggiuntivo.

Per maggiori dettagli, vedi Comporre la funzione di trigger.

text

string

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