Objetos de evento

Esta página descreve a estrutura dos objetos de evento dos complementos do Google Workspace.

Objetos de evento são estruturas JSON construídas e transmitidas automaticamente como parâmetros para acionar ou retornar funções quando um usuário interage com um complemento. Os objetos de evento transmitem informações do lado do cliente sobre o app host e o contexto atual para a função de callback do lado do servidor do complemento.

Os complementos do Google Workspace usam objetos de evento nos seguintes lugares:

  • Acionadores da página inicial. Cada função homepageTrigger definida recebe automaticamente um objeto de evento quando a função de gatilho da página inicial é disparada. Você pode usar esse objeto na função de acionamento da página inicial para identificar o app host ativo, a plataforma do cliente, a localidade do usuário e outras informações.

    Os objetos de evento criados quando os gatilhos da página inicial são acionados não contêm todos os campos incluídos nos outros dois casos. Os campos relacionados a widgets e informações contextuais são omitidos.

  • Acionadores contextuais. Cada aplicativo host fornece um conjunto diferente de acionadores contextuais que são ativados quando o usuário entra em um contexto específico. Exemplo:

    Quando um gatilho contextual é acionado, o aplicativo host chama o runFunction correspondente listado no manifesto do complemento, transmitindo um objeto de evento como um parâmetro. Os objetos de evento criados quando os acionadores contextuais são disparados contêm todos os campos incluídos nos objetos de evento de acionador da página inicial, além de campos com informações contextuais.

  • Ações do widget. Os objetos de evento também são usados para fornecer interatividade de widget, usando o mesmo modelo de ação que os complementos do Gmail usam. Os complementos do Google Workspace usam todas as mesmas funções de manipulador de widgets, objetos Action e respostas de ação. No entanto, nos complementos do Google Workspace, os objetos de evento de ação incluem ainda mais informações que uma função de callback pode usar.

    Os objetos de evento criados como resultado das ações do widget contêm todos os campos incluídos nos objetos de evento de acionamento contextual, além de campos com informações do widget.

  • Acionadores de link de visualização. Nos apps Documentos, Planilhas e Apresentações Google, é possível configurar visualizações de links para serviços de terceiros com base em padrões de URL específicos. Quando os usuários interagem com um link que atende ao padrão, o linkPreviewTriggers é disparado, e um objeto de evento que contém o link é transmitido para a função de callback do gatilho. Seu complemento pode usar esse objeto de evento para criar um ícone inteligente e um card que mostram informações sobre o link no aplicativo host. Você também pode criar ações de widget para permitir que os usuários interajam com o card de prévia e o conteúdo dele.

  • Gatilhos do app Google Chat. No Google Chat, seu complemento aparece para os usuários como um app do Chat, e eles podem interagir com ele adicionando a espaços, enviando mensagens, usando comandos de barra e muito mais. Para criar recursos interativos, configure e use vários gatilhos do app Chat. Cada gatilho envia um payload de objeto de evento diferente que ajuda você a processar ou responder a cada tipo de interação.

Estrutura do objeto de evento

A tabela a seguir descreve a estrutura de nível superior dos objetos de evento de complementos do Google Workspace. A estrutura do objeto de evento inclui um campo de nível superior commonEventObject para informações independentes do host. Cada objeto de evento também pode ter um dos seguintes campos de nível superior específicos do host, determinados pelo app host ativo: gmailEventObject, calendarEventObject ou driveEventObject.

Para compatibilidade com versões anteriores, os objetos de evento dos complementos do Google Workspace também incluem todos os campos originais usados nos objetos de evento de ação do complemento do Gmail. Esses campos estão listados na tabela abaixo em "Campos originais do complemento do Gmail". As informações nesses campos são reproduzidas na nova estrutura de objeto.

Objeto de evento
eventObject.commonEventObject Common fields object
Um objeto que contém informações comuns a todos os objetos de evento, independente do aplicativo host.
eventObject.calendar Calendar event object
Presente somente se o host de chamada for o Google Agenda. Um objeto que contém informações da agenda e de eventos.
eventObject.chat Chat event object
Presente somente se o host de chamada for o Google Chat. Um objeto que contém informações do Chat.
eventObject.drive Drive event object
Presente somente se o host de chamada for o Google Drive. Um objeto que contém informações do Drive.
eventObject.gmail Gmail event object
Presente apenas se o host de chamada for o Gmail. Um objeto que contém informações do Gmail.
eventObject.docs Docs event object
Presente somente se o host de chamada for o Documentos Google. Um objeto que contém informações do Google Docs.
eventObject.sheets Sheets event object
Presente somente se o host de chamada for o Google Sheets. Um objeto que contém informações do Planilhas.
eventObject.slides Slides event object
Presente somente se o host de chamada for o Google Apresentações. Um objeto que contém informações do Apresentações.
Campos originais do complemento do Gmail
eventObject.messageMetadata.accessToken string
Descontinuado. Um token de acesso. Você pode usar isso para ativar o acesso aos dados do usuário usando escopos temporários de complementos do Gmail.

