Recurso de manifiesto del editor

La configuración de recursos que se usa para definir el contenido y el comportamiento del complemento de Google Workspace dentro de los editores Los manifiestos de complementos de Google Workspace deben tener todos los componentes marcados como Obligatorios si extienden el Editor.

Editores

Configuración del manifiesto del complemento de Google Workspace para las extensiones de Editor Consulta Cómo extender editores con complementos de Google Workspace para obtener más información.

Representación JSON
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
Campos
homepageTrigger

object (HomepageTrigger)

Esta función del activador crea la página principal del complemento en la app host. Esto anula addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Es obligatorio si tu complemento incluye un comportamiento específico del documento actual de Editor, que se activa cuando el usuario autoriza el permiso drive.file .

linkPreviewTriggers[]

object (LinkPreviewTriggers)

Obligatorio para las vistas previas de vínculos. Una lista de activadores para obtener una vista previa de los vínculos en un archivo de Documentos, Hojas de cálculo o Presentaciones de Google Si quieres conocer los detalles, consulta Cómo obtener una vista previa de vínculos con chips inteligentes.

createActionTriggers[]

object (createActionTriggers)

Obligatorio para la creación de recursos de terceros. Una lista de activadores para crear recursos en un servicio de terceros desde el menú @. Para obtener más información, consulta Cómo crear recursos de terceros con chips inteligentes.

OnFileScopeGrantedTrigger

Es una configuración para un activador contextual que se activa cuando el diálogo de alcance del archivo de solicitud usa CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); y el usuario otorga la autorización de alcance drive.file.

Representación JSON
{
  "runFunction": string
}
Campos
runFunction

string

Es el nombre de la función que se ejecutará si se otorga el permiso drive.file. Si se especifica, debes implementar esta función para compilar y mostrar un array de objetos Card para mostrar en la IU del complemento.

LinkPreviewTriggers

La configuración de un activador que se activa cuando un usuario escribe o pega un vínculo de un servicio de terceros o que no es de Google en un archivo de Documentos, Hojas de cálculo o Presentaciones.

Si quieres configurar este activador para un complemento de Google Workspace, consulta Cómo obtener una vista previa de los vínculos con chips inteligentes.

Representación JSON
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
Campos
labelText

string

Obligatorio. Es el texto de un chip inteligente de ejemplo que les solicita a los usuarios que obtengan una vista previa del vínculo, como Example: Support case. Este texto es estático y se muestra antes de que los usuarios ejecuten el complemento.
localizedLabelText

map (key: string, value: string)

Opcional. Mapa de labelText para localizar a otros idiomas. Aplica formato al idioma en ISO 639 y a los países o regiones en ISO 3166, separados por un guion -. Por ejemplo, en-US.

Si la configuración regional de un usuario está presente en las claves del mapa, este verá la versión localizada de labelText.

patterns[]

object (UriPattern)

Obligatorio. Un array de patrones de URL que activan el complemento para obtener una vista previa de los vínculos.
runFunction

string

Obligatorio. Es el nombre de la función que se ejecutará cuando el usuario autorice el alcance de https://www.googleapis.com/auth/workspace.linkpreview. Si se especifica, debes implementar esta función para aceptar un objeto de evento que contenga EDITOR_NAME.matchedUrl.url como argumento y mostrar un solo objeto Card que muestre una vista previa del vínculo en la IU del complemento.
logoUrl

string

Opcional. El ícono que se muestra en el chip inteligente y en la tarjeta de vista previa. Si se omite, el complemento usa el ícono de la barra de herramientas, logoUrl.

UriPattern

La configuración para cada patrón de URL que activa una vista previa del vínculo.

Representación JSON
{
  "hostPattern": string,
  "pathPrefix" : string
}
Campos
hostPattern

string

Obligatorio para cada patrón de URL de la que se debe obtener una vista previa. Es el dominio del patrón de URL. El complemento ofrece una vista previa de los vínculos que contienen este dominio en la URL. Para obtener una vista previa de los vínculos de un subdominio específico, como subdomain.example.com, incluye el subdominio. Para obtener una vista previa de los vínculos de todo el dominio, especifica un carácter comodín y un asterisco (*) como subdominio.

Por ejemplo, *.example.com coincide con subdomain.example.com y another.subdomain.example.com.

pathPrefix

string

Opcional. La ruta de acceso que agrega el dominio de hostPattern.

Por ejemplo, si el patrón de host de URL es support.example.com, usa cases para que coincida con las URLs de los casos alojados en support.example.com/cases/.

Para que todas las URL del dominio del patrón de host coincidan, deja pathPrefix vacío.

CreateActionTriggers

La configuración de un activador que se activa cuando un usuario selecciona un elemento de menú de integración de terceros en el menú @ de Documentos de Google.

Si deseas configurar este activador para un complemento de Google Workspace, consulta Crea recursos de terceros con chips inteligentes.

Representación JSON
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
Campos
id

string

Obligatorio. Es el ID único para diferenciar este punto de extensión. El ID puede tener hasta 64 caracteres y debe tener el formato [a-zA-Z0-9-]+..
labelText

string

Obligatorio. El texto que aparece en el menú @, como Create support case
localizedLabelText

map (key: string, value: string)

Opcional. Mapa de labelText para localizar a otros idiomas. Aplica formato al idioma en ISO 639 y a los países o regiones en ISO 3166, separados por un guion -. Por ejemplo, en-US.

Si la configuración regional de un usuario está presente en las claves del mapa, este verá la versión localizada de labelText.

runFunction

string

Obligatorio. Es el nombre de la función que se ejecutará cuando un usuario seleccione un punto de extensión en el menú @. La función debe mostrar una tarjeta de formulario con entradas para crear el recurso de terceros.
logoUrl

string

Opcional. Ícono que se muestra en el menú @. Si se omite, el complemento usa el ícono de la barra de herramientas, logoUrl.