Objetos de eventos

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Los objetos de eventos son estructuras JSON que se construyen y se pasan automáticamente como parámetros para activar o llamar a funciones de devolución de llamada cuando un usuario interactúa con un complemento. Los objetos de evento tienen información del cliente sobre la app host y el contexto actual a la función de devolución de llamada del servidor.

Los complementos de Google Workspace usan objetos de eventos en tres lugares:

  • Activadores de la página principal: Cada función homepageTrigger que defines recibe un objeto de evento automáticamente cuando se activa la función activadora de la página principal. Puedes usar este objeto en la función de activación de la página principal para identificar la app host activa, la plataforma del cliente, la configuración regional del usuario y otra información.

    Los objetos de eventos creados cuando se activa la página principal no contienen todos los campos incluidos en los otros dos casos. Se omiten los campos relacionados con widgets y la información contextual.

  • Activadores contextuales: Cada aplicación host proporciona un conjunto diferente de activadores contextuales que se activan cuando el usuario ingresa en un contexto específico. Por ejemplo, Gmail proporciona un activador contextual cuando un usuario abre un mensaje y otro cuando redacta un mensaje. El Calendario de Google proporciona un activador contextual para el momento en que un usuario abre un evento. Google Drive proporciona un activador contextual cuando un usuario selecciona archivos de Drive.

    Cuando se activa un activador contextual, la aplicación host llama al runFunction correspondiente que aparece en el manifiesto del complemento y le pasa un objeto de evento como parámetro. Los objetos de evento creados cuando se activan los activadores contextuales contienen todos los campos incluidos en los objetos de evento del activador de la página principal, además de los campos que contienen información contextual.

  • Acciones del widget. Los objetos de evento también se usan para proporcionar interactividad con widgets, mediante el mismo modelo de acción que usan los complementos de Gmail. Los complementos de Google Workspace usan las mismas funciones de controlador de widgets, objetos Action y respuestas de acciones. Sin embargo, en los complementos de Google Workspace, los objetos de eventos de acción incluyen aún más información en la que puede actuar una función de devolución de llamada.

    Los objetos de eventos creados como resultado de las acciones del widget contienen todos los campos incluidos en los objetos de eventos de activación contextuales, además de los campos que contienen información del widget.

En esta página, se describe la nueva estructura de los objetos de evento del complemento de Google Workspace.

Estructura del objeto de evento

En la siguiente tabla, se describe la estructura de nivel superior de los objetos de evento del complemento de Google Workspace. La estructura del objeto de evento incluye un campo de nivel superior commonEventObject para la información independiente del host. Cada objeto de evento también puede tener uno de los siguientes campos de nivel superior específicos del host, determinados por la app host activa: gmailEventObject, calendarEventObject o driveEventObject.

Para la retrocompatibilidad, los objetos de eventos del complemento de Google Workspace también incluyen todos los campos originales que se usan en los objetos de eventos de acción del complemento de Gmail. Estos campos se enumeran en la tabla que aparece debajo de "Campos de complementos de Gmail originales". La información de estos campos se reproduce en una nueva estructura de objetos.

Objeto de evento
eventObject.commonEventObject Common fields object
Es un objeto que contiene información común a todos los objetos de evento, sin importar la aplicación host.
eventObject.calendar Calendar event object
Solo está disponible si el host que realiza la llamada es Calendario de Google. Un objeto que contiene información de calendario y de eventos.
eventObject.drive Drive event object
Solo está presente si el host de llamada es Google Drive. Un objeto que contiene información de Drive.
eventObject.gmail Gmail event object
Solo está presente si el host de llamada es Gmail. Un objeto que contiene información de Gmail.
eventObject.docs Docs event object
Solo está presente si el host de llamada es Documentos de Google. Un objeto que contiene información de Documentos.
eventObject.sheets Sheets event object
Solo está presente si el host que realiza la llamada es Hojas de cálculo de Google. Un objeto que contiene información de Hojas de cálculo.
eventObject.slides Slides event object
Solo está presente si el host que realiza la llamada es Presentaciones de Google. Un objeto que contiene información de Presentaciones.
Campos del complemento de Gmail original
eventObject.messageMetadata.accessToken string
Obsoleto. Un token de acceso. Puedes usar esta opción para habilitar el acceso a los datos del usuario mediante los permisos temporales del complemento de Gmail.

