REST Resource: projects.deployments

Recurso: Deployment

Implementación de un complemento de Google Workspace

Representación JSON
{
  "name": string,
  "oauthScopes": [
    string
  ],
  "addOns": {
    object (AddOns)
  },
  "etag": string
}
Campos
name

string

El nombre del recurso de implementación. Ejemplo: projects/123/deployments/my_deployment.

oauthScopes[]

string

Es la lista de permisos de Google OAuth para los cuales se debe solicitar el consentimiento del usuario final antes de ejecutar un extremo complementario.

addOns

object (AddOns)

La configuración del complemento de Google Workspace

etag

string

El servidor calcula este valor en función de la versión de la implementación en el almacenamiento y se puede enviar cuando se solicitan actualizaciones y eliminaciones para garantizar que el cliente tenga un valor actualizado antes de continuar.

Complementos

Un complemento de Google Workspace.

Representación JSON
{
  "common": {
    object (CommonAddOnManifest)
  },
  "gmail": {
    object (GmailAddOnManifest)
  },
  "drive": {
    object (DriveAddOnManifest)
  },
  "calendar": {
    object (CalendarAddOnManifest)
  },
  "docs": {
    object (DocsAddOnManifest)
  },
  "sheets": {
    object (SheetsAddOnManifest)
  },
  "slides": {
    object (SlidesAddOnManifest)
  },
  "httpOptions": {
    object (HttpOptions)
  }
}
Campos
common

object (CommonAddOnManifest)

Configuración que es común en todos los complementos de Google Workspace.

gmail

object (GmailAddOnManifest)

Configuración del complemento de Gmail

drive

object (DriveAddOnManifest)

Configuración del complemento de Drive

calendar

object (CalendarAddOnManifest)

Configuración del complemento de Calendario

docs

object (DocsAddOnManifest)

Configuración del complemento de Documentos

sheets

object (SheetsAddOnManifest)

Configuración del complemento de Hojas de cálculo.

slides

object (SlidesAddOnManifest)

Configuración del complemento de Presentaciones.

httpOptions

object (HttpOptions)

Opciones para enviar solicitudes a extremos HTTP de complementos

CommonAddOnManifest;

Configuración de complementos que se comparte entre todas las aplicaciones de host de complementos.

Representación JSON
{
  "name": string,
  "logoUrl": string,
  "layoutProperties": {
    object (LayoutProperties)
  },
  "addOnWidgetSet": {
    object (AddOnWidgetSet)
  },
  "useLocaleFromApp": boolean,
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "universalActions": [
    {
      object (UniversalActionExtensionPoint)
    }
  ],
  "openLinkUrlPrefixes": array
}
Campos
name

string

Obligatorio. El nombre visible del complemento.

logoUrl

string

Obligatorio. La URL de la imagen del logotipo que se muestra en la barra de herramientas de complementos

layoutProperties

object (LayoutProperties)

Propiedades de diseño comunes para las tarjetas de complementos

addOnWidgetSet

object (AddOnWidgetSet)

Los widgets que se usan en el complemento. Si no se especifica este campo, se usará el conjunto predeterminado.

useLocaleFromApp

boolean

Indica si se debe pasar información regional de la app host.

homepageTrigger

object (HomepageExtensionPoint)

Define un extremo que se ejecutará en cualquier contexto y en cualquier host. Todas las tarjetas generadas por esta función siempre estarán disponibles para el usuario, pero es posible que el contenido contextual las eclipse cuando este complemento declare activadores más segmentados.

universalActions[]

object (UniversalActionExtensionPoint)

Define una lista de puntos de extensiones en el menú de acciones universales, que sirve como menú de configuración del complemento. El punto de extensión puede ser una URL de vínculo para abrir o un extremo para ejecutar como envío de formulario.

openLinkUrlPrefixes

array (ListValue format)

