Risorsa manifest dell'editor

La configurazione delle risorse utilizzata per definire i componenti aggiuntivi di Google Workspace contenuti e comportamento negli editor. I manifest dei componenti aggiuntivi di Google Workspace devono includere tutti i componenti contrassegnati come Obbligatori se estendono l'editor.

Editor

La configurazione del manifest del componente aggiuntivo di Google Workspace per le estensioni dell'editor. Per maggiori dettagli, vedi Estendere gli 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 di attivazione crea la home page del componente aggiuntivo nell'app host. Questa impostazione sostituisce addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Obbligatorio se il componente aggiuntivo include un comportamento specifico per il documento corrente, attivato quando l'utente autorizza l'ambito drive.file.

linkPreviewTriggers[]

object (LinkPreviewTriggers)

Obbligatorio per le anteprime dei link. Un elenco di trigger per visualizzare l'anteprima dei link in un file di Documenti, Fogli o Presentazioni Google. Per maggiori dettagli, vedi Visualizzare l'anteprima dei link con gli 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 dettagli, vedi Creare risorse di terze parti con gli smart chip.

OnFileScopeGrantedTrigger

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

Rappresentazione JSON
{
  "runFunction": string
}
Campi
runFunction

string

Il nome della funzione da eseguire se l'ambito drive.file è concesso. La funzione deve restituire un array di Card oggetti per l'interfaccia utente.

LinkPreviewTriggers

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

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

Rappresentazione JSON
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
Campi
labelText

string

Obbligatorio. Il testo di un esempio di smart chip che invita gli utenti a visualizzare l'anteprima del link, ad esempio Example: Support case. Questo testo è statico.
localizedLabelText

map (key: string, value: 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 -.
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. La funzione deve accettare un oggetto evento, che include una matchedUrl.url proprietà contenente l'URL di cui visualizzare l'anteprima, e restituire un Card oggetto.
logoUrl

string

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

UriPattern

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

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

string

Obbligatorio per ogni pattern URL. Il dominio del pattern URL. Il componente aggiuntivo visualizza l'anteprima dei link contenenti questo dominio. Per trovare la corrispondenza con tutti i sottodomini, utilizza un asterisco (*) come carattere jolly.
pathPrefix

string

Facoltativo. Il percorso che aggiunge il dominio. Per trovare la corrispondenza con tutti gli URL nel dominio, lascia pathPrefix vuoto.

CreateActionTriggers

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

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

Rappresentazione JSON
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
Campi
id

string

Obbligatorio. L'ID univoco per questo punto di estensione. Utilizza fino a 64 caratteri 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)

Facoltativo. Una mappa di labelText da localizzare. Formatta la lingua in ISO 639 e il paese/la regione in ISO 3166, separati da un trattino -.
runFunction

string

Obbligatorio. Il nome della funzione da eseguire quando un utente seleziona un punto di estensione. La funzione deve restituire una scheda del modulo.
logoUrl

string

Facoltativo. L'icona visualizzata nel menu @. Se omesso, il componente aggiuntivo utilizza l'icona della barra degli strumenti, logoUrl.