Objetos de eventos

En esta página, se describe la estructura de los objetos de eventos de los complementos de Google Workspace.

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

Los complementos de Google Workspace usan objetos de evento en los siguientes lugares:

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

    Los objetos de evento creados cuando la página principal activa el incendio no contienen todos los campos incluidos en los otros dos casos; campos pertenecientes a los widgets y se omite la información contextual.

  • Activadores contextuales. Cada aplicación host proporciona un conjunto diferente de activadores contextuales que se activan cuando el usuario ingresa a un contexto específico. Por ejemplo:

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

  • Acciones del widget. Los objetos de evento también se usan para proporcionar interactividad con el widget con 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 y acción Action de respuestas ante incidentes. Sin embargo, en los complementos de Google Workspace, objetos de eventos de acción Incluye más información sobre la que pueda actuar una función de devolución de llamada.

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

  • Obtén una vista previa de los activadores de vínculos. En Documentos, Hojas de cálculo y Presentaciones de Google, puedes configurar vistas previas de vínculos para servicios de terceros en función de patrones de URL específicos. Cuando los usuarios interactúan con un vínculo que cumple con el patrón, se activa linkPreviewTriggers y se pasa un objeto de evento que contiene el vínculo a la función de devolución de llamada del activador. Tu complemento puede usar este objeto de evento para crear un chip y una tarjeta inteligentes que muestren información sobre el vínculo dentro de la aplicación anfitrión. También puedes compilar acciones de widgets para permitir que los usuarios interactúen con la tarjeta de vista previa y su contenido.

Estructura del objeto de evento

La siguiente tabla describe la estructura de nivel superior de Objetos de evento de complementos de Google Workspace. El evento de objetos incluye un elemento commonEventObject campo de nivel superior para obtener 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, determinado por el app host activa: gmailEventObject, calendarEventObject o driveEventObject.

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

Objeto de evento
eventObject.commonEventObject Common fields object
Un objeto que contiene información común a todos los objetos de evento, independientemente de la aplicación host.
eventObject.calendar Calendar event object
Solo está presente si el host que realiza la llamada es el Calendario de Google. Es un objeto que contiene información de calendarios y eventos.
eventObject.drive Drive event object
Solo está presente si el host que realiza la llamada es Google Drive. Un objeto con información de Drive.
eventObject.gmail Gmail event object
Solo está presente si el host que realiza la llamada es Gmail. Un objeto con información de Gmail.
eventObject.docs Docs event object
Solo está presente si el host que realiza la llamada es Documentos de Google. Es 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. Es un objeto que contiene información de Hojas de cálculo.
eventObject.slides Slides event object
Solo está presente si el organizador que realiza la llamada es Presentaciones de Google. Es un objeto que contiene información de Presentaciones.
Campos originales del complemento de Gmail
eventObject.messageMetadata.accessToken string
Obsoleto. Un token de acceso. Puedes usar esta acción para activar el acceso a los datos del usuario por medio de permisos temporales de complementos de Gmail.

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

eventObject.messageMetadata.messageId string
Obsoleto. El ID del mensaje del subproceso que se abre en la IU de Gmail

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

eventObject.clientPlatform string
Obsoleto. Indica dónde ocurrió el evento se origine (Web, iOS o Android).

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

eventObject.formInput object
Obsoleto. Es un mapa de los valores actuales de todos los widgets de formulario de la tarjeta, restringido a un valor por widget. El son los IDs de cadena asociados con los widgets, y los valores se cadenas. El objeto del evento proporciona formInput como comodidad para cuando necesitas leer datos de varios widgets con valores singulares esperados, como entradas de texto y interruptores. En el caso de los widgets de varios valores, como las casillas de verificación, puedes leer cada valor de formInputs.

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 arrays con un solo elemento.

eventObject.formInputs object
Obsoleto. Un mapa de los valores actuales de widgets en la tarjeta, presentados como listas de cadenas. Las claves son los IDs de cadena asociados con el widget. Para los widgets de valor único, la se presenta en un array de un solo elemento. Para widgets con 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 la eventObject.commonEventObject.formInputs .

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

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

eventObject.userCountry string
Obsoleto e inhabilitado 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 numérico M49 de la ONU.

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

eventObject.userLocale string
Quedó obsoleto y está inhabilitado de forma predeterminada. El dos letras ISO 639 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 información.

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

eventObject.userTimezone.id string
Obsoleto e inhabilitado de forma predeterminada. El identificador de zona horaria de la zona horaria del usuario. Entre los ejemplos, se incluyen America/New_York, Europe/Vienna y Asia/Seoul. Consulta Accede 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 la eventObject.commonEventObject.timeZone.id .

