Risorsa manifest di Gmail

La configurazione delle risorse utilizzata per definire i contenuti e il comportamento del componente aggiuntivo di Google Workspace in Gmail. I manifest dei componenti aggiuntivi di Google Workspace devono avere tutti i componenti contrassegnati come Obbligatorio se estendono Gmail.

Gmail

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

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

string

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

Questa funzione è stata ritirata per evitare una latenza di esecuzione non necessaria. Il componente aggiuntivo deve invece lanciare un'eccezione dall'invocazione principale, come mostrato in questo esempio.

composeTrigger

object (ComposeTrigger)

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

Per maggiori dettagli, vedi Espandere l'interfaccia utente di composizione con le azioni di composizione.

contextualTriggers[]

object (ContextualTrigger)

Obbligatorio. Un elenco di attivatori che vengono eseguiti quando un messaggio viene aperto in Gmail. Quando viene attivato, 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 la creazione della home page del componente aggiuntivo nell'host Gmail. Questa azione sostituisce addOns.common.homepageTrigger.

ComposeTrigger

La configurazione di un'azione di composizione. Per ulteriori informazioni, consulta Estendere l'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 composizione. Le opzioni valide sono le seguenti:

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

object (SelectAction)

Un elenco di azioni di composizione che creano interfacce utente di composizione. Tuttavia, questo elenco è limitato a una singola azione per componente aggiuntivo. L'azione di composizione ha 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 saperne di più, consulta Estendere l'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 viene attivato l'attivatore.

Per informazioni 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. Al momento è l'unica opzione, quindi deve sempre essere un oggetto vuoto.

SelectAction

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

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

string

Obbligatorio per le azioni di composizione. Il nome della funzione Apps Script che viene eseguita quando viene selezionata questa azione di composizione. Questa funzione di attivazione della composizione genera l'interfaccia utente di composizione del componente aggiuntivo.

Per i dettagli, consulta Comporre la funzione di attivazione.

text

string

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