Para los complementos de Google Workspace, busca esta información en el campo eventObject.gmail.accessToken.

eventObject.messageMetadata.messageId string
Obsoleto. El ID de mensaje de la conversación abierta en la IU de Gmail.

Para los complementos de Google Workspace, busca esta información en el campo eventObject.gmail.messageId.

eventObject.clientPlatform string
Obsoleto. Indica dónde se origina el evento (web, iOS o Android).

Para los complementos de Google Workspace, busca esta información en el campo eventObject.commonEventObject.platform.

eventObject.formInput object
Obsoleto. Mapa de los valores actuales de todos los widgets de formularios de la tarjeta, restringido a un valor por widget. Las claves son los ID de string asociados con los widgets, y los valores son strings. El objeto de evento proporciona formInput como una ventaja para cuando necesitas leer datos de varios widgets con los valores singulares esperados, como interruptores y entradas de texto. Para los widgets con valores múltiples, como las casillas de verificación, puedes leer cada valor de formInputs en su lugar.

En el caso de los complementos de Google Workspace, busca esta información en el campo eventObject.commonEventObject.formInputs; los widgets con valores únicos se representan como arreglos con un solo elemento.

eventObject.formInputs object
Obsoleto. Un mapa de los valores actuales de los widgets en la tarjeta, presentados como listas de strings. Las claves son los ID de string asociados con el widget. Para los widgets de un solo valor, el valor se presenta en un arreglo de un solo elemento. Para los widgets de varios valores, como los grupos de casillas de verificación, todos los valores se presentan en una lista.

Para los complementos de Google Workspace, busca esta información en el campo eventObject.commonEventObject.formInputs.

eventObject.parameters object
Obsoleto. Un mapa de los parámetros adicionales que proporcionas al Action con Action.setParameters(). Las claves y los valores del mapa son strings.

Para los complementos de Google Workspace, busca esta información en el campo eventObject.commonEventObject.parameters.

eventObject.userCountry string
Inhabilitado y desactivado de forma predeterminada. El código de dos letras que indica el país o la región del usuario. También puede ser un código de país UN M49.

Para los complementos de Google Workspace, busca esta información en el campo eventObject.commonEventObject.userLocale.

eventObject.userLocale string
Inhabilitado y desactivado de forma predeterminada. El código ISO 639 de dos letras que indica el idioma del usuario. Consulta Cómo acceder a la configuración regional y la zona horaria del usuario para obtener más detalles.

Para los complementos de Google Workspace, busca esta información en el campo eventObject.commonEventObject.userLocale.

eventObject.userTimezone.id string
Inhabilitado y desactivado de forma predeterminada. El identificador de zona horaria del usuario. Los ejemplos incluyen: America/New_York, Europe/Vienna y Asia/Seoul. Consulta Cómo acceder a la configuración regional y zona horaria del usuario para obtener más información.

Para los complementos de Google Workspace, busca esta información en el campo eventObject.commonEventObject.timeZone.id.

eventObject.userTimezone.offset string
Inhabilitado y desactivado de forma predeterminada. El desfase de tiempo del tiempo universal coordinado (UTC) de la zona horaria del usuario, medido en milisegundos. Consulta Cómo acceder a la configuración regional y zona horaria del usuario para obtener más información.

Para los complementos de Google Workspace, busca esta información en el campo eventObject.commonEventObject.timeZone.offset.

Objeto de evento común

El objeto de evento común es la parte del objeto de evento general que lleva información general independiente del host al complemento desde el cliente del usuario. Esta información incluye detalles como la configuración regional, la app host y la plataforma del usuario.

Además de los activadores contextuales y la página principal, los complementos construyen y pasan objetos de eventos a las funciones de devolución de llamada de acción cuando el usuario interactúa con los widgets. La función de devolución de llamada del complemento puede consultar el objeto de evento común para determinar el contenido de los widgets abiertos en el cliente del usuario. Por ejemplo, tu complemento puede ubicar el texto que un usuario ingresó en un widget TextInput en el objeto eventObject.commentEventObject.formInputs.