Una acción de OpenLink solo puede usar una URL con un esquema HTTPS, MAILTO o TEL. Para los vínculos de HTTPS, la URL también debe coincidir con uno de los prefijos especificados en la lista de entidades permitidas. Si el prefijo omite el esquema, se supone que es HTTPS. Los vínculos HTTP se vuelven a escribir automáticamente en los vínculos HTTPS.

Propiedades de diseño

Propiedades de diseño de tarjetas compartidas en todas las aplicaciones de host complementarias

Representación JSON
{
  "primaryColor": string,
  "secondaryColor": string,
  "useNewMaterialDesign": boolean
}
Campos
primaryColor

string

El color principal del complemento Establece el color de la barra de herramientas. Si no se establece un color principal, se usa el valor predeterminado que proporciona el framework.

secondaryColor

string

El color secundario del complemento Establece el color de los botones. Si se configuró el color principal, pero no se configuró ningún color secundario, el color secundario será el mismo que el principal. Si no se establecen el color principal ni el secundario, se usa el valor predeterminado que proporciona el framework.

useNewMaterialDesign

boolean

Habilita Material Design para tarjetas.

SetOnWidgetSet

El subconjunto de widgets que usa un complemento.

Representación JSON
{
  "usedWidgets": [
    enum (WidgetType)
  ]
}
Campos
usedWidgets[]

enum (WidgetType)

La lista de widgets que se usan en un complemento.

Tipo de widget

Es el tipo de widget. WIDGET_TYPE_UNSPECIFIED es el widget básico configurado.

Enumeradores
WIDGET_TYPE_UNSPECIFIED Se configuró el widget predeterminado.
DATE_PICKER El selector de fecha.
STYLED_BUTTONS Los botones con estilo incluyen los botones rellenos y los desactivados.
PERSISTENT_FORMS Los formularios persistentes permiten conservar valores de formularios durante las acciones.
UPDATE_SUBJECT_AND_RECIPIENTS Actualice el asunto y los destinatarios de un borrador.
GRID_WIDGET El widget de cuadrícula
ADDON_COMPOSE_UI_ACTION Una acción del complemento de Gmail que se aplica a la IU de Compose del complemento

Punto de extensión de la página principal

Formato común para declarar la vista de la página principal de un complemento.

Representación JSON
{
  "runFunction": string,
  "enabled": boolean
}
Campos
runFunction

string

Obligatorio. El extremo que se ejecutará cuando se active este punto de extensión.

enabled

boolean

Opcional. Si se configura como false, se desactiva la vista de la página principal en este contexto.

Si no se establece, el valor predeterminado es true.

Si se inhabilita la vista personalizada de la página principal de un complemento, se proporcionará a los usuarios una tarjeta de descripción general genérica.

UniversalActionExtensionPoint

Formato para declarar un punto de extensión del elemento del menú de acción universal

Representación JSON
{
  "label": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
Campos
label

string

Obligatorio. Texto visible para el usuario que describe la acción que se realiza al activar este punto de extensión, por ejemplo, "Agregar un contacto nuevo".

Campo de unión action_type. Obligatorio. Es el tipo de acción compatible en un elemento del menú de acción universal. Puede ser un vínculo para abrir o un extremo para ejecutar. Las direcciones (action_type) solo pueden ser una de las siguientes opciones:
runFunction

string

Extremo que ejecutará UniversalAction.

Manifiesto de complemento de Gmail

Propiedades que personalizan el aspecto y la ejecución de un complemento de Gmail

Representación JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "authorizationCheckFunction": string
}
Campos
homepageTrigger

object (HomepageExtensionPoint)

Define un extremo que se ejecutará en contextos que no coinciden con un activador contextual declarado. Todas las tarjetas generadas por esta función siempre estarán disponibles para el usuario, pero el contenido contextual las puede eclipsar cuando este complemento declare activadores más segmentados.

Si está presente, anula la configuración de addons.common.homepageTrigger.

contextualTriggers[]

object (ContextualTrigger)

Define el conjunto de condiciones que activan el complemento.

universalActions[]

object (UniversalAction)

Define un conjunto de acciones universales para el complemento. El usuario activa acciones universales desde el menú de la barra de herramientas de complementos.

