Risorsa manifest di Gmail

La configurazione delle risorse utilizzata per definire i contenuti e il comportamento del componente aggiuntivo Google Workspace in Gmail. Se estendono Gmail, tutti i componenti dei file manifest dei componenti aggiuntivi di Google Workspace devono essere contrassegnati come obbligatori.

Gmail

La configurazione manifest del componente aggiuntivo di Google Workspace per le estensioni Gmail. Per saperne di più, 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 di Apps Script che esegue i controlli dei requisiti di autorizzazione di terze parti. Questa funzione viene richiamata prima di ogni chiamata del componente aggiuntivo di Google Workspace.

Questa funzione è stata deprecata per evitare una 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 specifica di Apps Script, in genere per creare nuove schede e aggiornare la UI.
homepageTrigger

object (HomepageTrigger)

La specifica della funzione di trigger per la creazione del componente aggiuntivo home page nell'host Gmail. Questa operazione sostituisce addOns.common.homepageTrigger.

ComposeTrigger

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

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. In questo modo, 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 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 è visualizzata un'icona corrispondente nella finestra di composizione 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 il 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 trigger contestuale. Il nome della funzione Apps Script che viene eseguita quando l'attivatore si attiva.

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

unconditional

object

Obbligatorio per ogni trigger contestuale. Utilizzato per specificare che l'attivatore contestuale si attiva per tutti i messaggi di Gmail quando vengono aperti. Al momento questa è l'unica opzione, pertanto l'oggetto deve essere sempre 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 questa azione di scrittura è selezionata. Questa funzione di trigger di scrittura crea l'interfaccia utente di scrittura del componente aggiuntivo.

Per maggiori dettagli, consulta Crea funzione di trigger.

text

string

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