Campos de objeto de evento comunes
commonEventObject.platform string
Indica dónde se origina el evento (`WEB`, `IOS` o `ANDROID`).
commonEventObject.formInputs object
Un mapa que contiene los valores actuales de los widgets en la tarjeta que se muestra. Las claves del mapa son los ID de string asignados con cada widget y cada valor es otro objeto wrapper con una sola clave "". La estructura del objeto de valor de mapa depende del tipo de widget:
  • Widgets de valor único (por ejemplo, un cuadro de texto): una lista de strings (solo un elemento).

    Ejemplo: Para un widget de entrada de texto con employeeName como su ID, accede al valor de entrada de texto con: e.commonEventObject.formInputs.employeeName[""].stringInputs.value[0].

  • Widgets con valores múltiples (por ejemplo, grupos de casillas de verificación): una lista de strings.

    Ejemplo: Para un widget de varios valores con participants como su ID, accede al arreglo de valores con: e.commonEventObject.formInputs.participants[""].stringInputs.value.

  • A date-time picker: Es un DateTimeInput object.

    Ejemplo: Para un selector con un ID de myDTPicker, accede al objeto DateTimeInput con e.commonEventObject.formInputs.myDTPicker[""].dateTimeInput.

  • A date-only picker: Es un DateInput object.

    Ejemplo: Para un selector con un ID de myDatePicker, accede al objeto DateInput con e.commonEventObject.formInputs.myDatePicker[""].dateInput.

  • A time-only picker: Es un TimeInput object.

    Ejemplo: Para un selector con un ID de myTimePicker, accede al objeto TimeInput con e.commonEventObject.formInputs.myTimePicker[""].timeInput.

commonEventObject.hostApp string
Indica la app host en la que está activo el complemento cuando se genera el objeto de evento. Entre los valores posibles, se incluyen los siguientes:
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
Cualquier parámetro adicional que proporciones al Action mediante Action.setParameters().
commonEventObject.userLocale string
Inhabilitado de forma predeterminada. El identificador de idioma y país/región del usuario con el formato de código de idioma ISO 639 código de idioma ISO 3166. Por ejemplo, en-US.

Para habilitar este campo, debes establecer `addOns.common.useLocaleFromApp` en “true” en el manifiesto del complemento. La lista de permisos del complemento también debe incluir "https://www.googleapis.com/auth/script.locale". Para obtener más detalles, consulta Cómo acceder a la configuración regional y zona horaria del usuario.

commonEventObject.timeZone string
Inhabilitado de forma predeterminada. El ID y el desplazamiento de la zona horaria Para habilitar este campo, debes establecer `addOns.common.useLocaleFromApp` como `true` en el manifiesto del complemento. La lista de alcance del complemento también debe incluir "https://www.googleapis.com/auth/script.locale". Para obtener más detalles, consulta Cómo acceder a la configuración regional y zona horaria del usuario.
commonEventObject.timeZone.id string
Es el identificador de zona horaria del usuario. Los ejemplos incluyen: America/New_York, Europe/Vienna y Asia/Seoul. Para habilitar este campo, debes establecer `addOns.common.useLocaleFromApp` como `true` en el manifiesto del complemento. La lista de permisos del complemento también debe incluir "https://www.googleapis.com/auth/script.locale". Para obtener más detalles, consulta Cómo acceder a la configuración regional y zona horaria del usuario.
commonEventObject.timeZone.offset string
Es la desviación horaria de la hora universal coordinada (UTC) de la zona horaria del usuario, medida en milisegundos. Consulta Cómo acceder a la configuración regional y zona horaria del usuario para obtener más información.

Entradas del formulario de selector de fecha y hora

