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 dentro de los editores. Los manifiestos de complementos de Google Workspace deben tener todos los componentes marcados como Obligatorios si extienden el Editor.

Editores

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

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

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

linkPreviewTriggers[]

object (LinkPreviewTriggers)

Obligatorio 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 Vínculos de vista previa con chips inteligentes.

createActionTriggers[]

object (createActionTriggers)

Obligatorio para la creación de 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 se solicita el diálogo de permiso de archivo con CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); y el usuario otorga la autorización de permiso 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 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 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. Un mapa de labelText para localizar a otros idiomas. Da formato al idioma en ISO 639 y al país o 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. Es el nombre de la función que se ejecutará cuando el usuario autorice el permiso 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. Es el ícono que se muestra en el chip inteligente y la tarjeta de vista previa. Si se omite, el complemento usa su ícono de barra de herramientas, logoUrl.

UriPattern

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

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

string

Obligatorio para que se muestre una vista previa de cada patrón de URL.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, inclúyelo. Para obtener una vista previa de los vínculos de todo el dominio, especifica un carácter comodín con un asterisco (*) como el 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 URL es support.example.com, para hacer coincidir las URLs de los casos alojados en support.example.com/cases/, usa cases.

Para que coincida con 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 Cómo crear 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 de [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. Un mapa de labelText para localizar a otros idiomas. Da formato al idioma en ISO 639 y al país o 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. Es el nombre de la función que se ejecutará cuando un usuario seleccione un punto de extensión del menú @. La función debe mostrar 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 su ícono de barra de herramientas, logoUrl.