Package google.apps.script.type

Indice

AddOnWidgetSet

Il sottoinsieme del widget utilizzato da un componente aggiuntivo.

Campi
usedWidgets[]

WidgetType

L'elenco di widget utilizzati in un componente aggiuntivo.

WidgetType

Il tipo di widget. WIDGET_TYPE_UNSPECIFIED è l'insieme di widget di base.

Enum
WIDGET_TYPE_UNSPECIFIED L'insieme di widget predefinito.
DATE_PICKER Il selettore della data.
STYLED_BUTTONS I pulsanti con stile includono pulsanti riempiti 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 scrittura del componente aggiuntivo.

CommonAddOnManifest

Configurazione di componenti aggiuntivi condivisa tra tutte le applicazioni host dei componenti aggiuntivi.

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

Se trasferire informazioni sulle impostazioni internazionali dall'app host.
homepageTrigger

HomepageExtensionPoint

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

UniversalActionExtensionPoint

Definisce un elenco di punti di estensione nel menu Azioni universale che funge da menu di impostazioni per il componente aggiuntivo. Il punto di estensione può essere un URL di link da aprire o un endpoint da eseguire durante l'invio di un modulo.
openLinkUrlPrefixes

ListValue

Un'azione OpenLink può utilizzare soltanto 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 usato il valore HTTPS. I link HTTP vengono riscritti automaticamente in HTTPS link.

CreateActionExtensionPoint

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

Campi
id

string

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

string

Obbligatorio. Il testo visualizzato accanto all'icona per il punto di ingresso 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>

Campo facoltativo. Una mappa di labelText per localizzare in altre lingue. Formatta la lingua nel formato 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 vede la versione localizzata di labelText.
runFunction

string

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

string

Campo facoltativo. L'icona visualizzata per il punto di ingresso 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 viene attivato.
enabled

BoolValue

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

Se non viene configurato, il valore predefinito è true.

Se la visualizzazione della home page personalizzata di un componente aggiuntivo è disattivata, viene fornita agli utenti una scheda 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 ID per l'account di servizio di sistema del componente aggiuntivo Google Workspace specifico del progetto (impostazione predefinita).
USER_ID_TOKEN Invia un token ID 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 di autorizzazione HTTP.

LayoutProperties

Proprietà di 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. Consente di impostare il colore dei pulsanti. Se è impostato il colore principale, ma non è impostato alcun colore secondario, il colore secondario è lo stesso del colore principale. Se non viene impostato né il colore principale né il colore secondario, viene utilizzato il valore predefinito fornito dal framework.
useNewMaterialDesign

bool

Consente di attivare 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 richiede 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>

Campo facoltativo. Una mappa di labelText per localizzare in altre lingue. Formatta la lingua nel formato 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 vede la versione localizzata di labelText.
patterns[]

UriPattern

Obbligatorio. Un array di pattern URL che attivano il componente aggiuntivo per visualizzare i link di anteprima.
runFunction

string

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

string

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

Formato comune per la dichiarazione di una voce di menu o di un pulsante che viene visualizzato in un'app host.

Campi
runFunction

string

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

string

Obbligatorio. Testo visibile all'utente che descrive l'azione intrapresa dall'attivazione di 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 configurato, per impostazione predefinita viene utilizzato l'URL del logo principale del componente aggiuntivo.

UniversalActionExtensionPoint

Formato per la dichiarazione di un punto di estensione della voce del menu Azioni universale.

Campi
label

string

Obbligatorio. Testo visibile all'utente che descrive l'azione intrapresa dall'attivazione di questo punto di estensione, ad esempio "Aggiungi un nuovo contatto".
Campo di unione action_type. Obbligatorio. Il tipo di azione supportato per una voce del menu azione universale. Può essere un link da aprire o un endpoint da eseguire. action_type può essere solo uno dei seguenti:
runFunction

string

Endpoint che deve essere eseguito da UniversalAction.

UriPattern

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

Campi
hostPattern

string

Obbligatorio per ogni pattern URL da visualizzare in anteprima. Il dominio del pattern URL. Il componente aggiuntivo mostra in anteprima i link che contengono questo dominio nell'URL. Per visualizzare l'anteprima dei link per un sottodominio specifico, come subdomain.example.com, includi il sottodominio. 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

Campo facoltativo. Il percorso che aggiunge il dominio del hostPattern.

Ad esempio, se il pattern host dell'URL è support.example.com, inserisci cases per trovare corrispondenze con gli URL per i casi ospitati in support.example.com/cases/.

Per trovare la corrispondenza con tutti gli URL nel dominio dei pattern host, lascia vuoto il campo pathPrefix.