eventObject.userTimezone.offset string
Obsoleto e inhabilitado de forma predeterminada. El diferencia horaria respecto de la hora universal coordinada (UTC) la zona horaria, medida en milisegundos. Consulta Cómo acceder a la configuración regional y la zona horaria del usuario para obtener más información.

En el caso de 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 de 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 de tu 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 comunes de objetos de eventos
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 de asignación son los IDs de cadena se asignan con cada widget.

La estructura del objeto de valor del mapa es depende del tipo de widget:

  • Widgets de valor único (por ejemplo, un cuadro de texto): Una lista de cadenas (solo un elemento).

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

  • Widgets de varios valores (por ejemplo, grupos de casillas de verificación): Una lista de cadenas.

    Ejemplo: para un widget de varios valores con participants como su ID, accede al valor array con: e.commonEventObject.formInputs.participants.stringInputs.value

  • A date-time picker: 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: 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: Un objeto 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 aplicación 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 suministro a Action mediante Action.setParameters()
commonEventObject.userLocale string
Inhabilitado de forma predeterminada. El idioma del usuario y el identificador de país o región en el formato de código de idioma ISO 639-código de país o región ISO 3166 Por ejemplo, en-US.

Para activar este campo, debes establecer addOns.common.useLocaleFromApp en true en el manifiesto de tu complemento. La lista de permisos de tu complemento también debe incluir https://www.googleapis.com/auth/script.locale. Consulta Accede a la configuración regional y la zona horaria del usuario para obtener más detalles.

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

Entradas del formulario del selector de fecha y hora

Las funciones de devolución de llamada de acción pueden recibir los valores actuales del widget en el campo commonEventObject.formInputs. Esto incluye los valores de fecha o hora seleccionados por el usuario en los widgets de selector de fecha o hora. Sin embargo, la estructura de la información difiere 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 hora y fecha de entrada incluye una fecha; si es false, solo se incluye una hora.
dateTimeInput.hasTime boolean
true si la fecha y hora de entrada incluyen una hora; si es false, solo se incluye una fecha.
dateTimeInput.msSinceEpoch string
La hora que selecciona el usuario, en milisegundos desde la época (00:00:00 UTC del 1 de enero de 1970).
Objeto DateInput
dateInput.msSinceEpoch string
Es la hora que seleccionó el usuario, expresada en milisegundos desde la época (00:00:00 UTC del 1 de enero de 1970).
Objeto TimeInput
timeInput.hours number
Es el número de hora que seleccionó 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 contiene información sobre el calendario y los eventos de calendario de un usuario. Es solo 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 calendarEventObject de un objeto de evento. Los campos marcados como Datos generados por el usuario son los siguientes: presente en el objeto de evento solo si los datos están presentes en el Calendario evento y el complemento establece su addOns.calendar.currentEventAccess manifiesto campo a READ 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 calendario evento.
calendar.calendarId string
El ID del calendario.
calendar.capabilities object
Datos generados por usuarios. Un objeto describir las capacidades del complemento para ver o actualizar un evento información.
calendar.capabilities.canAddAttendees boolean
Datos generados por usuarios. true si el complemento puede agregar asistentes nuevos a la lista de asistentes del evento; false de lo contrario.
calendar.capabilities.canSeeAttendees boolean
Datos generados por usuarios true si el complemento puede leer la lista de asistentes al evento false de lo contrario.
calendar.capabilities.canSeeConferenceData boolean
Datos generados por usuarios true si el complemento puede leer los datos de la conferencia del evento; false de lo contrario.
calendar.capabilities.canSetConferenceData boolean
Datos generados por usuarios. true si el complemento puede actualizar los datos de la conferencia del evento; false de lo contrario.
calendar.capabilities.canAddAttachments boolean
Datos generados por usuarios true si el complemento puede agregar nuevos archivos adjuntos al evento De lo contrario, false.
calendar.conferenceData Conference data object
Datos generados por el usuario. Un objeto que representa los datos de una conferencia asociados con este evento, como los detalles de la conferencia de Google Meet.
calendar.id string
El ID del evento.
calendar.organizer object
Un objeto que representa al organizador de la evento.
calendar.organizer.email string
La dirección de correo electrónico del organizador del evento.
calendar.recurringEventId string
Es el ID de un evento recurrente.

Asistente

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

