Package google.apps.script.type

Indice

AddOnWidgetSet

Il sottoinsieme di widget utilizzato da un componente aggiuntivo.

Campi
usedWidgets[]

WidgetType

L'elenco dei widget utilizzati in un componente aggiuntivo.

WidgetType

Il tipo di widget. WIDGET_TYPE_UNSPECIFIED è il set di widget di base.

Enum
WIDGET_TYPE_UNSPECIFIED Il set di widget predefinito.
DATE_PICKER Il selettore della data.
STYLED_BUTTONS I pulsanti con stile includono pulsanti con riempimento e pulsanti disattivati.
PERSISTENT_FORMS I moduli permanenti consentono di mantenere i valori dei moduli durante le azioni.
UPDATE_SUBJECT_AND_RECIPIENTS Aggiorna l'oggetto e i destinatari di una bozza.
GRID_WIDGET Il widget griglia.
ADDON_COMPOSE_UI_ACTION Un'azione del componente aggiuntivo di Gmail che si applica all'interfaccia utente di composizione del componente aggiuntivo.

CommonAddOnManifest

Configurazione del componente aggiuntivo condivisa tra tutte le applicazioni host del componente aggiuntivo.

Campi
name

string

Obbligatorio. Il nome visualizzato del componente aggiuntivo.

logoUrl

string

Obbligatorio. L'URL dell'immagine del logo mostrata nella barra degli strumenti del componente aggiuntivo.

layoutProperties

LayoutProperties

Proprietà di layout comuni per le schede dei componenti aggiuntivi.

addOnWidgetSet

AddOnWidgetSet

I widget utilizzati nel componente aggiuntivo. Se questo campo non viene specificato, viene utilizzato l'insieme predefinito.

useLocaleFromApp

bool

Indica se passare le informazioni sulla locale dall'app host.

homepageTrigger

HomepageExtensionPoint

Definisce un endpoint che verrà eseguito in qualsiasi contesto e in qualsiasi host. Le schede generate da questa funzione saranno sempre disponibili per l'utente, ma potrebbero essere eclissate dai contenuti contestuali quando questo componente aggiuntivo dichiara attivatori più mirati.

universalActions[]

UniversalActionExtensionPoint

Definisce un elenco di punti di estensione nel menu di azioni universali che funge da menu di impostazioni per il componente aggiuntivo. Il punto di estensione può essere un URL di un link da aprire o un endpoint da eseguire come invio di un modulo.

openLinkUrlPrefixes

ListValue

Un'azione Apri link può utilizzare solo un URL con uno schema HTTPS, MAILTO o TEL. Per i link HTTPS, l'URL deve anche corrispondere a uno dei prefissi specificati nella lista consentita. Se il prefisso omette lo schema, viene assunto HTTPS. I link HTTP vengono riscritti automaticamente in link HTTPS.

CreateActionExtensionPoint

La configurazione di un attivatore che si attiva quando un utente richiama il flusso di lavoro di creazione delle risorse in un'applicazione Google Workspace. Per ulteriori informazioni, vedi Creare risorse di terze parti dal menu @.

Campi
id

string

Obbligatorio. L'ID univoco per distinguere questo punto di estensione. L'ID può contenere fino a 64 caratteri e deve avere il formato [a-zA-Z0-9-]+.

labelText

string

Obbligatorio. Il testo visualizzato accanto a un'icona per il punto di contatto per la creazione della risorsa, ad esempio Create support case. Questo testo è statico e viene visualizzato prima che gli utenti eseguano il componente aggiuntivo.

localizedLabelText

map<string, string>

Facoltativo. Una mappa di labelText da localizzare in altre lingue. Formatta la lingua in ISO 639 e il paese/la regione in ISO 3166, separati da un trattino -. Ad esempio, en-US.

Se le impostazioni internazionali di un utente sono presenti nelle chiavi della mappa, l'utente vedrà la versione localizzata del labelText.

runFunction

string

Obbligatorio. Endpoint da eseguire quando viene attivato un flusso di lavoro di creazione di risorse per creare un collegamento.

logoUrl

string

Facoltativo. L'icona visualizzata per il punto di contatto per la creazione della risorsa. Se omesso, il menu utilizza l'icona della barra degli strumenti del componente aggiuntivo, logoUrl.

HomepageExtensionPoint

Formato comune per dichiarare la visualizzazione della home page di un componente aggiuntivo.

Campi
runFunction

string

Obbligatorio. L'endpoint da eseguire quando questo punto di estensione è attivato.

enabled

BoolValue

Facoltativo. Se impostato su false, disattiva la visualizzazione della home page in questo contesto.

Se non viene impostato, il valore predefinito è true.

Se la visualizzazione della home page personalizzata di un componente aggiuntivo è disattivata, agli utenti viene fornita una scheda di panoramica generica.

HttpAuthorizationHeader

Intestazione di autorizzazione inviata nelle richieste del componente aggiuntivo HTTP.