Para complementos do Google Workspace, encontre essas informações no campo eventObject.gmail.accessToken.

eventObject.messageMetadata.messageId string
Descontinuado. O ID da mensagem da conversa aberta na interface do Gmail.

Para complementos do Google Workspace, encontre essas informações no campo eventObject.gmail.messageId.

eventObject.clientPlatform string
Descontinuado. Indica a origem do evento (Web, iOS ou Android).

Para complementos do Google Workspace, encontre essas informações no campo eventObject.commonEventObject.platform.

eventObject.formInput object
Descontinuado. Um mapa dos valores atuais de todos os widgets de formulário no card, restrito a um valor por widget. As chaves são os IDs de string associados aos widgets, e os valores são strings. O objeto de evento fornece formInput como uma conveniência para quando você precisa ler dados de vários widgets com valores únicos esperados, como entradas de texto e chaves. Para widgets de vários valores, como caixas de seleção, leia cada valor de formInputs.

Para complementos do Google Workspace, encontre essas informações no campo eventObject.commonEventObject.formInputs. Os widgets com valores únicos são representados como matrizes com um único elemento.

eventObject.formInputs object
Descontinuado. Um mapa dos valores atuais dos widgets no card, apresentado como listas de strings. As chaves são os IDs de string associados ao widget. Para widgets de valor único, o valor é apresentado em uma matriz de elemento único. Para widgets com vários valores, como grupos de caixas de seleção, todos os valores são apresentados em uma lista.

Para complementos do Google Workspace, encontre essas informações no campo eventObject.commonEventObject.formInputs.

eventObject.parameters object
Descontinuado. Um mapa de parâmetros adicionais que você fornece ao Action usando Action.setParameters(). As chaves e os valores do mapa são strings.

Para complementos do Google Workspace, encontre essas informações no campo eventObject.commonEventObject.parameters.

eventObject.userCountry string
Descontinuado e desativado por padrão. O código de duas letras que indica o país ou a região do usuário. Ele também pode ser um código numérico UN M49 do país.

Para complementos do Google Workspace, encontre essas informações no campo eventObject.commonEventObject.userLocale.

eventObject.userLocale string
Descontinuado e desativado por padrão. O código de duas letras ISO 639 que indica o idioma do usuário. Consulte Como acessar a localidade e o fuso horário do usuário para mais detalhes.

Para complementos do Google Workspace, encontre essas informações no campo eventObject.commonEventObject.userLocale.

eventObject.userTimezone.id string
Descontinuado e desativado por padrão. O identificador de fuso horário do fuso horário do usuário. Por exemplo: America/New_York, Europe/Vienna e Asia/Seoul. Consulte Como acessar a localidade e o fuso horário do usuário para mais detalhes.

Para complementos do Google Workspace, encontre essas informações no campo eventObject.commonEventObject.timeZone.id.

eventObject.userTimezone.offset string
Descontinuado e desativado por padrão. O deslocamento de tempo do Tempo Universal Coordenado (UTC) do fuso horário do usuário, medido em milissegundos. Consulte Como acessar a localidade e o fuso horário do usuário para mais detalhes.

Para complementos do Google Workspace, encontre essas informações no campo eventObject.commonEventObject.timeZone.offset.

Objeto de evento comum

O objeto de evento comum é a parte do objeto de evento geral que carrega informações gerais e independentes do host para o complemento do cliente do usuário. Essas informações incluem detalhes como a localidade, o app host e a plataforma do usuário.

Além da página inicial e dos gatilhos contextuais, os complementos criam e transmitem objetos de evento para funções de callback de ação quando o usuário interage com widgets. A função de callback do complemento pode consultar o objeto de evento comum para determinar o conteúdo dos widgets abertos no cliente do usuário. Por exemplo, o complemento pode localizar o texto que um usuário inseriu em um widget TextInput no objeto eventObject.commentEventObject.formInputs.

Campos comuns de objetos de evento
commonEventObject.platform string
Indica a origem do evento (`WEB`, `IOS` ou `ANDROID`).
commonEventObject.formInputs object
Um mapa que contém os valores atuais dos widgets no card exibido. As chaves do mapa são os IDs de string atribuídos a cada widget.

