Questa pagina è stata tradotta dall'API Cloud Translation.

Risorsa manifest dell'editor

La configurazione delle risorse utilizzata per definire i contenuti e il comportamento del componente aggiuntivo Google Workspace negli editor. I manifest dei componenti aggiuntivi di Google Workspace devono avere tutti i componenti contrassegnati come Obbligatorio se estendono l'editor.

Editor

La configurazione del file manifest del componente aggiuntivo Google Workspace per le estensioni di Editor. Per ulteriori informazioni, consulta Estendere gli editor con i componenti aggiuntivi di Google Workspace.

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

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. Questo sostituisce `addOns.common.homepageTrigger`.
`onFileScopeGrantedTrigger`	`object (OnFileScopeGrantedTrigger)` Obbligatorio se il tuo componente aggiuntivo include un comportamento specifico per il 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 visualizzare 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 viene visualizzata la finestra di dialogo per richiedere l'ambito del file utilizzando CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); e l'utente concede l'autorizzazione di 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 proveniente da un servizio di terze parti o non Google in un file di Documenti, Fogli o Presentazioni.

Per configurare questo attivatore per un componente aggiuntivo di Google Workspace, consulta 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 uno smart chip di esempio che chiede 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)` 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 vedrà la versione localizzata del `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 mostri un'anteprima del link nell'interfaccia utente del componente aggiuntivo.
`logoUrl`	`string` Facoltativo. L'icona visualizzata nello smart chip e nella scheda di anteprima. Se viene omesso, il componente aggiuntivo utilizza la relativa 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

Campi
`hostPattern`	`string` Obbligatorio per l'anteprima di ogni pattern URL.Il dominio del pattern URL. Il componente aggiuntivo mostra 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`, includilo. 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 del `hostPattern`. Ad esempio, se il pattern host dell'URL è `support.example.com`, per trovare una corrispondenza degli URL per le richieste ospitate su `support.example.com/cases/`, utilizza `cases`. Per trovare tutte le corrispondenze per tutti gli URL nel dominio del pattern host, lascia vuoto `pathPrefix`.

hostPattern

string

Obbligatorio per l'anteprima di ogni pattern URL.Il dominio del pattern URL. Il componente aggiuntivo mostra 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, includilo. 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 del hostPattern.

Ad esempio, se il pattern host dell'URL è support.example.com, per trovare una corrispondenza degli URL per le richieste ospitate su support.example.com/cases/, utilizza cases.

Per trovare tutte le corrispondenze per tutti gli URL nel dominio del pattern host, lascia vuoto pathPrefix.

CreateActionTriggers

La configurazione di un attivatore che si attiva quando un utente seleziona un elemento del menu di integrazione di terze parti dal menu @ di Documenti Google.

Per configurare questo attivatore per un componente aggiuntivo di Google Workspace, consulta 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 distinguere questo punto di estensione. L'ID può contenere fino a 64 caratteri e deve avere il 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 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 vedrà la versione localizzata del `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 gli input per la creazione della risorsa di terze parti.
`logoUrl`	`string` Facoltativo. L'icona visualizzata nel menu @. Se viene omesso, il componente aggiuntivo utilizza la relativa icona della barra degli strumenti, `logoUrl`.