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. I manifest dei componenti aggiuntivi di Google Workspace devono includere tutti i componenti contrassegnati come Obbligatorio se estendono l'editor.

Editor

La configurazione del manifest del componente aggiuntivo 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 operazione 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 l'anteprima dei link in un file di Documenti, Fogli o Presentazioni Google. Per maggiori dettagli, vedi 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, 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 viene concesso. La funzione deve restituire un array di oggetti Card per la UI.

LinkPreviewTriggers

La configurazione di 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 Link di anteprima 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 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 proprietà matchedUrl.url contenente l'URL da visualizzare in anteprima, e restituire un oggetto Card.
logoUrl

string

Facoltativo. L'icona visualizzata nel chip intelligente 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 tutti gli URL nel dominio, lascia vuoto pathPrefix.

CreateActionTriggers

La configurazione di un attivatore 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 di 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.