A estrutura do objeto de valor do mapa depende do tipo de widget:

  • Widgets de valor único (por exemplo, uma caixa de texto): uma lista de strings (apenas um elemento).

    Exemplo: para um widget de entrada de texto com employeeName como ID, acesse o valor de entrada de texto com: e.commonEventObject.formInputs.employeeName.stringInputs.value[0]

  • Widgets de vários valores (por exemplo, grupos de caixas de seleção): uma lista de strings.

    Exemplo: para um widget de vários valores com participants como ID, acesse a matriz de valores com: e.commonEventObject.formInputs.participants.stringInputs.value.

  • A date-time picker: um DateTimeInput object.

    Exemplo: para um seletor com um ID de myDTPicker, acesse o objeto DateTimeInput usando e.commonEventObject.formInputs.myDTPicker.dateTimeInput.

  • A date-only picker: um DateInput object.

    Exemplo: para um seletor com um ID de myDatePicker, acesse o objeto DateInput usando e.commonEventObject.formInputs.myDatePicker.dateInput.

  • A time-only picker: um TimeInput object.

    Exemplo: para um seletor com um ID de myTimePicker, acesse o objeto TimeInput usando e.commonEventObject.formInputs.myTimePicker.timeInput.
commonEventObject.hostApp string
Indica o app host em que o complemento está ativo quando o objeto de evento é gerado. Os valores possíveis incluem:
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
Qualquer parâmetro adicional que você fornecer a uma ação usando actionParameters ou Action.setParameters().

Prévia para desenvolvedores : para complementos que estendem o Google Chat, use o valor da chave "autocomplete_widget_query" (event.commonEventObject.parameters["autocomplete_widget_query"]) para sugerir itens com base no que os usuários digitam nos menus de seleção múltipla. É possível usar esse valor para consultar um banco de dados e sugerir itens selecionáveis aos usuários enquanto eles digitam. Para mais detalhes, consulte Coletar e processar informações de usuários do Google Chat.
commonEventObject.userLocale string
Desativado por padrão. O idioma do usuário e o identificador de país/região no formato de código de idioma ISO 639-código de país/região ISO 3166. Por exemplo, en-US.

Para ativar esse campo, defina addOns.common.useLocaleFromApp como true no manifesto do complemento. A lista de escopos do complemento também precisa incluir https://www.googleapis.com/auth/script.locale. Consulte Como acessar a localidade e o fuso horário do usuário para mais detalhes.

commonEventObject.timeZone string
Desativado por padrão. O ID e o ajuste do fuso horário. Para ativar esse campo, defina addOns.common.useLocaleFromApp como true no manifesto do complemento. A lista de escopos do complemento também precisa incluir https://www.googleapis.com/auth/script.locale. Consulte Como acessar a localidade e o fuso horário do usuário para mais detalhes.
commonEventObject.timeZone.id string
O identificador de fuso horário do fuso horário do usuário. Por exemplo: America/New_York, Europe/Vienna e Asia/Seoul. Para ativar esse campo, defina addOns.common.useLocaleFromApp como true no manifesto do complemento. A lista de escopos do complemento também precisa incluir https://www.googleapis.com/auth/script.locale. Consulte Como acessar a localidade e o fuso horário do usuário para mais detalhes.
commonEventObject.timeZone.offset string
O deslocamento de tempo do Tempo Universal Coordenado (UTC) do fuso horário do usuário, medido em milissegundos. Consulte Como acessar a localidade e o fuso horário do usuário para mais detalhes.

Entradas de formulário do seletor de data e hora

As funções de callback de ação podem receber os valores atuais do widget no campo commonEventObject.formInputs. Isso inclui os valores de data ou hora selecionados pelo usuário em widgets de seleção de data ou hora. No entanto, a estrutura das informações varia dependendo de se o widget foi configurado como um seletor de data e hora, um seletor somente de data ou um seletor somente de hora. As diferenças estruturais estão descritas na tabela a seguir:

Objeto DateTimeInput
dateTimeInput.hasDate boolean
true se a data e hora de entrada incluírem uma data; se false, apenas uma hora será incluída.
dateTimeInput.hasTime boolean
true se a data e hora de entrada incluir um horário; se false, apenas uma data será incluída.
dateTimeInput.msSinceEpoch string
O horário selecionado pelo usuário, em milissegundos desde a época (00:00:00 UTC em 1º de janeiro de 1970).
Objeto DateInput
dateInput.msSinceEpoch string
O horário selecionado pelo usuário, em milissegundos desde a época (00:00:00 UTC em 1º de janeiro de 1970).
Objeto TimeInput
timeInput.hours number
O número da hora selecionada pelo usuário.
timeInput.minutes number
O número do minuto selecionado pelo usuário.

Objeto de evento do chat

O objeto de evento do Chat é a parte do objeto de evento geral que carrega informações sobre as interações de um usuário com um app do Chat. Ele só está presente em um objeto de evento se o complemento estender o Google Chat.