Las funciones de devolución de llamada de acción pueden recibir valores de widgets actuales en el campo commonEventObject.formInputs. Esto incluye los valores de fecha y hora seleccionados por el usuario en los widgets del selector de fecha y hora. Sin embargo, la estructura de la información varía según si el widget se configuró como un selector de fecha y hora, un selector de solo fecha o un selector de solo hora. Las diferencias estructurales se describen en la siguiente tabla:

Objeto DateTimeInput
dateTimeInput.hasDate boolean
true si la fecha y hora de entrada incluyen una fecha; si false solo incluye una hora.
dateTimeInput.hasTime boolean
true si la fecha y hora de entrada incluyen una hora; si false solo incluye una fecha.
dateTimeInput.msSinceEpoch string
Es la hora seleccionada por el usuario en milisegundos desde el comienzo del período (00:00:00 UTC del 1 de enero de 1970).
Objeto DateInput
dateInput.msSinceEpoch string
Es la hora seleccionada por el usuario en milisegundos desde el comienzo del período (00:00:00 UTC del 1 de enero de 1970).
Objeto TimeInput
timeInput.hours number
Es el número de hora seleccionado por el usuario.
timeInput.minutes number
Es el número de minutos que seleccionó el usuario.

Objeto de evento de calendario

El objeto de evento de calendario es la parte del objeto de evento general que lleva información sobre el calendario y los eventos de calendario de un usuario. Solo está presente en un objeto de evento si la aplicación host es Calendario de Google.

En la siguiente tabla, se enumeran los campos presentes en el campo calendarEventObject de un objeto de evento. Los campos marcados como Datos generados por el usuario están presentes en el objeto del evento solo si los datos están presentes en el evento de Calendario y el complemento configura su campo de manifiesto como addOns.calendar.currentEventAccess o READ_WRITE.

Objeto de evento de calendario
calendar.attendees[] list of attendee objects
Datos generados por el usuario. Una lista de los asistentes al evento del calendario.
calendar.calendarId string
El ID del calendario
calendar.capabilities object
Datos generados por el usuario. Un objeto que describe las capacidades del complemento para ver o actualizar la información del evento.
calendar.capabilities.canAddAttendees boolean
Datos generados por el usuario. true si el complemento puede agregar nuevos asistentes a la lista de asistentes del evento; de lo contrario, false.
calendar.capabilities.canSeeAttendees boolean
Datos generados por el usuario. true si el complemento puede leer la lista de asistentes del evento; de lo contrario, false.
calendar.capabilities.canSeeConferenceData boolean
Datos generados por el usuario. true si el complemento puede leer los datos de la conferencia de eventos; de lo contrario, false.
calendar.capabilities.canSetConferenceData boolean
Datos generados por el usuario. true si el complemento puede actualizar los datos de la conferencia de eventos; de lo contrario, false.
calendar.capabilities.canAddAttachments boolean
Datos generados por el usuario. true si el complemento puede agregar archivos adjuntos nuevos al evento; de lo contrario, false.
calendar.conferenceData Conference data object
Datos generados por el usuario. Un objeto que representa cualquier dato de conferencia asociado con este evento, como los detalles de la reunión de Google Meet.
calendar.id string
El ID del evento.
calendar.organizer object
Es un objeto que representa al organizador del evento.
calendar.organizer.email string
La dirección de correo electrónico del organizador del evento.
calendar.recurringEventId string
El ID de un evento recurrente.

Asistente

Los objetos de los asistentes llevan información sobre los asistentes individuales a los eventos de Calendario de Google. Esta información está presente en el objeto del evento solo si los datos están presentes en el evento de Calendario y el complemento configura su campo de manifiesto addOns.calendar.currentEventAccess como READ o READ_WRITE.

Objeto asistente
attendee.additionalGuests number
Indica la cantidad de invitados adicionales que el asistente había indicado que estaba llevando. La configuración predeterminada es cero.
attendee.comment string
El comentario de la respuesta del asistente, si corresponde
attendee.displayName string
El nombre visible del asistente.
attendee.email string
Dirección de correo electrónico de los asistentes.
attendee.optional boolean
true si la asistencia a este asistente se marca como opcional; de lo contrario, false.
attendee.organizer boolean
true si el asistente es un organizador de este evento.
attendee.resource boolean
true si el asistente representa un recurso, como una sala o un equipo; false en caso contrario
attendee.responseStatus string
Estado de respuesta del asistente Entre los valores posibles, se incluyen los siguientes:
  • accepted: El asistente aceptó la invitación al evento.
  • declined: El asistente rechazó la invitación al evento.
  • needsAction: El asistente no respondió a la invitación al evento.
  • tentative: El asistente aceptó tentativamente la invitación al evento.