composeTrigger

object (ComposeTrigger)

Define el activador del tiempo de redacción para un complemento de tiempo de redacción. Este es el activador que genera la acción de un complemento cuando el usuario redacta un correo electrónico. Todos los complementos de redacción deben tener el permiso gmail.addons.current.action.compose, aunque podría no editar el borrador.

authorizationCheckFunction

string

El nombre de un extremo que sondea las APIs de terceros para verificar que el complemento tenga todas las autorizaciones de terceros requeridas. Si el sondeo falla, la función debe arrojar una excepción para iniciar el flujo de autorización. Se llama a esta función antes de cada invocación del complemento para garantizar una experiencia del usuario fluida.

Activador contextual

Define un activador que se activa cuando el correo electrónico abierto cumple con un criterio específico. Cuando el activador se activa, ejecuta un extremo específico, en general para crear tarjetas nuevas y actualizar la IU.

Representación JSON
{
  "onTriggerFunction": string,

  // Union field trigger can be only one of the following:
  "unconditional": {
    object (UnconditionalTrigger)
  }
  // End of list of possible types for union field trigger.
}
Campos
onTriggerFunction

string

Obligatorio. El nombre del extremo al que se llamará cuando un mensaje coincida con el activador.

Campo de unión trigger. El tipo de activador determina las condiciones que usa Gmail para mostrar el complemento. Las direcciones (trigger) solo pueden ser una de las siguientes opciones:
unconditional

object (UnconditionalTrigger)

Los activadores incondicionales se ejecutan cuando se abre un mensaje de correo electrónico.

Activador condicional

Este tipo no tiene campos.

Un activador que se activa cuando se abre un mensaje de correo electrónico.

Acción universal

Una acción que siempre está disponible en el menú de la barra de herramientas de complementos, independientemente del contexto del mensaje.

Representación JSON
{
  "text": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
Campos
text

string

Obligatorio. Texto visible para el usuario que describe la acción, por ejemplo, "Agregar un contacto nuevo".

Campo de unión action_type. El tipo de acción determina el comportamiento de Gmail cuando el usuario la invoca. Las direcciones (action_type) solo pueden ser una de las siguientes opciones:
runFunction

string

Un extremo al que se llama cuando el usuario activa la acción. Consulta la guía de acciones universales para obtener más detalles.

Activador de Compose

Un activador que se activa cuando el usuario redacta un correo electrónico.

Representación JSON
{
  "actions": [
    {
      object (MenuItemExtensionPoint)
    }
  ],
  "draftAccess": enum (DraftAccess)
}
Campos
actions[]

object (MenuItemExtensionPoint)

Define el conjunto de acciones para un complemento de tiempo de redacción. Estas son acciones que los usuarios pueden activar en un complemento de redacción.

draftAccess

enum (DraftAccess)

Define el nivel de acceso a los datos cuando se activa un complemento de tiempo de redacción.

Acceso desde borrador

Una enumeración que define el nivel de acceso a los datos que requiere el activador de Compose.

Enumeradores
UNSPECIFIED Valor predeterminado cuando no hay nada configurado para el acceso en borrador
NONE El activador de redacción no puede acceder a ningún dato del borrador cuando se activa un complemento de redacción.
METADATA Otorga al activador de redacción el permiso para acceder a los metadatos del borrador cuando se activa un complemento de redacción. Esto incluye la lista de público, como las listas Para y Cc de un borrador de mensaje.

DriveAddOnManifest.

Propiedades que personalizan el aspecto y la ejecución de un complemento de Drive

Representación JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onItemsSelectedTrigger": {
    object (DriveExtensionPoint)
  }
}
Campos
homepageTrigger

object (HomepageExtensionPoint)

Si está presente, anula la configuración de addons.common.homepageTrigger.

onItemsSelectedTrigger

object (DriveExtensionPoint)

Corresponde al comportamiento que se ejecuta cuando se seleccionan elementos en la vista de Drive relevante, como la lista de documentos de Mi unidad.