Chat
chat.user object (User)
O usuário do Chat que interagiu com o app Chat.
chat.space object (Space)
O espaço do Chat em que um usuário interagiu com o app Chat.
chat.eventTime

string (Timestamp format)

O horário em que a interação ocorreu.

Campo de união payload.

payload pode ser apenas de um dos tipos a seguir:
chat.messagePayload

object (MessagePayload)

O payload que os apps do Chat recebem de um gatilho de Mensagem.
chat.addedToSpacePayload

object (AddedToSpacePayload)

O payload que os apps do Chat recebem de um gatilho Adicionado ao espaço.
chat.removedFromSpacePayload

object (RemovedFromSpacePayload)

O payload que os apps do Chat recebem de um gatilho Removido do espaço.
chat.buttonClickedPayload

object (ButtonClickedPayload)

O payload que os apps do Chat recebem quando os usuários clicam em um botão de uma mensagem ou card. Se um usuário clicar em um botão para enviar informações, o objeto commonEventObject.formInputs vai conter os valores coletados do usuário. Para mais detalhes, consulte Coletar informações de usuários do Google Chat.
chat.widgetUpdatedPayload

object (WidgetUpdatedPayload)

O payload que os apps do Chat recebem quando os usuários digitam texto no menu de multisseleção de um widget selectionInput. Os apps de chat podem usar esse objeto de evento para preencher itens sugeridos de uma fonte de dados dinâmica. Por exemplo, para preencher casos de suporte de uma fonte de dados externa, um app de chat pode consultar a fonte de dados com base no que o usuário digita no menu e retornar todos os casos de suporte correspondentes como itens selecionáveis.

O objeto CommonEventObject.parameters['autocomplete_widget_query'] contém o valor da string que o usuário digita no menu.

chat.appCommandPayload

object (AppCommandPayload)

A carga útil que os apps do Chat recebem quando um usuário usa um comando do app.

Payload

Dependendo do tipo de interação do app do Chat, o evento contém um payload com um ou mais recursos da API Chat.

Payload da mensagem
MessagePayload
chat.messagePayload.message object (Message)
A mensagem do Google Chat que acionou o evento.
chat.messagePayload.space object (Space)
O espaço do Chat em que um usuário enviou a mensagem que invocou o app Chat.
chat.messagePayload.configCompleteRedirectUri string
O URL para onde o app Chat deve redirecionar o usuário depois que ele concluir um fluxo de autorização ou configuração fora do Google Chat. Para mais informações, consulte Conectar o complemento do Google Workspace a um serviço de terceiros.

Adicionado ao payload do espaço
AddedToSpacePayload
chat.addedToSpacePayload.space object (Space)
O espaço do Chat em que o usuário adicionou ou instalou o app Chat.

Quando os administradores instalam apps do Chat, o campo space.adminInstalled é definido como true.

chat.addedToSpacePayload.interactionAdd boolean
Se um usuário adiciona o app Chat a um espaço usando uma mensagem. Por exemplo, @mencionar o app Chat ou usar um comando. Se true, o Chat enviará outro objeto de evento com um messagePayload que contém informações sobre a mensagem.
chat.addedToSpacePayload.configCompleteRedirectUri string
O URL para onde o app Chat deve redirecionar o usuário depois que ele concluir um fluxo de autorização ou configuração fora do Google Chat. Para mais informações, consulte Conectar o complemento do Google Workspace a um serviço de terceiros.

Removido da carga útil do espaço
RemovedFromSpacePayload
chat.removedFromSpacePayload.space object (Space)
O espaço do Chat de que o usuário removeu ou desinstalou o app Chat.

Quando os administradores desinstalam apps do Chat, o campo space.adminInstalled é definido como false.

Payload de clique no botão
ButtonClickedPayload
chat.buttonClickedPayload.message object (Message)
A mensagem do chat que contém o botão em que um usuário clicou.
chat.buttonClickedPayload.space object (Space)
O espaço do Chat em que o usuário clicou em um botão de uma mensagem do app Chat.
chat.buttonClickedPayload.isDialogEvent boolean
Indica se o usuário clicou no botão para interagir com uma caixa de diálogo.
chat.buttonClickedPayload.dialogEventType enum (DialogEventType)
Se isDialogEvent for true, o tipo de interação em uma caixa de diálogo.

Enum DialogEventType.

O valor de dialogEventType pode ser apenas um dos seguintes:
TYPE_UNSPECIFIED Valor padrão. Não especificado.
REQUEST_DIALOG Um usuário solicita uma caixa de diálogo. Por exemplo, eles usam um comando ou clicam em um botão de uma mensagem.
SUBMIT_DIALOG Um usuário clica em um elemento interativo em uma caixa de diálogo. Por exemplo, um usuário preenche informações em uma caixa de diálogo e clica em um botão para enviar os dados.

