Risorsa manifest dei componenti aggiuntivi

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

AddOns

Il livello superiore della configurazione del manifest del componente aggiuntivo di Google Workspace.

Rappresentazione JSON
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "chat": {
    object (Chat)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
Campi
common

object (Common)

Obbligatorio. Definisce i valori per un componente aggiuntivo di Google Workspace comuni per ogni applicazione host. Alcuni valori definiti qui vengono utilizzati come predefiniti quando vengono omessi valori specifici per un determinato host.

calendar

object (Calendar)

Obbligatorio se il componente aggiuntivo di Google Workspace estende Calendar. Configurazioni per l'aspetto e il comportamento del componente aggiuntivo di Google Workspace all'interno dell'applicazione host Google Calendar. Se questo campo viene omesso, il plug-in viene disattivato in Google Calendar.

chat

object ()

Obbligatorio se il componente aggiuntivo di Google Workspace estende Chat. Configurazione di un'app Google Chat. Se questo campo viene omesso, il componente aggiuntivo viene disattivato in Google Chat.

L'oggetto addOns.chat deve essere vuoto. Per configurare il comportamento e l'aspetto del plug-in in Chat, vedi Configurare un'app Chat.

drive

object (Drive)

Obbligatorio se il componente aggiuntivo di Google Workspace estende Google Drive. Configurazioni per l'aspetto e il comportamento del componente aggiuntivo di Google Workspace all'interno dell'applicazione host Google Drive. Se questo campo viene omesso, il componente aggiuntivo viene disattivato in Google Drive.

gmail

object (Gmail)

Obbligatorio se il componente aggiuntivo di Google Workspace estende Gmail. Configurazioni per l'aspetto e il comportamento del componente aggiuntivo di Google Workspace all'interno dell'applicazione host Gmail. Se questo campo viene omesso, il componente aggiuntivo viene disattivato in Gmail.

docs

object (Docs)

Obbligatorio se il componente aggiuntivo di Google Workspace estende Documenti. Configurazioni per l'aspetto e il comportamento del componente aggiuntivo di Google Workspace all'interno dell'applicazione host Documenti. Se questo campo viene omesso, il componente aggiuntivo viene disattivato in Documenti.

sheets

object (Sheets)

Obbligatorio se il componente aggiuntivo di Google Workspace estende Fogli. Configurazioni per l'aspetto e il comportamento del componente aggiuntivo di Google Workspace all'interno dell'applicazione host Fogli. Se questo campo viene omesso, il componente aggiuntivo viene disattivato in Fogli.

slides

object (Slides)

Obbligatorio se il componente aggiuntivo di Google Workspace estende Presentazioni. Configurazioni per l'aspetto e il comportamento del componente aggiuntivo di Google Workspace all'interno dell'applicazione host Presentazioni. Se questo campo viene omesso, il componente aggiuntivo viene disattivato in Presentazioni.

Nome

La configurazione manifest per i parametri comuni a ogni applicazione host. Alcuni valori definiti qui vengono utilizzati come predefiniti quando i valori specifici per un determinato host vengono omessi.

Rappresentazione JSON
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
Campi
homepageTrigger

object (HomepageTrigger)

La specifica della funzione di attivazione predefinita per la creazione della home page del componente aggiuntivo. Questa specifica viene utilizzata se non è definito un attivatore della home page specifico per l'host. Se anche questo viene omesso, viene creata e utilizzata una scheda della home page generica quando necessario.
layoutProperties

object (LayoutProperties)

Una configurazione per i colori utilizzati nella barra degli strumenti e nei pulsanti del componente aggiuntivo.
logoUrl

string

Obbligatorio. L'URL dell'immagine mostrata nella barra degli strumenti. L'URL deve essere pubblico.

name

string

Obbligatorio. Il nome del componente aggiuntivo mostrato nella barra degli strumenti.

openLinkUrlPrefixes[]

string

Obbligatorio se il componente aggiuntivo mostra link in uscita, all'interno di widget che utilizzano un OpenLink o un widget di testo che utilizza tag di ancoraggio HTML. Un elenco di prefissi URL HTTPS. Per proteggere i dati utente, qualsiasi link visualizzato dal componente aggiuntivo deve corrispondere a uno dei prefissi in questo elenco.

Per maggiori dettagli, consulta la sezione Inserire URL nella lista consentita.

universalActions[]

object (UniversalAction)

Elenco di azioni universali sempre disponibili nell'interfaccia utente del componente aggiuntivo.
useLocaleFromApp

boolean

Se true, gli oggetti evento del componente aggiuntivo passati alle funzioni di callback dell'azione o alle funzioni di attivazione includono le informazioni sulle impostazioni internazionali e sul fuso orario dell'utente. Il valore predefinito è false.

Per ulteriori dettagli, consulta Accedere alle impostazioni internazionali e ai fusi orari dell'utente.

LayoutProperties

Una configurazione che controlla l'aspetto e i colori della barra degli strumenti e dei pulsanti del componente aggiuntivo.

Rappresentazione JSON
{
  "primaryColor": string,
  "secondaryColor": string
}
Campi
primaryColor

string

Il colore della barra degli strumenti. Il valore predefinito è grigio (#424242).
secondaryColor

string

Il colore predefinito dei pulsanti. Il valore predefinito è il colore primario (se impostato), altrimenti è blu (#2196F3).

UniversalAction

Una configurazione per un'azione universale. Se selezionata, un'azione universale apre il link all'URL specificato o esegue la funzione Apps Script specificata.

Rappresentazione JSON
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
Campi
label

string

Obbligatorio per ogni azione universale. Il testo visualizzato nel menu dell'interfaccia utente per questa azione.
runFunction

string

Obbligatorio per ogni azione universale se openLink non è presente. Se specificato, il nome della funzione Apps Script che viene eseguita quando l'utente seleziona questa azione.

Per maggiori dettagli, consulta la guida sulle azioni universali.