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 persistenti consentono di conservare 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 alla UI 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 il set predefinito.
useLocaleFromApp

bool

Se trasmettere le informazioni sulle impostazioni internazionali dall'app host.
homepageTrigger

HomepageExtensionPoint

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

UniversalActionExtensionPoint

Definisce un elenco di punti di estensione nel menu delle azioni universali che funge da menu delle impostazioni per il componente aggiuntivo. Il punto di estensione può essere un URL di 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 utilizzato HTTPS. I link HTTP vengono riscritti automaticamente in link HTTPS.

CreateActionExtensionPoint

La configurazione di un trigger che viene attivato quando un utente richiama il flusso di lavoro di creazione delle risorse in un'applicazione Google Workspace. Per saperne di più, 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 essere nel formato [a-zA-Z0-9-]+.
labelText

string

Obbligatorio. Il testo visualizzato accanto a un'icona per il punto di accesso alla creazione di risorse, 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 vede la versione localizzata di labelText.
runFunction

string

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

string

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

GranularOauthPermissionSupport

Indica se il componente aggiuntivo ha attivato il consenso OAuth granulare.

Enum
GRANULAR_OAUTH_PERMISSION_SUPPORT_UNSPECIFIED Valore predefinito, non deve essere utilizzato.
OPT_IN Il componente aggiuntivo ha attivato il consenso OAuth granulare.
OPT_OUT Il componente aggiuntivo non utilizza il consenso OAuth granulare.

HomepageExtensionPoint

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

Campi
runFunction

string

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

BoolValue

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

Se non 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 ID per l'account di servizio di sistema del componente aggiuntivo Google Workspace specifico per il 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 del componente aggiuntivo HTTP.

Campi
authorizationHeader

HttpAuthorizationHeader

Configurazione del token inviato nell'intestazione di autorizzazione HTTP.
granularOauthPermissionSupport

GranularOauthPermissionSupport

Indica se il componente aggiuntivo ha attivato il consenso OAuth granulare.

LayoutProperties

Proprietà del layout delle schede condivise in 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 è 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 è uguale al colore principale. Se non vengono impostati né il colore principale né quello secondario, viene utilizzato il valore predefinito fornito dal framework.
useNewMaterialDesign
(deprecated)

bool

Attiva il Material Design per le schede.

LinkPreviewExtensionPoint

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

Campi
labelText

string

Obbligatorio. Il testo di uno smart chip di esempio che invita gli utenti a 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 vede la versione localizzata di 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 nel chip intelligente e nella scheda di anteprima. Se omesso, il componente aggiuntivo utilizza la sua icona della barra degli strumenti, logoUrl.

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

Campi
runFunction

string

Obbligatorio. L'endpoint da eseguire quando viene attivato questo punto di estensione.
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, il valore predefinito è l'URL del logo principale del componente aggiuntivo.

UniversalActionExtensionPoint

Formato per dichiarare un punto di estensione della voce di menu delle azioni universali.

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 una voce di menu delle 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 visualizzare l'anteprima di ogni pattern URL. Il dominio del pattern URL. Il componente aggiuntivo visualizza 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, 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

Facoltativo. Il percorso che aggiunge il dominio di hostPattern.

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

Per trovare tutti gli URL nel dominio del pattern host, lascia vuoto pathPrefix.