Recurso de manifiesto del editor

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

Editores

Es la configuración del manifiesto del complemento de Google Workspace para las extensiones del Editor. Consulta Cómo extender los 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 de activación crea la página principal del complemento en la app host. Esto anula addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Se requiere si el complemento incluye un comportamiento específico del documento actual del Editor, que se activa cuando el usuario autoriza el alcance de drive.file .
linkPreviewTriggers[]

object (LinkPreviewTriggers)

Se requiere para las vistas previas de vínculos. Es 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. Para obtener más información, consulta Vista previa de vínculos con chips inteligentes.
createActionTriggers[]

object (createActionTriggers)

Se requiere para crear recursos de terceros. Es una lista de activadores para crear recursos en un servicio de terceros desde el menú @. Para obtener más información, consulta Crea 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 de drive.file.

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

string

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

LinkPreviewTriggers

Es 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.

Para configurar este activador para un complemento de Google Workspace, consulta Vínculos de vista previa 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 ejemplo de chip inteligente 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. Es un mapa de labelText para localizar en otros idiomas. Formatea el idioma en ISO 639 y el país o la región 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, el usuario verá la versión localizada de labelText.
patterns[]

object (UriPattern)

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

string

Obligatorio. 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 que acepte un objeto de evento que contenga EDITOR_NAME.matchedUrl.url como argumento y muestre un solo objeto Card que muestre una vista previa del vínculo en la IU del complemento.
logoUrl

string

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

UriPattern

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

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

string

Se requiere para cada patrón de URL que se desee obtener una vista previa. Es el dominio del patrón de URL. El complemento muestra 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 con un asterisco (*) como subdominio.

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

string

Opcional. Es la ruta de acceso que agrega el dominio de hostPattern.

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

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

CreateActionTriggers

Es 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.

Para 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. Es el texto que aparece en el menú @, como Create support case.
localizedLabelText

map (key: string, value: string)

Opcional. Es un mapa de labelText para localizar en otros idiomas. Formatea el idioma en ISO 639 y el país o la región 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, el usuario verá la versión localizada de labelText.
runFunction

string

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

string

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