Risorsa manifest dell'editor

La configurazione delle risorse utilizzata per definire i contenuti e il comportamento del componente aggiuntivo Google Workspace all'interno degli editor. Se estendono l'Editor, tutti i componenti dei file manifest dei componenti aggiuntivi di Google Workspace devono essere contrassegnati come obbligatori.

Editor

La configurazione manifest del componente aggiuntivo Google Workspace per le estensioni Editor. Per saperne di più, consulta Estensione degli editor con i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
Campi
homepageTrigger

object (HomepageTrigger)

Questa funzione trigger crea la home page del componente aggiuntivo nell'app host. Questa sostituisce addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Obbligatorio se il componente aggiuntivo include un comportamento specifico del documento Editor corrente, attivato quando l'utente autorizza l'ambito drive.file .
linkPreviewTriggers[]

object (LinkPreviewTriggers)

Obbligatorio per le anteprime dei link. Un elenco di attivatori per la visualizzazione dell'anteprima dei link in un file di Documenti, Fogli o Presentazioni Google. Per maggiori dettagli, consulta Visualizzare l'anteprima dei link con smart chip.
createActionTriggers[]

object (createActionTriggers)

Obbligatorio per la creazione di risorse di terze parti. Un elenco di trigger per la creazione di risorse in un servizio di terze parti dal menu @. Per maggiori dettagli, consulta Creare risorse di terze parti con smart chip.

OnFileScopeGrantedTrigger

Una configurazione per un attivatore contestuale che si attiva quando la finestra di dialogo di richiesta dell'ambito del file utilizzando CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); e l'utente concede l'autorizzazione all'ambito drive.file.

Rappresentazione JSON 
{
  "runFunction": string
}
Campi
runFunction

string

Il nome della funzione da eseguire se viene concesso l'ambito drive.file. Se specificato, devi implementare questa funzione per creare e restituire un array di oggetti Card da visualizzare nell'interfaccia utente del componente aggiuntivo.

LinkPreviewTriggers

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.

Per configurare questo trigger per un componente aggiuntivo di Google Workspace, consulta Visualizzare l'anteprima dei link con smart chip.

Rappresentazione JSON 
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
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 (key: string, value: 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[]

object (UriPattern)

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

string

Obbligatorio. Il nome della funzione da eseguire quando l'utente autorizza l'ambito https://www.googleapis.com/auth/workspace.linkpreview. Se specificato, devi implementare questa funzione per accettare un oggetto evento contenente EDITOR_NAME.matchedUrl.url come argomento e restituire un singolo oggetto Card che mostra un'anteprima del link nell'interfaccia utente del componente aggiuntivo.
logoUrl

string

Campo 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.

UriPattern

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

Rappresentazione JSON 
{
  "hostPattern": string,
  "pathPrefix" : string
}
Campi
hostPattern

string

Obbligatorio per ogni pattern URL per l'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, 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

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

Ad esempio, se il pattern host dell'URL è support.example.com, utilizza cases per creare corrispondenze con gli URL per le richieste ospitate su support.example.com/cases/.

Per trovare corrispondenze di tutti gli URL nel dominio del pattern host, lascia vuoto il campo pathPrefix.

CreateActionTriggers

La configurazione per un attivatore che si attiva quando un utente seleziona una voce di menu per l'integrazione di terze parti dal menu @ di Documenti Google.

Per configurare questo trigger per un componente aggiuntivo di Google Workspace, consulta Creare risorse di terze parti con smart chip.

Rappresentazione JSON 
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
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 nel menu @, ad esempio Create support case.
localizedLabelText

map (key: string, value: 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. Il nome della funzione da eseguire quando un utente seleziona un punto di estensione dal menu @. La funzione deve restituire una scheda del modulo con input per la creazione della risorsa di terze parti.
logoUrl

string

Campo facoltativo. L'icona visualizzata nel menu @. Se omesso, il componente aggiuntivo utilizza la relativa icona della barra degli strumenti, logoUrl.