Risorsa manifest dei componenti aggiuntivi

La configurazione delle risorse 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 Obbligatori.

AddOns

La configurazione di primo livello del file 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 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 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 componente aggiuntivo viene disattivato in Google Calendar.

chat

object ()

Obbligatorio se il componente aggiuntivo 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 componente aggiuntivo in Chat, vedi Configurare un'app Chat.
drive

object (Drive)

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

Nome

La configurazione del 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 viene omesso anche questo, viene creata e utilizzata una scheda generica della home page, se 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 esterni, sia all'interno di widget che utilizzano un OpenLink o di widget di testo che utilizzano anchor tag HTML. Un elenco di prefissi di URL HTTPS. Per proteggere i dati utente, qualsiasi link visualizzato dal componente aggiuntivo deve corrispondere a uno dei prefissi di questo elenco.

Per maggiori dettagli, consulta URL consentiti.

universalActions[]

object (UniversalAction)

Elenco delle azioni universali sempre disponibili nella UI 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 la sezione Accesso alle impostazioni internazionali e ai fusi orari degli utenti.

LayoutProperties

Una configurazione che controlla Google Workspace 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 principale (se impostato); altrimenti è il blu (#2196F3).

UniversalAction

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

string

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

Per maggiori dettagli, consulta la guida Azioni universali.