Questa pagina è stata tradotta dall'API Cloud Translation.

Risorsa manifest dell'editor

La configurazione delle risorse utilizzata per definire Componente aggiuntivo di Google Workspace i contenuti e il comportamento all'interno degli editor. I manifest dei componenti aggiuntivi di Google Workspace devono avere tutti i componenti contrassegnati come obbligatori se estendono l'Editor.

Editor

La configurazione del manifest del componente aggiuntivo Google Workspace per Estensioni editor. Consulta Estensione degli editor con i componenti aggiuntivi di Google Workspace per ulteriori informazioni.

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 trigger crea il componente aggiuntivo homepage nel la tua app host. Questa sostituisce . `addOns.common.homepageTrigger`
`onFileScopeGrantedTrigger`	`object (OnFileScopeGrantedTrigger)` Obbligatorio se il tuo componente aggiuntivo include un comportamento specifico del cliente attuale Documento dell'editor, 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, 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 finestra di dialogo di richiesta dell'ambito del file utilizzando CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); e l'utente concede drive.file autorizzazione dell'ambito.

Rappresentazione JSON
{ "runFunction": string }

Campi
`runFunction`	`string` Il nome della funzione da eseguire se l'ambito `drive.file` è concesso. Se specificata, devi implementare questa funzione per creare e restituiscono un array di `Card` oggetti 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 a Documenti, Fogli o Presentazioni.

Per configurare questo attivatore per un componente aggiuntivo di Google Workspace: vedi 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 per 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` per localizzare in altre lingue. Formattare la lingua in ISO 639 e paese/regione in ISO 3166, separate 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 `Card` che mostra 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 omesso, il componente aggiuntivo utilizza l'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

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` (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`.

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

(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 di un attivatore che si attiva quando un utente seleziona una terza parte voce di menu dell'integrazione dal menu @ di Documenti Google.

Per configurare questo attivatore per un componente aggiuntivo di Google Workspace: vedi 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 questa estensione punto di accesso. L'ID può contenere fino a 64 caratteri e deve essere nel formato `[a-zA-Z0-9-]+.`.
`labelText`	`string` Obbligatorio. Il testo visualizzato in @ ad esempio `Create support case`.
`localizedLabelText`	`map (key: string, value: string)` (Facoltativo) Una mappa di `labelText` per localizzare in altre lingue. Formattare la lingua in ISO 639 e paese/regione in ISO 3166, separate 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` (Facoltativo) L'icona visualizzata nel menu @. Se omesso, il componente aggiuntivo utilizza l'icona della barra degli strumenti `logoUrl`.