Payload de widget atualizado
WidgetUpdatedPayload
chat.widgetUpdatedPayload.space object (Space)
O espaço do Chat em que a interação ocorreu.

Payload do comando de app
AppCommandPayload
chat.appCommandPayload.appCommandMetadata object (AppCommandMetadata)
Metadados sobre qual comando o usuário usou e como ele acionou o comando.
chat.appCommandPayload.space object (Space)
O espaço do Chat em que um usuário usou o comando.
chat.appCommandPayload.thread object (Thread)
Se a interação ocorreu em uma conversa, a conversa do Chat em que o usuário usou o comando.
chat.appCommandPayload.message object (Message)
Para comandos de barra, a mensagem que contém o comando.
chat.appCommandPayload.configCompleteRedirectUri string
Se for necessária autorização ou configuração para o comando, um URL para redirecionar o usuário depois que ele concluir o processo fora do Google Chat.
chat.appCommandPayload.isDialogEvent boolean
Indica se o comando abre uma caixa de diálogo.
chat.appCommandPayload.dialogEventType enum (DialogEventType)
O tipo de interação com uma caixa de diálogo.

Enum DialogEventType.

O valor de dialogEventType pode ser apenas um dos seguintes:
TYPE_UNSPECIFIED Valor padrão. Não especificado.
REQUEST_DIALOG Um usuário solicita uma caixa de diálogo. Por exemplo, eles usam um comando ou clicam em um botão de uma mensagem.
SUBMIT_DIALOG Um usuário clica em um elemento interativo em uma caixa de diálogo. Por exemplo, um usuário preenche informações em uma caixa de diálogo e clica em um botão para enviar os dados.
Metadados de comando de app
AppCommandMetadata
chat.appCommandPayload.appCommandMetadata.appCommandId

string (int64 format)

O ID do comando.
chat.appCommandPayload.appCommandMetadata.appCommandType enum (AppCommandType)
O tipo de comando.

Enum AppCommandType.

O valor de AppCommandType pode ser apenas um dos seguintes:
APP_COMMAND_TYPE_UNSPECIFIED Valor padrão. Não especificado.
SLASH_COMMAND Um usuário usa o comando enviando uma mensagem que começa com uma barra /.
QUICK_COMMAND O usuário seleciona o comando no menu do Chat na área de resposta da mensagem.

Objeto de evento da Agenda

O objeto de evento da Agenda é a parte do objeto de evento geral que contém informações sobre a agenda e os eventos da agenda de um usuário. Ele só está presente em um objeto de evento se o complemento estender o Google Agenda.

A tabela a seguir lista os campos presentes no campo calendarEventObject de um objeto de evento. Os campos marcados como Dados gerados pelo usuário estão presentes no objeto de evento somente se os dados estiverem presentes no evento da Agenda e se o complemento definir o campo addOns.calendar.currentEventAccess manifest como READ ou READ_WRITE.

Objeto de evento da Agenda
calendar.attendees[] list of attendee objects
Dados gerados pelo usuário. Uma lista dos participantes do evento da agenda.
calendar.calendarId string
O ID da agenda.
calendar.capabilities object
Dados gerados pelo usuário. Um objeto que descreve os recursos do complemento para visualizar ou atualizar informações de eventos.
calendar.capabilities.canAddAttendees boolean
Dados gerados pelo usuário. true se o complemento puder adicionar novos participantes à lista de participantes do evento; false caso contrário.
calendar.capabilities.canSeeAttendees boolean
Dados gerados pelo usuário. true se o complemento puder ler a lista de participantes do evento; false caso contrário.
calendar.capabilities.canSeeConferenceData boolean
Dados gerados pelo usuário. true se o complemento puder ler os dados de conferência do evento; false caso contrário.
calendar.capabilities.canSetConferenceData boolean
Dados gerados pelo usuário. true se o complemento puder atualizar os dados de conferência do evento; false caso contrário.
calendar.capabilities.canAddAttachments boolean
Dados gerados pelo usuário. true se o complemento puder adicionar novos anexos ao evento; false caso contrário.
calendar.conferenceData Conference data object
Dados gerados pelo usuário. Um objeto que representa todos os dados de conferência associados a esse evento, como detalhes da conferência do Google Meet.
calendar.id string
O ID do evento.
calendar.organizer object
Um objeto que representa o organizador do evento.
calendar.organizer.email string
O endereço de e-mail do organizador do evento.
calendar.recurringEventId string
O ID de um evento recorrente.

Participante