Punto de extensión de Drive

Formato común para declarar los activadores de un complemento de Drive.

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

string

Obligatorio. El extremo que se ejecutará cuando se active el punto de extensión.

Calendario sobre complementos

Propiedades que personalizan el aspecto y la ejecución de un complemento de Calendario

Representación JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "createSettingsUrlFunction": string,
  "eventOpenTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventUpdateTrigger": {
    object (CalendarExtensionPoint)
  },
  "currentEventAccess": enum (EventAccess)
}
Campos
homepageTrigger

object (HomepageExtensionPoint)

Define un extremo que se ejecuta en contextos que no coinciden con un activador contextual declarado. Todas las tarjetas generadas por esta función siempre estarán disponibles para el usuario, pero es posible que el contenido contextual las eclipse cuando este complemento declare activadores más segmentados.

Si está presente, anula la configuración de addons.common.homepageTrigger.

conferenceSolution[]

object (ConferenceSolution)

Define las soluciones de conferencia que proporciona este complemento.

createSettingsUrlFunction

string

Un extremo para ejecutar que crea una URL a la página de configuración del complemento.

eventOpenTrigger

object (CalendarExtensionPoint)

Un extremo que se activa cuando se abre un evento para verlo o editarlo.

eventUpdateTrigger

object (CalendarExtensionPoint)

Un extremo que se activa cuando se actualiza el evento abierto

currentEventAccess

enum (EventAccess)

Define el nivel de acceso a los datos cuando se activa un complemento de evento.

Solución de conferencias

Define los valores relacionados con la conferencia.

Representación JSON
{
  "onCreateFunction": string,
  "id": string,
  "name": string,
  "logoUrl": string
}
Campos
onCreateFunction

string

Obligatorio. El extremo al que se llamará cuando se deben crear datos de conferencia.

id

string

Obligatorio. Los ID deben asignarse de forma única entre las soluciones de conferencia de un complemento; de lo contrario, podría usarse la solución de conferencia incorrecta cuando se activa el complemento. Si bien puede cambiar el nombre visible de un complemento, el ID no se debe cambiar.

name

string

Obligatorio. El nombre visible de la solución de la conferencia.

logoUrl

string

Obligatorio. URL de la imagen del logotipo de la solución de conferencia.

Punto de extensión de calendario

Formato común para declarar los activadores de un complemento de calendario.

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

string

Obligatorio. El extremo que se ejecutará cuando se active este punto de extensión.

Acceso al evento

Una enumeración que define el nivel de activadores de eventos de acceso a los datos requiere.

Enumeradores
UNSPECIFIED Valor predeterminado cuando no se establece nada para eventAccess.
METADATA Otorga a los activadores de eventos el permiso para acceder a los metadatos de los eventos, como el ID de evento y el ID de calendario.
READ Otorga acceso a los activadores de eventos a todos los campos de eventos proporcionados, incluidos los metadatos, los asistentes y los datos de conferencias.
WRITE Otorga acceso a los activadores de eventos a los metadatos de los eventos y permite realizar todas las acciones, como agregar asistentes y configurar los datos de conferencias.
READ_WRITE Brinda acceso a los activadores de eventos a todos los campos de eventos proporcionados, incluidos los metadatos, los asistentes y los datos de conferencias, además de la capacidad de realizar todas las acciones.

DocumentosAddOnManifest

Propiedades que personalizan el aspecto y la ejecución de un complemento de Documentos de Google

Representación JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (DocsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ]
}
Campos
homepageTrigger

object (HomepageExtensionPoint)

Si está presente, anula la configuración de addons.common.homepageTrigger.

onFileScopeGrantedTrigger

object (DocsExtensionPoint)

Extremo que se ejecutará cuando se otorgue autorización de alcance de archivo para este par de documento/usuario.

linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

Una lista de puntos de extensiones para obtener vistas previas de vínculos en un archivo de Documentos de Google. Para obtener más información, consulta Cómo obtener vistas previas de vínculos con chips inteligentes.