Objeto Attendee
attendee.additionalGuests number
La cantidad de invitados adicionales del asistente habían indicado que están trayendo. El valor predeterminado 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
La dirección de correo electrónico del asistente.
attendee.optional boolean
true si la asistencia de este asistente está marcada como opcional; false de lo contrario.
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 equipo; false de lo contrario.
attendee.responseStatus string
El 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ó de forma provisoria la invitación al evento.
attendee.self boolean
true si este asistente representa el calendario en el que aparece el evento; De lo contrario, false.

Datos de conferencias

Los objetos de datos de conferencias contienen información sobre conferencias vinculadas a eventos del 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 del evento solo si los datos están presentes en el evento del Calendario y el complemento establece su campo addOns.calendar.currentEventAccess manifiesto en READ o READ_WRITE.

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

Punto de entrada

Los objetos de punto de entrada contienen información sobre los medios establecidos para acceder 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 del Calendario y el complemento establece su campo addOns.calendar.currentEventAccess manifiesto en READ o READ_WRITE.

Objeto de punto de entrada
entryPoint.accessCode string
El código de acceso que se usó para acceder a la conferencia. La longitud máxima es de 128 caracteres. Los proveedores de conferencias suelen solo puedes usar un subconjunto de {accessCode, meetingCode, passcode, password, pin} a brindan acceso a conferencias. Coincidir y mostrar solo los campos que utiliza el proveedor de conferencias.
entryPoint.entryPointFeatures list
Funciones del punto de entrada. Actualmente, estas funciones solo se aplican a los puntos de entrada phone:
  • toll: El punto de entrada es una llamada telefónica con cargo.
  • toll_free: El punto de entrada es una llamada telefónica sin cargo.
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 puede tener solo una more punto de entrada; si está presente, al menos, otro tipo de punto de entrada.
  • phone: Únete a la conferencia a través de un número de teléfono. Una conferencia puede tener cero o más puntos de entrada phone. El Calendario de Google solo muestra los dos primeros puntos de entrada telefónicos, después de formatear y ordenar alfabéticamente.
  • sip: Únete a la conferencia a través del SIP. Una conferencia puede tener como máximo un punto de entrada sip.
  • video: Únete a la conferencia a través de HTTP. R la conferencia puede tener como máximo un punto de entrada video.
entryPoint.label string
La etiqueta visible para el usuario correspondiente al URI del punto de entrada (no localizado).
entryPoint.meetingCode string
Es el código de reunión que se usa para acceder a la conferencia. La longitud máxima es de 128 caracteres. Los proveedores de conferencias suelen solo puedes usar un subconjunto de {accessCode, meetingCode, passcode, password, pin} a brindan acceso a conferencias. Haz coincidir y muestra solo los campos que usa el proveedor de conferencias.
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 muestra solo los campos que usa el proveedor de conferencias.
entryPoint.password string
La contraseña que se usa para acceder a la conferencia. La longitud máxima es de 128 caracteres. Los proveedores de conferencias suelen solo puedes usar un subconjunto de {accessCode, meetingCode, passcode, password, pin} a brindan acceso a conferencias. Haz coincidir y muestra solo los campos que usa el proveedor de conferencias.
entryPoint.pin string
El PIN 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. Coincidir y mostrar solo los campos que utiliza el proveedor de conferencias.
entryPoint.regionCode string
Código de región del número de teléfono. Los usuarios lo necesitan si el URI no incluye un código de país. Los valores se basan en el público Lista de CLDR de códigos regionales.
entryPoint.uri string
Es el URI del punto de entrada. La longitud máxima es de 1,300 caracteres. El formato depende del punto de entrada Tipo:
  • more: Se requiere un esquema http: o https:.
  • phone: Se requiere un esquema tel:. El El URI debe incluir la secuencia de marcado completa (por ejemplo, "tel:+12345678900,,,12345678;1234").
  • sip: Es un sip: o sips:. es obligatorio ingresar un esquema. Por ejemplo, "sip:12345678@miproveedor.com".
  • video: Es un http: o https:. es obligatorio ingresar un esquema.

Objeto de evento de Drive

El objeto del evento de Drive es la parte del objeto del evento general que contiene información sobre 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 en este momento.
drive.selectedItems[] list of Drive item objects
Es 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 de elemento de Drive
item.addonHasFileScopePermission boolean
Si es true, el complemento solicitó y recibió la autorización de permiso 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
La URL del ícono que representa el el elemento seleccionado.
item.mimeType string
Es el tipo MIME del elemento seleccionado.
item.title string
Es el título del elemento seleccionado.

Objeto de evento de Gmail