Os objetos de participante contêm informações sobre participantes individuais de eventos do Google Agenda. Essas informações estão presentes no objeto de evento somente se os dados estiverem presentes no evento da Agenda e o complemento definir o campo manifest addOns.calendar.currentEventAccess como READ ou READ_WRITE.

Objeto de participante
attendee.additionalGuests number
O número de convidados extras que o participante indicou que vai levar. Assume zero como padrão.
attendee.comment string
O comentário de resposta do participante, se houver.
attendee.displayName string
O nome de exibição do participante.
attendee.email string
O endereço de e-mail do participante.
attendee.optional boolean
true se a participação deste participante estiver marcada como opcional; false caso contrário.
attendee.organizer boolean
true se o participante for um organizador do evento.
attendee.resource boolean
true se o participante representar um recurso, como uma sala ou um equipamento; false caso contrário.
attendee.responseStatus string
O status da resposta do participante. Os valores possíveis incluem:
  • accepted: o participante aceitou o convite para o evento.
  • declined: o participante recusou o convite para o evento.
  • needsAction: o participante não respondeu ao convite para o evento.
  • tentative: o participante aceitou provisoriamente o convite para o evento.
attendee.self boolean
true se o participante representar a agenda em que o evento aparece. Caso contrário, false.

Dados da conferência

Os objetos de dados de conferência contêm informações sobre as conferências anexadas a eventos do Google Agenda. Podem ser soluções de conferência do Google, como o Google Meet, ou de terceiros. Essas informações estão presentes no objeto de evento somente se os dados estiverem no evento da Agenda e o complemento definir o campo manifesto addOns.calendar.currentEventAccess como READ ou READ_WRITE.

