Questa pagina è stata tradotta dall'API Cloud Translation.

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) } }

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 ()` Anteprima per sviluppatori: disponibile nell'ambito del Programma Anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima a determinate funzionalità. 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 }

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 Google Workspace 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

Campi
`label`	`string` Obbligatorio per ogni azione universale. Il testo visualizzato nel menu dell'interfaccia utente per questa azione.
`openLink`	`string` Obbligatorio per ogni azione universale se `runFunction` non è presente. Se specificato, l'URL che viene aperto in una scheda quando l'utente seleziona 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.

label

string

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

openLink

string

Obbligatorio per ogni azione universale se runFunction non è presente. Se specificato, l'URL che viene aperto in una scheda quando l'utente seleziona 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.