El objeto del evento de Gmail es la parte del objeto del evento general que contiene 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 GmailApp.setCurrentMessageAccessToken(accessToken) para otorgar a tu complemento acceso temporal a las aplicaciones abrir un mensaje de Gmail o permitir que tu complemento redacte nuevos borradores.
gmail.bccRecipients[] list of strings
Inhabilitado de forma predeterminada. La lista de "Cco:" direcciones de correo electrónico de los destinatarios incluidas actualmente en un borrador complemento está redactando. Para activar 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 "CC:" direcciones de correo electrónico de los destinatarios incluidas actualmente en un borrador complemento está redactando. Para activar este campo, debes configurar la addOns.gmail.composeTrigger.draftAccess en tu manifiesto para METADATA
gmail.messageId string
El ID del mensaje de Gmail abierto actualmente.
gmail.threadId string
El ID de conversación de Gmail actualmente abierto.
gmail.toRecipients[] list of strings
Está inhabilitado de forma predeterminada. La lista de "Para:" direcciones de correo electrónico de los destinatarios incluidas actualmente en un borrador complemento está redactando. Para activar este campo, debes configurar la addOns.gmail.composeTrigger.draftAccess en tu manifiesto para METADATA

Objeto de evento de Documentos

El objeto del evento de Documentos es la parte del objeto del evento general que contiene 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.
Es el ID del documento abierto en la IU de Documentos.
docs.title string
Solo está presente si se estableció el permiso https://www.googleapis.com/auth/drive.file autorizado por el usuario.
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.
docs.matchedUrl.url string
Solo está presente si se cumplen las siguientes condiciones:
  • El usuario autorizó https://www.googleapis.com/auth/workspace.linkpreview.
  • La URL coincide con el patrón de host especificado en el activador LinkPreviewTriggers.

Es la URL del vínculo que genera una vista previa en Documentos de Google. Para usar este campo, debes configurar LinkPreviewTriggers en el manifiesto de tu complemento. Consulta Vínculos de vista previa con chips inteligentes para obtener más detalles.

Ejemplo de carga útil para cuando un usuario obtiene una vista previa del vínculo https://www.example.com/12345:

"docs" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}
        

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 Hojas de cálculo de Google.

Objeto de evento de Hojas de cálculo
sheets.id string
Solo está presente si se estableció el permiso https://www.googleapis.com/auth/drive.file autorizadas por el usuario. El ID de la hoja de cálculo abierta en la IU de Hojas de cálculo.
sheets.title string
Solo está presente si se estableció el permiso https://www.googleapis.com/auth/drive.file autorizadas por el usuario. El título de la hoja de cálculo abierto en Hojas de cálculo de la IU de Google.
sheets.addonHasFileScopePermission boolean
Si es true, el complemento solicitó y recibió la autorización de permiso 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.
sheets.matchedUrl.url string
Solo está presente si se cumplen las siguientes condiciones:
  • El usuario autorizó https://www.googleapis.com/auth/workspace.linkpreview.
  • La URL coincide con el patrón de host especificado en el activador LinkPreviewTriggers.

Es la URL del vínculo que genera una vista previa en Hojas de cálculo de Google. Para usar este campo, debes configurar el LinkPreviewTriggers en el manifiesto de tu complemento. Consulta Obtén una vista previa de vínculos con chips inteligentes para obtener más detalles.

Ejemplo de carga útil para cuando un usuario obtiene una vista previa del vínculo https://www.example.com/12345:

"sheets" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}
        

Objeto de evento de Presentaciones

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

Objeto de evento de diapositivas
slides.id string
Solo está presente si el usuario autorizó el permiso https://www.googleapis.com/auth/drive.file. El ID de la presentación abierta en Presentaciones de la IU de Google.
slides.title string
Solo está presente si se estableció el permiso https://www.googleapis.com/auth/drive.file autorizadas por el usuario. El título de la presentación abierto en IU de Presentaciones
slides.addonHasFileScopePermission boolean
Si es true, el complemento solicitó. y recibió https://www.googleapis.com/auth/drive.file la autorización de alcance para la presentación abierta en la IU de Presentaciones de lo contrario este campo es false.
slides.matchedUrl.url string
Solo está presente si se cumplen las siguientes condiciones:
  • El usuario autorizó https://www.googleapis.com/auth/workspace.linkpreview.
  • La URL coincide con el patrón de host especificado en el activador LinkPreviewTriggers.

Es la URL del vínculo que genera una vista previa en Presentaciones de Google. Para usar este campo, debes configurar el LinkPreviewTriggers en el manifiesto de tu complemento. Consulta Obtén una vista previa de vínculos con chips inteligentes para obtener más detalles.

Ejemplo de carga útil para cuando un usuario obtiene una vista previa del vínculo https://www.example.com/12345:

"slides" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}