Enum
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED Valore predefinito, equivalente a SYSTEM_ID_TOKEN.
SYSTEM_ID_TOKEN Invia un token di identità per l'account di servizio di sistema del componente aggiuntivo Google Workspace specifico del progetto (valore predefinito).
USER_ID_TOKEN Invia un token di identità per l'utente finale.
NONE Non inviare un'intestazione di autenticazione.

HttpOptions

Opzioni per l'invio di richieste agli endpoint HTTP dei componenti aggiuntivi.

Campi
authorizationHeader

HttpAuthorizationHeader

Configurazione del token inviato nell'intestazione HTTP Authorization.

LayoutProperties

Proprietà del layout delle schede condivise tra tutte le applicazioni host dei componenti aggiuntivi.

Campi
primaryColor

string

Il colore principale del componente aggiuntivo. Imposta il colore della barra degli strumenti. Se non viene impostato alcun colore principale, viene utilizzato il valore predefinito fornito dal framework.

secondaryColor

string

Il colore secondario del componente aggiuntivo. Imposta il colore dei pulsanti. Se il colore principale è impostato, ma non è impostato alcun colore secondario, il colore secondario corrisponde a quello principale. Se non viene impostato né il colore principale né il colore secondario, viene utilizzato il valore predefinito fornito dal framework.

useNewMaterialDesign

bool

Attiva il Material Design per le schede.

LinkPreviewExtensionPoint

La configurazione di un attivatore che si attiva quando un utente digita o incolla un link da un servizio di terze parti o non Google in un file di Documenti, Fogli o Presentazioni Google.

Campi
labelText

string

Obbligatorio. Il testo di uno smart chip di esempio che chiede agli utenti di visualizzare l'anteprima del link, ad esempio Example: Support case. Questo testo è statico e viene visualizzato prima che gli utenti eseguano il componente aggiuntivo.

localizedLabelText

map<string, string>

Facoltativo. Una mappa di labelText da localizzare in altre lingue. Formatta la lingua in ISO 639 e il paese/la regione in ISO 3166, separati da un trattino -. Ad esempio, en-US.

Se le impostazioni internazionali di un utente sono presenti nelle chiavi della mappa, l'utente vedrà la versione localizzata del labelText.

patterns[]

UriPattern

Obbligatorio. Un array di pattern URL che attivano il componente aggiuntivo per visualizzare l'anteprima dei link.

runFunction

string

Obbligatorio. Endpoint da eseguire quando viene attivata un'anteprima del link.

logoUrl

string

Facoltativo. L'icona visualizzata nello smart chip e nella scheda di anteprima. Se omesso, il componente aggiuntivo utilizza la relativa icona della barra degli strumenti, logoUrl.

Formato comune per dichiarare un elemento di menu o un pulsante visualizzato all'interno di un'app host.

Campi
runFunction

string

Obbligatorio. L'endpoint da eseguire quando questo punto di estensione è attivato.

label

string

Obbligatorio. Testo visibile all'utente che descrive l'azione intrapresa attivando questo punto di estensione. Ad esempio, "Inserisci fattura".

logoUrl

string

L'URL dell'immagine del logo mostrata nella barra degli strumenti del componente aggiuntivo.

Se non viene impostato, viene utilizzato l'URL del logo principale del componente aggiuntivo.

UniversalActionExtensionPoint

Formato per la dichiarazione di un punto di estensione dell'elemento del menu di azioni universale.

Campi
label

string

Obbligatorio. Testo visibile all'utente che descrive l'azione intrapresa attivando questo punto di estensione, ad esempio "Aggiungi un nuovo contatto".

Campo unione action_type. Obbligatorio. Il tipo di azione supportato in un elemento del menu di azioni universali. Può essere un link da aprire o un endpoint da eseguire. action_type può essere solo uno dei seguenti:
runFunction

string

Endpoint da eseguire da UniversalAction.

UriPattern

La configurazione per ogni pattern URL che attiva un'anteprima del link.

Campi
hostPattern

string

Obbligatorio per l'anteprima di ogni pattern URL. Il dominio del pattern URL. Il componente aggiuntivo mostra l'anteprima dei link che contengono questo dominio nell'URL. Per visualizzare l'anteprima dei link per un sottodominio specifico, ad esempio subdomain.example.com, includilo. Per visualizzare l'anteprima dei link per l'intero dominio, specifica un carattere jolly con un asterisco (*) come sottodominio.

Ad esempio, *.example.com corrisponde a subdomain.example.com e another.subdomain.example.com.

pathPrefix

string

Facoltativo. Il percorso che aggiunge il dominio del hostPattern.

Ad esempio, se il pattern host dell'URL è support.example.com, per trovare una corrispondenza degli URL per le richieste ospitate su support.example.com/cases/, inserisci cases.

Per trovare tutte le corrispondenze per tutti gli URL nel dominio del pattern host, lascia vuoto pathPrefix.