- Recurso: Implementación
- Complementos
- CommonAddOnManifest
- LayoutProperties
- AddOnWidgetSet
- Tipo de widget
- HomepageExtensionPoint
- UniversalActionExtensionPoint
- GmailAddOnManifest
- ContextualTrigger
- UnconditionalTrigger (no condicional)
- UniversalAction
- ComposeTrigger
- MenuItemExtensionPoint
- Acceso borrador
- DriveAddOnManifest
- DriveExtensionPoint
- CalendarAddOnManifest
- ConferenceSolution
- CalendarExtensionPoint
- Acceso a eventos
- DocsAddOnManifest
- DocumentosExtensionPoint
- LinkPreviewExtensionPoint
- UriPattern
- SheetsAddOnManifest
- SheetsExtensionPoint
- SlidesAddOnManifest
- SlidesExtensionPoint
- HttpOptions
- HttpAuthorizationHeader
- Métodos
Recurso: Deployment
Implementación de un complemento de Google Workspace
Representación JSON |
---|
{
"name": string,
"oauthScopes": [
string
],
"addOns": {
object ( |
Campos | |
---|---|
name |
El nombre del recurso de implementación. Ejemplo: |
oauthScopes[] |
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 |
La configuración del complemento de Google Workspace |
etag |
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 ( |
Campos | |
---|---|
common |
Configuración que es común en todos los complementos de Google Workspace. |
gmail |
Configuración del complemento de Gmail |
drive |
Configuración del complemento de Drive |
calendar |
Configuración del complemento de Calendario |
docs |
Configuración del complemento de Documentos |
sheets |
Configuración del complemento de Hojas de cálculo. |
slides |
Configuración del complemento de Presentaciones. |
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 ( |
Campos | |
---|---|
name |
Obligatorio. El nombre visible del complemento. |
logoUrl |
Obligatorio. La URL de la imagen del logotipo que se muestra en la barra de herramientas de complementos |
layoutProperties |
Propiedades de diseño comunes para las tarjetas de complementos |
addOnWidgetSet |
Los widgets que se usan en el complemento. Si no se especifica este campo, se usará el conjunto predeterminado. |
useLocaleFromApp |
Indica si se debe pasar información regional de la app host. |
homepageTrigger |
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[] |
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 |
Una acción de OpenLink solo puede usar una URL con un esquema |
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 |
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 |
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 |
Habilita Material Design para tarjetas. |
SetOnWidgetSet
El subconjunto de widgets que usa un complemento.
Representación JSON |
---|
{
"usedWidgets": [
enum ( |
Campos | |
---|---|
usedWidgets[] |
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. |
FIXED_FOOTER |
Se corrigió el pie de página en una tarjeta. |
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 |
Obligatorio. El extremo que se ejecutará cuando se active este punto de extensión. |
enabled |
Opcional. Si se configura como Si no se establece, el valor predeterminado es 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 |
Campos | |
---|---|
label |
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: |
|
openLink |
URL que abrirá UniversalAction. |
runFunction |
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 ( |
Campos | |
---|---|
homepageTrigger |
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 |
contextualTriggers[] |
Define el conjunto de condiciones que activan el complemento. |
universalActions[] |
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 |
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 |
authorizationCheckFunction |
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 |
Campos | |
---|---|
onTriggerFunction |
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 |
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 |
Campos | |
---|---|
text |
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: |
|
openLink |
Es un vínculo que se abre en Gmail cuando el usuario activa la acción. |
runFunction |
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 ( |
Campos | |
---|---|
actions[] |
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 |
Define el nivel de acceso a los datos cuando se activa un complemento de tiempo de redacción. |
Punto de extensión de menú
Formato común para declarar un elemento o un botón de menú que aparece dentro de una app host.
Representación JSON |
---|
{ "runFunction": string, "label": string, "logoUrl": string } |
Campos | |
---|---|
runFunction |
Obligatorio. El extremo que se ejecutará cuando se active este punto de extensión. |
label |
Obligatorio. Texto visible para el usuario que describe la acción que se realiza al activar este punto de extensión. Por ejemplo, "Insertar factura". |
logoUrl |
La URL de la imagen del logotipo que se muestra en la barra de herramientas de complementos Si no está configurado, se establece de forma predeterminada en la URL del logotipo principal del complemento. |
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 ( |
Campos | |
---|---|
homepageTrigger |
Si está presente, anula la configuración de |
onItemsSelectedTrigger |
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 |
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 ( |
Campos | |
---|---|
homepageTrigger |
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 |
conferenceSolution[] |
Define las soluciones de conferencia que proporciona este complemento. |
createSettingsUrlFunction |
Un extremo para ejecutar que crea una URL a la página de configuración del complemento. |
eventOpenTrigger |
Un extremo que se activa cuando se abre un evento para verlo o editarlo. |
eventUpdateTrigger |
Un extremo que se activa cuando se actualiza el evento abierto |
currentEventAccess |
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 |
Obligatorio. El extremo al que se llamará cuando se deben crear datos de conferencia. |
id |
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 |
Obligatorio. El nombre visible de la solución de la conferencia. |
logoUrl |
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 |
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 ( |
Campos | |
---|---|
homepageTrigger |
Si está presente, anula la configuración de |
onFileScopeGrantedTrigger |
Extremo que se ejecutará cuando se otorgue autorización de alcance de archivo para este par de documento/usuario. |
linkPreviewTriggers[] |
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 |
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 ( |
Campos | |
---|---|
labelText |
Obligatorio. Es el texto de un chip inteligente de ejemplo que solicita a los usuarios que obtengan una vista previa del vínculo, como |
localizedLabelText |
Opcional. Mapa de Si la configuración regional del usuario está presente en las claves del mapa, este verá la versión localizada de Es un objeto que contiene una lista de pares |
patterns[] |
Obligatorio. Es un array de patrones de URL que activan el complemento para obtener vistas previas de vínculos. |
runFunction |
Obligatorio. Extremo para ejecutar cuando se activa una vista previa del vínculo. |
logoUrl |
Opcional. Ícono que se muestra en el chip inteligente Si se omite, el chip usará el ícono de la barra de herramientas del complemento, |
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 |
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 Por ejemplo, |
pathPrefix |
Opcional. Es la ruta de acceso que agrega el dominio de Por ejemplo, si el patrón del host de URL es Para que todas las URLs coincidan con el patrón del host, deja |
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 ( |
Campos | |
---|---|
homepageTrigger |
Si está presente, anula la configuración de |
onFileScopeGrantedTrigger |
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 |
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 ( |
Campos | |
---|---|
homepageTrigger |
Si está presente, anula la configuración de |
onFileScopeGrantedTrigger |
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 |
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 ( |
Campos | |
---|---|
authorizationHeader |
Configuración del token enviado en el encabezado de autorización |
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 |
|
---|---|
|
Crea una implementación con el nombre y la configuración especificados. |
|
Borra la implementación con el nombre dado. |
|
Obtiene la implementación con el nombre especificado. |
|
Obtiene el estado de instalación de una implementación de prueba. |
|
Instala una implementación en su cuenta para hacer pruebas. |
|
Enumera todas las implementaciones de un proyecto en particular. |
|
Crea o reemplaza una implementación con el nombre especificado. |
|
Desinstala una implementación de prueba de la cuenta del usuario. |