Objeto de dados de conferência
conferenceData.conferenceId string
O ID da conferência. Ele permite que os aplicativos acompanhem as conferências, mas não deve ser mostrado aos usuários.
conferenceData.conferenceSolution object
Um objeto que representa a solução de conferência, como o Hangouts ou o Google Meet.
conferenceData.conferenceSolution.iconUri string
O URI do ícone visível ao usuário que representa essa solução de conferência.
conferenceData.conferenceSolution.key object
A chave que identifica de forma exclusiva a solução de conferência para este evento.
conferenceData.conferenceSolution.key.type string
O tipo de solução de conferência. Os valores possíveis incluem:
  • eventHangout para o Hangouts para consumidores (http://hangouts.google.com).
  • eventNamedHangout para o Hangouts clássico para usuários do Google Workspace (http://hangouts.google.com).
  • hangoutsMeet para o Google Meet (http://meet.google.com).
conferenceData.conferenceSolution.name string
O nome visível para o usuário desta solução de conferência (não localizada).
conferenceData.entryPoints[] list of entry point objects
A lista de pontos de entrada da conferência, como URLs ou números de telefone.
conferenceData.notes string
Outras observações (como instruções do administrador do domínio ou avisos legais) sobre a conferência para mostrar ao usuário. Pode conter HTML. O tamanho máximo é de 2.048 caracteres.
conferenceData.parameters object
Um objeto que contém um mapa de dados de parâmetros definidos para uso pelo complemento.
conferenceData.parameters.addOnParameters object
Um mapa de chaves e valores de string de parâmetro. Essas chaves e valores são definidos pelo desenvolvedor do complemento para anexar informações a uma conferência específica para uso do complemento.

Ponto de entrada

Os objetos de ponto de entrada carregam informações sobre os meios estabelecidos de acesso a uma determinada conferência, como por telefone ou vídeo. Essas informações estão presentes no objeto de evento somente se os dados estiverem no evento da Agenda e se o complemento definir o campo manifest addOns.calendar.currentEventAccess como READ ou READ_WRITE.

Objeto de ponto de entrada
entryPoint.accessCode string
O código de acesso usado para entrar na conferência. O tamanho máximo é de 128 caracteres. Os provedores de conferências geralmente usam apenas um subconjunto de {accessCode, meetingCode, passcode, password, pin} para dar acesso às conferências. Corresponda e mostre apenas os campos usados pelo provedor de conferências.
entryPoint.entryPointFeatures list
Recursos do ponto de entrada. No momento, esses recursos se aplicam apenas aos pontos de entrada phone:
  • toll: o ponto de entrada é uma ligação telefônica paga.
  • toll_free: o ponto de entrada é uma ligação telefônica sem custo financeiro.
entryPoint.entryPointType string
O tipo de ponto de entrada. Os valores possíveis são:
  • more: instruções adicionais para entrar na conferência, como números de telefone alternativos. Uma conferência só pode ter um ponto de entrada more. Se ele estiver presente, pelo menos outro tipo de ponto de entrada também será necessário.
  • phone: participe da conferência por um número de telefone. Uma conferência pode ter zero ou mais pontos de entrada phone. O Google Agenda mostra apenas os dois primeiros pontos de entrada de telefone, depois de formatados e classificados em ordem alfabética.
  • sip: participe da conferência por SIP. Uma conferência pode ter no máximo um ponto de entrada sip.
  • video: entre na conferência por HTTP. Uma conferência pode ter no máximo um ponto de entrada video.
entryPoint.label string
O rótulo visível ao usuário para o URI do ponto de entrada (não localizado).
entryPoint.meetingCode string
O código da reunião usado para acessar a conferência. O tamanho máximo é de 128 caracteres. Os provedores de conferências geralmente usam apenas um subconjunto de {accessCode, meetingCode, passcode, password, pin} para dar acesso às conferências. Corresponda e mostre apenas os campos usados pelo provedor de conferências.
entryPoint.passcode string
A senha usada para acessar a conferência. O tamanho máximo é de 128 caracteres. Os provedores de conferências geralmente usam apenas um subconjunto de {accessCode, meetingCode, passcode, password, pin} para dar acesso às conferências. Corresponda e mostre apenas os campos usados pelo provedor de conferências.
entryPoint.password string
A senha usada para acessar a conferência. O tamanho máximo é de 128 caracteres. Os provedores de conferências geralmente usam apenas um subconjunto de {accessCode, meetingCode, passcode, password, pin} para dar acesso às conferências. Corresponda e mostre apenas os campos usados pelo provedor de conferências.
entryPoint.pin string
O PIN usado para acessar a conferência. O tamanho máximo é de 128 caracteres. Os provedores de conferências geralmente usam apenas um subconjunto de {accessCode, meetingCode, passcode, password, pin} para dar acesso às conferências. Corresponda e mostre apenas os campos usados pelo provedor de conferências.
entryPoint.regionCode string
Código da região do número de telefone. Necessário para usuários se o URI não incluir um código do país. Os valores são baseados na lista pública de códigos de região do CLDR.
entryPoint.uri string
O URI do ponto de entrada. O tamanho máximo é de 1.300 caracteres. A formatação depende do tipo de ponto de entrada:
  • more: é necessário um esquema http: ou https:.
  • phone: um esquema tel: é obrigatório. O URI precisa incluir toda a sequência de discagem (por exemplo, "tel:+12345678900,,,12345678;1234").
  • sip: é necessário um esquema sip: ou sips:. Por exemplo, "sip:12345678@myprovider.com".
  • video: é necessário um esquema http: ou https:.

Objeto de evento do Drive

O objeto de evento do Drive é a parte do objeto de evento geral que contém informações sobre o Google Drive de um usuário e o conteúdo dele. Ele só está presente em um objeto de evento se o complemento estender o Google Drive.

Objeto de evento do Drive
drive.activeCursorItem Drive item object
O item do Drive ativo no momento.
drive.selectedItems[] list of Drive item objects
Uma lista de itens (arquivos ou pastas) selecionados no Drive.

Item do Drive

Os objetos de itens do Drive contêm informações sobre itens específicos do Drive, como arquivos ou pastas.

Objeto do item do Drive
item.addonHasFileScopePermission boolean
Se true, o complemento solicitou e recebeu autorização de escopo https://www.googleapis.com/auth/drive.file para este item. Caso contrário, este campo será false.
item.id string
O ID do item selecionado.
item.iconUrl string
O URL do ícone que representa o item selecionado.
item.mimeType string
O tipo MIME do item selecionado.
item.title string
O título do item selecionado.

Objeto de evento do Gmail

O objeto de evento do Gmail é a parte do objeto de evento geral que carrega informações sobre as mensagens do Gmail de um usuário. Ele só está presente em um objeto de evento se o aplicativo host for o Gmail.

Objeto de evento do Gmail
gmail.accessToken string
O token de acesso específico do Gmail. Você pode usar esse token com o método GmailApp.setCurrentMessageAccessToken(accessToken) para conceder ao complemento acesso temporário a uma mensagem do Gmail aberta ou permitir que ele crie novos rascunhos.
gmail.bccRecipients[] list of strings
Desativado por padrão. A lista de endereços de e-mail de destinatários "CCO:" atualmente incluídos em um rascunho que o complemento está criando. Para ativar esse campo, defina o campo addOns.gmail.composeTrigger.draftAccess no manifesto como METADATA.
gmail.ccRecipients[] list of strings
Desativado por padrão. A lista de endereços de e-mail dos destinatários "Cc:" incluídos em um rascunho que o complemento está criando. Para ativar esse campo, defina o campo addOns.gmail.composeTrigger.draftAccess no manifesto como METADATA.
gmail.messageId string
O ID da mensagem do Gmail aberta no momento.
gmail.threadId string
O ID da conversa do Gmail aberta no momento.
gmail.toRecipients[] list of strings
Desativado por padrão. A lista de endereços de e-mail dos destinatários "Para:" incluídos em um rascunho que o complemento está criando. Para ativar esse campo, defina o campo addOns.gmail.composeTrigger.draftAccess no manifesto como METADATA.

Objeto de evento do app Documentos

O objeto de evento do Google Docs é a parte do objeto de evento geral que carrega informações sobre um documento do usuário e o conteúdo dele. Ele só está presente em um objeto de evento se o complemento estender os Documentos Google.

Objeto de evento do app Documentos
docs.id string
Presente apenas se o escopo https://www.googleapis.com/auth/drive.file tiver sido autorizado pelo usuário.
O ID do documento aberto na interface do usuário do app Documentos.
docs.title string
Presente somente se o escopo https://www.googleapis.com/auth/drive.file tiver sido autorizado pelo usuário.
O título do documento aberto na interface do usuário do app Documentos.
docs.addonHasFileScopePermission boolean
Se true, o complemento solicitou e recebeu autorização de escopo https://www.googleapis.com/auth/drive.file para o documento aberto na interface dos Documentos. Caso contrário, esse campo será false.
docs.matchedUrl.url string
Presente apenas se as condições a seguir forem atendidas:
  • O usuário autorizou o https://www.googleapis.com/auth/workspace.linkpreview.
  • O URL corresponde ao padrão de host especificado no acionador LinkPreviewTriggers.

O URL do link que gera uma prévia nos Documentos Google. Para usar esse campo, configure o LinkPreviewTriggers no manifesto do complemento. Consulte Prévia de links com ícones inteligentes para mais detalhes.

Exemplo de payload quando um usuário visualiza o link https://www.example.com/12345: 

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

Objeto de evento das Planilhas

O objeto de evento do Google Sheets é a parte do objeto de evento geral que carrega informações sobre um documento do usuário e o conteúdo dele. Ele só está presente em um objeto de evento se o complemento estender o Google Sheets.

Objeto de evento das Planilhas
sheets.id string
Só estará presente se o escopo https://www.googleapis.com/auth/drive.file tiver sido autorizado pelo usuário. O ID da planilha aberta na interface do usuário das Planilhas.
sheets.title string
Só estará presente se o escopo https://www.googleapis.com/auth/drive.file tiver sido autorizado pelo usuário. O título da planilha aberta na interface do usuário do app Planilhas.
sheets.addonHasFileScopePermission boolean
Se true, o complemento solicitou e recebeu autorização de escopo https://www.googleapis.com/auth/drive.file para a planilha aberta na interface do Planilhas. Caso contrário, esse campo será false.
sheets.matchedUrl.url string
Presente apenas se as condições a seguir forem atendidas:
  • O usuário autorizou o https://www.googleapis.com/auth/workspace.linkpreview.
  • O URL corresponde ao padrão de host especificado no acionador LinkPreviewTriggers.

O URL do link que gera uma prévia nas Planilhas Google. Para usar esse campo, configure o LinkPreviewTriggers no manifesto do complemento. Consulte Prévia de links com ícones inteligentes para mais detalhes.

Exemplo de payload quando um usuário visualiza o link https://www.example.com/12345:

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

Objeto de evento das Apresentações

O objeto de evento do Apresentações é a parte do objeto de evento geral que carrega informações sobre o documento de um usuário e o conteúdo dele. Ele só está presente em um objeto de evento se o complemento estender o Apresentações Google.

Objeto de evento das Apresentações
slides.id string
Só estará presente se o escopo https://www.googleapis.com/auth/drive.file tiver sido autorizado pelo usuário. O ID da apresentação aberta na interface do usuário das Apresentações Google.
slides.title string
Só estará presente se o escopo https://www.googleapis.com/auth/drive.file tiver sido autorizado pelo usuário. O título da apresentação aberta na interface das Apresentações Google.
slides.addonHasFileScopePermission boolean
Se true, o complemento solicitou e recebeu autorização de escopo https://www.googleapis.com/auth/drive.file para a apresentação aberta na interface do usuário do Apresentações; caso contrário, este campo será false.
slides.matchedUrl.url string
Presente apenas se as condições a seguir forem atendidas:
  • O usuário autorizou o https://www.googleapis.com/auth/workspace.linkpreview.
  • O URL corresponde ao padrão de host especificado no acionador LinkPreviewTriggers.

O URL do link que gera uma prévia no Apresentações Google. Para usar esse campo, configure o LinkPreviewTriggers no manifesto do complemento. Consulte Prévia de links com ícones inteligentes para mais detalhes.

Exemplo de payload quando um usuário visualiza o link https://www.example.com/12345:

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