Risorsa manifest dei componenti aggiuntivi

La configurazione della risorsa utilizzata per definire i contenuti e il comportamento dei componenti aggiuntivi Google Workspace. Tutti i componenti dei file manifest dei componenti aggiuntivi di Google Workspace devono essere contrassegnati come obbligatori.

AddOns

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

Rappresentazione JSON
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "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 che sono comuni per ogni applicazione host. Alcuni valori definiti qui vengono utilizzati come predefiniti quando vengono omessi valori specifici di un determinato host.

calendar

object (Calendar)

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

drive

object (Drive)

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

gmail

object (Gmail)

Obbligatorio se il componente aggiuntivo di Google Workspace estende Gmail. Configurazioni per l'aspetto e il comportamento dei componenti aggiuntivi di Google Workspace all'interno dell'applicazione host di 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 di 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 di 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 di Presentazioni. Se questo campo viene omesso, il componente aggiuntivo viene disattivato in Presentazioni.

Più comuni

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

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 trigger della home page specifico dell'host. Se ometti anche questa informazione, viene creata e utilizzata una scheda generica per la home page all'occorrenza.
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 visualizzata nella barra degli strumenti. L'URL deve essere pubblico.

name

string

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

openLinkUrlPrefixes[]

string

Obbligatorio se il componente aggiuntivo mostra eventuali link in uscita, sia all'interno di widget che utilizzano un OpenLink o widget di testo che utilizzano anchor tag 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 URL della lista consentita.

universalActions[]

object (UniversalAction)

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

boolean

Se true, gli oggetti evento dei componenti aggiuntivi 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 maggiori dettagli, consulta Accesso alle impostazioni internazionali e ai fusi orari degli utenti.

LayoutProperties

Una configurazione che controlla la Google Workspace barra degli strumenti del componente aggiuntivo, nonché i colori e l'aspetto dei pulsanti.

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 principale (se impostato), altrimenti il colore predefinito è blu (#2196F3).

UniversalAction

Una configurazione per un'azione universale. Se selezionata, un'azione universale apre il link dell'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 mostrato nel menu UI per questa azione.
runFunction

string

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

Per maggiori dettagli, consulta la guida Azioni universali.