attendee.self boolean
true si este asistente representa el calendario en el que aparece el evento; de lo contrario, se mostrará false.

Datos de la conferencia

Los objetos de datos de conferencia llevan información sobre conferencias que se adjuntan a eventos de Calendario de Google. Pueden ser soluciones de conferencia de Google, como Google Meet, o conferencias de terceros. Esta información está presente en el objeto de evento solo si los datos están presentes en el evento de Calendario y el complemento establece su campo de manifiesto addOns.calendar.currentEventAccess como READ o READ_WRITE.

Objeto de datos de conferencia
conferenceData.conferenceId string
El ID de la conferencia. Este ID permite que las aplicaciones realicen un seguimiento de las conferencias; no debes mostrarlo a los usuarios.
conferenceData.conferenceSolution object
Un objeto que representa la solución de conferencia, como Hangouts o Google Meet.
conferenceData.conferenceSolution.iconUri string
El URI del ícono visible para el usuario que representa esta solución de conferencia.
conferenceData.conferenceSolution.key object
La clave que identifica de forma exclusiva la solución de conferencia para este evento.
conferenceData.conferenceSolution.key.type string
El tipo de solución de conferencia. Entre los valores posibles, se incluyen los siguientes:
  • eventHangout para Hangouts para consumidores (http://hangouts.google.com).
  • eventNamedHangout para la versión clásica de Hangouts para los usuarios de Google Workspace (http://hangouts.google.com).
  • hangoutsMeet para Google Meet (http://meet.google.com)
conferenceData.conferenceSolution.name string
El nombre visible para el usuario de esta solución de conferencia (no localizada).
conferenceData.entryPoints[] list of entry point objects
La lista de puntos de entrada de la conferencia, como URL o números de teléfono.
conferenceData.notes string
Notas adicionales (como instrucciones del administrador del dominio o avisos legales) sobre la conferencia que se mostrarán al usuario Puede contener HTML. La longitud máxima es de 2,048 caracteres.
conferenceData.parameters object
Un objeto que contiene un mapa de datos de parámetros definidos para que use el complemento.
conferenceData.parameters.addOnParameters object
Un mapa de valores y claves de string de parámetros. El desarrollador del complemento define estos valores y claves a fin de adjuntar información a una conferencia específica para su uso.

Punto de entrada

Los objetos de punto de entrada llevan información sobre los medios establecidos para acceder a una conferencia determinada, como por teléfono o video. Esta información está presente en el objeto del evento solo si los datos están presentes en el evento de Calendario y el complemento establece su campo de manifiesto addOns.calendar.currentEventAccess como READ o READ_WRITE.

Objeto de punto de entrada
entryPoint.accessCode string
Es el código de acceso que se usa para acceder a la conferencia. La longitud máxima es de 128 caracteres. Por lo general, los proveedores de conferencias solo usan un subconjunto de {accessCode, meetingCode, passcode, password, pin} para proporcionar acceso a las conferencias. Haz coincidir y solo muestra los campos que usa el proveedor de la conferencia.
entryPoint.entryPointFeatures list
Características del punto de entrada Actualmente, estas características solo se aplican a phone puntos de entrada:
  • toll: El punto de entrada es una llamada telefónica gratuita.
  • toll_free: El punto de entrada es una llamada telefónica gratuita.
entryPoint.entryPointType string
El tipo de punto de entrada. Los valores posibles son los siguientes:
  • more: Instrucciones adicionales para unirse a la conferencia, como números de teléfono alternativos. Una conferencia solo puede tener un punto de entrada more; si está presente, también se requiere otro tipo de punto de entrada.
  • phone: Únete a la conferencia por medio de un número de teléfono. Una conferencia puede tener cero o más puntos de entrada de phone. Calendario de Google solo muestra los dos primeros puntos de entrada de teléfonos después de ordenarlos y ordenarlos alfabéticamente.
  • sip: Únete a la conferencia por SIP. Una conferencia puede tener como máximo un punto de entrada de sip.
  • video: Únete a la conferencia por HTTP. Una conferencia puede tener como máximo un punto de entrada de video.
entryPoint.label string
Es la etiqueta visible para el usuario del URI del punto de entrada (no localizado).
entryPoint.meetingCode string
Es el código de reunión que se usó para acceder a la conferencia. La longitud máxima es de 128 caracteres. Por lo general, los proveedores de conferencias solo usan un subconjunto de {accessCode, meetingCode, passcode, password, pin} para proporcionar acceso a las conferencias. Haz coincidir y solo muestra los campos que usa el proveedor de la conferencia.
entryPoint.passcode string
La contraseña que se usó para acceder a la conferencia. La longitud máxima es de 128 caracteres. Por lo general, los proveedores de conferencias solo usan un subconjunto de {accessCode, meetingCode, passcode, password, pin} para proporcionar acceso a las conferencias. Haz coincidir y solo muestra los campos que usa el proveedor de la conferencia.
entryPoint.password string
La contraseña que se usó para acceder a la conferencia. La longitud máxima es de 128 caracteres. Por lo general, los proveedores de conferencias solo usan un subconjunto de {accessCode, meetingCode, passcode, password, pin} para proporcionar acceso a las conferencias. Haz coincidir y solo muestra los campos que usa el proveedor de la conferencia.
entryPoint.pin string
El PIN que se usa para acceder a la conferencia. La longitud máxima es de 128 caracteres. Por lo general, los proveedores de conferencias solo usan un subconjunto de {accessCode, meetingCode, passcode, password, pin} para proporcionar acceso a las conferencias. Haz coincidir y solo muestra los campos que usa el proveedor de la conferencia.
entryPoint.regionCode string
Código de región del número de teléfono. Necesaria para los usuarios si el URI no incluye un código de país. Los valores se basan en la lista pública de códigos de región de CLDR.
entryPoint.uri string
El URI del punto de entrada. La longitud máxima es de 1,300 caracteres. El formato depende del tipo de punto de entrada:
  • more: Se requiere un esquema http: o https:.
  • phone: Se requiere un esquema tel:. El URI debe incluir toda la secuencia de marcado (por ejemplo, &telt;tel:+12345678900,12345678;1234").
  • sip: Se requiere un esquema sip: o sips:. Por ejemplo, &sol:12345678@miproveedor.com".
  • video: Se requiere un esquema http: o https:.

Objeto de evento de Drive

El objeto de evento de Drive es la parte del objeto de evento general que lleva información sobre la cuenta de Google Drive de un usuario y su contenido. Solo está presente en un objeto de evento si la aplicación host es Google Drive.

Objeto de evento de Drive
drive.activeCursorItem Drive item object
El elemento de Drive que está activo actualmente
drive.selectedItems[] list of Drive item objects
Una lista de elementos (archivos o carpetas) seleccionados en Drive

Elemento de Drive

Los objetos de elementos de Drive contienen información sobre elementos específicos de Drive, como archivos o carpetas.

Objeto del elemento de Drive
item.addonHasFileScopePermission boolean
Si es true, el complemento solicitó y recibió la autorización de alcance https://www.googleapis.com/auth/drive.file para este elemento; de lo contrario, este campo es false.
item.id string
Es el ID del elemento seleccionado.
item.iconUrl string
Es la URL del ícono que representa el elemento seleccionado.
item.mimeType string
Es el tipo de MIME del elemento seleccionado.
item.title string
Es el título del elemento seleccionado.

Objeto de evento de Gmail

El objeto de evento de Gmail es la parte del objeto de evento general que lleva información sobre los mensajes de Gmail de un usuario. Solo está presente en un objeto de evento si la aplicación host es Gmail.

Objeto de evento de Gmail
gmail.accessToken string
El token de acceso específico de Gmail. Puedes usar este token con el método GmailApp.setCurrentMessageAccessToken(accessToken) para otorgar a tu complemento acceso temporal a un mensaje de Gmail abierto actualmente del usuario o permitir que tu complemento redacte nuevos borradores.
gmail.bccRecipients[] list of strings
Inhabilitado de forma predeterminada. La lista de direcciones de correo electrónico de los destinatarios incluidas actualmente en un borrador que está redactando el complemento. Para habilitar este campo, debes configurar el campo "addOns.gmail.composeTrigger.draftAccess" en tu manifiesto como "METADATA".
gmail.ccRecipients[] list of strings
Inhabilitado de forma predeterminada. La lista de direcciones de correo electrónico de los destinatarios incluidas actualmente en un borrador que el complemento está redactando. Para habilitar este campo, debes configurar el campo "addOns.gmail.composeTrigger.draftAccess" en tu manifiesto como "METADATA".
gmail.messageId string
El ID del mensaje de Gmail abierto
gmail.threadId string
El ID de conversación de Gmail actualmente abierto.
gmail.toRecipients[] list of strings
Inhabilitado de forma predeterminada. La lista de direcciones de correo electrónico de los destinatarios incluidas actualmente en un borrador que compone el complemento. Para habilitar este campo, debes configurar el campo "addOns.gmail.composeTrigger.draftAccess" en tu manifiesto como "METADATA".

Objeto de evento de Documentos

El objeto de evento de Documentos es la parte del objeto de evento general que lleva información sobre el documento de un usuario y su contenido. Solo está presente en un objeto de evento si la aplicación host es Documentos de Google.

Objeto de evento de Documentos
docs.id string
Solo está presente si el usuario autorizó el permiso https://www.googleapis.com/auth/drive.file. El ID del documento abierto en la IU de Documentos.
docs.title stringSolo está presente si el usuario autorizó el permiso https://www.googleapis.com/auth/drive.file.
El título del documento se abre en la IU de Documentos.
docs.addonHasFileScopePermission boolean
Si es true, el complemento solicitó y recibió la autorización de alcance https://www.googleapis.com/auth/drive.file para el documento abierto en la IU de Documentos; de lo contrario, este campo es false.

Objeto de evento de Hojas de cálculo

El objeto de evento de Hojas de cálculo es la parte del objeto de evento general que lleva información sobre el documento de un usuario y su contenido. Solo está presente en un objeto de evento si la aplicación host es de Hojas de cálculo de Google.

Objeto de evento de Hojas de cálculo
sheets.id string
Solo está presente si el usuario autorizó el permiso https://www.googleapis.com/auth/drive.file. El ID de la hoja de cálculo abierta en la IU de Hojas de cálculo.
sheets.title string
Solo está presente si el usuario autorizó el permiso https://www.googleapis.com/auth/drive.file. El título de la hoja de cálculo abierta en la IU de Hojas de cálculo.
sheets.addonHasFileScopePermission boolean
Si es true, el complemento solicitó y recibió la autorización de alcance https://www.googleapis.com/auth/drive.file para la hoja de cálculo abierta en la IU de Hojas de cálculo; de lo contrario, este campo es false.

Objeto de evento de Presentaciones

El objeto de evento de Presentaciones es la parte del objeto de evento general que lleva información sobre el documento de un usuario y su contenido. Solo está presente en un objeto de evento si la aplicación host es Presentaciones de Google.

Objeto de evento de Presentaciones
slides.id string
Solo está presente si el usuario autorizó el permiso https://www.googleapis.com/auth/drive.file. Es el ID de la presentación abierta en la IU de Presentaciones.
slides.title string
Solo está presente si el usuario autorizó el permiso https://www.googleapis.com/auth/drive.file. El título de la presentación abierto en la IU de Presentaciones.
slides.addonHasFileScopePermission boolean
Si es true, el complemento solicitó y recibió la autorización de alcance https://www.googleapis.com/auth/drive.file para la presentación abierta en la IU de Presentaciones; de lo contrario, este campo es false.