Extensión de Documentos

Formato común para declarar los activadores de un complemento de Documentos.

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

string

Obligatorio. El extremo que se ejecutará cuando se active este punto de extensión.

Punto de extensión de vista previa de vínculos

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 de terceros en un archivo de Documentos de Google.

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

string

Obligatorio. Es el texto de un chip inteligente de ejemplo que 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 Usa el formato 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 del usuario está presente en las claves del mapa, este verá la versión localizada de labeltext.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

patterns[]

object (UriPattern)

Obligatorio. Es un array de patrones de URL que activan el complemento para obtener vistas previas de vínculos.

runFunction

string

Obligatorio. Extremo para ejecutar cuando se activa una vista previa del vínculo.

logoUrl

string

Opcional. Ícono que se muestra en el chip inteligente Si se omite, el chip usará el ícono de la barra de herramientas del complemento, logourl.

Patrón de URI

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

Obligatorio para cada patrón de URL de vista previa. Es el dominio del patrón de URL. Los vínculos de vistas previas del complemento 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 del host de URL es support.example.com, ingresa cases para que coincida con las URL de los casos alojados en support.example.com/cases/.

Para que todas las URLs coincidan con el patrón del host, deja pathprefix vacío.

Hojas de cálculo para agregar manifiesto

Propiedades que personalizan el aspecto y la ejecución de un complemento de Hojas de cálculo de Google

Representación JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SheetsExtensionPoint)
  }
}
Campos
homepageTrigger

object (HomepageExtensionPoint)

Si está presente, anula la configuración de addons.common.homepageTrigger.

onFileScopeGrantedTrigger

object (SheetsExtensionPoint)

Extremo que se ejecutará cuando se otorgue autorización de alcance de archivo para este par de documento/usuario.

Extensión de las Hojas de cálculo

Formato común para declarar los activadores de un complemento de Hojas de cálculo.

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

string

Obligatorio. El extremo que se ejecutará cuando se active este punto de extensión.

PresentacionesAddOnManifest

Propiedades que personalizan el aspecto y la ejecución de un complemento de Presentaciones de Google

Representación JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SlidesExtensionPoint)
  }
}
Campos
homepageTrigger

object (HomepageExtensionPoint)

Si está presente, anula la configuración de addons.common.homepageTrigger.

onFileScopeGrantedTrigger

object (SlidesExtensionPoint)

Extremo que se ejecutará cuando se otorgue autorización de alcance de archivo para este par de documento/usuario.

Extensión de diapositivas

Formato común para declarar los activadores de un complemento de Presentaciones.

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

string

Obligatorio. El extremo que se ejecutará cuando se active este punto de extensión.

Opciones de HttpOptions

Opciones para enviar solicitudes a los extremos HTTP del complemento.

Representación JSON
{
  "authorizationHeader": enum (HttpAuthorizationHeader)
}
Campos
authorizationHeader

enum (HttpAuthorizationHeader)

Configuración del token enviado en el encabezado de autorización HTTP.

Encabezado de HttpAuthorization

El encabezado de autorización se envió en las solicitudes de complemento de HTTP.

Enumeradores
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED Valor predeterminado, que equivale a SYSTEM_ID_TOKEN.
SYSTEM_ID_TOKEN Envía un token de ID para la cuenta de servicio del sistema del complemento de Google Workspace específico del proyecto (predeterminado).
USER_ID_TOKEN Envía un token de ID para el usuario final.
NONE No envíe un encabezado de autenticación.

Métodos

create

Crea una implementación con el nombre y la configuración especificados.

delete

Borra la implementación con el nombre dado.

get

Obtiene la implementación con el nombre especificado.

getInstallStatus

Obtiene el estado de instalación de una implementación de prueba.

install

Instala una implementación en su cuenta para hacer pruebas.

list

Enumera todas las implementaciones de un proyecto en particular.

replaceDeployment

Crea o reemplaza una implementación con el nombre especificado.

uninstall

Desinstala una implementación de prueba de la cuenta del usuario.