Permissões da conta de usuário

Captura de tela das permissões que o Webex solicita quando você ativa o agendador para se conectar à conta do Google
Figura 1: A Webex solicita essas permissões
Tabela 1. Permissões solicitadas e como o Webex as utiliza

Permissão

Escopo

Dados acessados

Para que o Webex o usa?

Exibir seus mensagem de e-mail de dados quando o complemento estiver sendo executado

Gmail

Linha do assunto, data e hora, lista de convidados

Ao agendar uma reunião Webex no Gmail, o agendador lerá essas informações, que são os requisitos essenciais para agendar a reunião.

Executar como complemento do Gmail

Gmail

Permite que o Agendador Webex execute no Gmail de um usuário.

Veja os eventos que você abre no Google Calendar

Calendário

Linha do assunto, data e hora, lista de convidados

Quando você abre um evento no Google Calendar, o agendador lê essas informações, que são os requisitos essenciais para agendar a reunião.

Editar os eventos que você abre no Google Calendar

Calendário

Linha de assunto

Adicionar informações de dados de conferência Webex (iU/propriedade do cartão) no evento de calendário aberto no momento.

Executar como um complemento de Calendário

Calendário

Permite que o Agendador Webex execute no calendário Google de um usuário

Exibir e editar eventos em todos os seus calendários

Calendário

Ler linha de assunto, data e hora, lista de convidados

Editar linha de assunto

Nos permite suportar cenários de calendários compartilhados, da mesma maneira que lemos de e escrevemos em eventos no calendário de um único usuário.

Visualizar as configurações do seu calendário

Calendário

O Google OAuth 2.0 requer este escopo. Consulte .https://developers.google.com/calendar/api/guides/auth

Ver informações sobre usuários no seu domínio

Administração do Google Workspace

WEBEX siteURL nas Informações do Google User

Se você tiver definido uma URL do site Webex nas informações do usuário do Google, nós podemos ler essa URL e efetuar logon neste site como padrão do usuário.

Conectar-se a um serviço externo

Script de aplicativos

Conectar-se ao serviço Webex

O agendador precisa chamar o serviço Webex para solicitar a criação/atualização/exclusão da reunião Webex associada.

Permitir que este aplicativo seja executado quando você não estiver presente

Script de aplicativos

Acessar objeto de evento google baseado no google trigger

Isso permite que o Agendador execute quando você não estiver presente, em resposta a um acionador do Google, por exemplo, para atualizar/excluir uma reunião no seu calendário. Consulte .https://developers.google.com/apps-script/guides/triggers/events

Visualizar e gerenciar dados associados ao aplicativo

Script de aplicativos

Cache do aplicativo

O Agendador armazena em cache algumas informações Webex no armazenamento Google. Por exemplo, a URL do site Webex e o endereço de e-modelo de reunião Webex.

Veja seu país, idioma e timezone

Script de aplicativos

Hora atual do usuário

O agendador lê seu fuso horário para agendar ou atualizar a reunião Webex associada.

Consulte o endereço de e-mail principal da conta do Google

Outro

Endereço da conta do Gmail do usuário

O Agendador lê o endereço de e-mail do usuário para vinculá-lo à sua conta Webex.

Veja suas informações pessoais, incluindo qualquer informação pessoal que você tenha disponibilizado publicamente

Outro

Nome do usuário e idioma preferencial (padrão)

O Agendador lê a senha pública do informações do usuário, incluindo o nome completo e o idioma preferido a ser usado como padrão do usuário.

Visão geral da arquitetura do agendador Webex

Diagrama da arquitetura mostrando a nuvem do Google, a nuvem Webex e o cliente do Google Calendar, com setas numeradas vinculando-as.
  1. O administrador do site usa administração do site ou Control Hub para habilitar o complemento Webex para o Google Workspace.

  2. Cada indivíduo autoriza as permissões para o complemento Webex do Google Workspace (se o administrador não autorizar) e conecta a conta do Google com a conta Webex.

  3. O Webex está inscrito nas alterações do calendário do Google.

  4. Um usuário adiciona uma reunião Webex a um evento do Google Calendar, atualiza a hora ou o tópico ou copia um evento para outra data e hora.

  5. O cliente de complemento Webex recebe notificações do Google Calendar e sincroniza com o Webex.

APIs Google usadas pelo agendador Webex

As tabelas abaixo fornecem informações sobre as APIs do Google usadas pelo Agendador Webex.


 

Na maioria dos casos, o Agendador Webex usa a API do Script do Google App. Por alguns casos, o agendador usa a API REST do Google. Geralmente, a API do Script do Google App termina a API ASSOCIADA do Google REST. A coluna URL de referência aponta para a API do script do Google App onde possível, mas pode consultar a URL de referência da API Google REST se necessário.

Tabela 2. APIs de script do Google App usadas pelo Agendador Webex

Google App Script API

O que ele faz

URL de referência

Calendar.getID 

Obter a ID do calendário de usuários, a ID do calendário padrão é o endereço de e-mail do usuário 

https://developers.google.com/apps-script/reference/calendar/calendar#getId()

Calendar.getName 

Obter o nome do calendário de 

https://developers.google.com/apps-script/reference/calendar/calendar#getName()

Calendar.getTimezone 

Obter o horário do calendário de 

https://developers.google.com/apps-script/reference/calendar/calendar#getTimeZone()

Calendar.Events.list 

Procurar eventos específicos que são de acordo com alguns critérios 

https://developers.google.com/calendar/api/v3/reference/events/list

Calendar.Events.patch 

Atualize os metadados do evento específico para armazenar as informações da reunião Webex 

https://developers.google.com/calendar/api/v3/reference/events/patch

CalendarEvent.attendees 

As propriedades para acessar os participantes do calendário 

https://developers.google.com/calendar/api/v3/reference/events#resource

CalendarEvent.conferenceData 

As propriedades para acessar os dados da conferência de eventos 

https://developers.google.com/calendar/api/v3/reference/events#resource

CalendarEvent.getTitle 

Obter o tópico do evento do calendário. 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getTitle()

CalendarEvent.getCreators 

Obter o criador do evento do calendário 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getCreators()

CalendarEvent.getStartTime 

Comece o horário de início do evento 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime()

CalendarEvent.getEndTime 

Ad chegar ao horário de término do evento 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getEndTime()

Serviço de Cache.getUserCache 

Obter o cache do usuário para recuperar as configurações de preferência do usuário 

https://developers.google.com/apps-script/reference/cache/cache-service#getUserCache()

Cache.get 

Obter configuração de cache específica por chave 

https://developers.google.com/apps-script/reference/cache/cache#get(String)

Cache.colocado 

Definir algum cache específico por chave 

https://developers.google.com/apps-script/reference/cache/cache#put(String,String)

Serviço de Dados da Conferência. newConferenceDataBuilder 

Crie uma estrutura de dados específicos do Google para armazenar e exibir informações da reunião Webex 

https://developers.google.com/apps-script/reference/conference-data/conference-data-service#newConferenceDataBuilder()

ConferenceDataBuilder.build 

Gerar dados de informações da reunião Webex 

https://developers.google.com/apps-script/reference/conference-data/conference-data-builder#build()

GmailApp.getMessageById 

Recupere a mensagem específica do gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-app#getMessageById(String)

GmailApp.createDraft 

Crie uma mensagem do Gmail que contenha o corpo do e-mail Webex 

https://developers.google.com/apps-script/reference/gmail/gmail-app#createDraft(String,String,String)

GmailMessage.getFrom 

Receber e-mail do remetente do Gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getFrom()

GmailMessage.getTo 

Obter receptor de jogos 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getTo()

GmailMessage.getSubject 

Obter título das mensagens do Gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getSubject()

GmailMessage.getDate 

Receber data e hora da mensagem do Gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getDate()

PropriedadesServiço.getUserPropriedades 

Acesse a configuração ou a perferência do usuário persistir 

https://developers.google.com/apps-script/reference/properties/properties-service#getUserProperties()

Propriedades.getPropriedade 

Obter propriedade específica por chave 

https://developers.google.com/apps-script/reference/properties/properties#getProperty(String)

Propriedades.setProperty 

Definir nova propriedade para a chave e o valor 

https://developers.google.com/apps-script/reference/properties/properties#setProperty(String,String)

Session.getEffectiveUser().getEmail 

Obter e-mail do usuário atual 

https://developers.google.com/apps-script/reference/base/user#getEmail()

Aplicativo de script.newTrigger 

Configurar um novo acionador para lidar com a atualização do evento 

https://developers.google.com/apps-script/reference/script/script-app#newTrigger(String)

UrlFetchApp.fetch 

Use esta API para ligar para o serviço webex addin ou google API para criar/atualizar reunião, nós não ligaremos para nenhum outro serviço de terceiros 

https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String)

Tabela 3. APIs Google REST usadas pelo Agendador Webex

Google REST API

O que ele faz

URL de referência

PUBLICAR https://accounts.google.com/o/oauth2/token

Obter token de autenticação do Google

https://developers.google.com/identity/protocols/oauth2/web-server#exchange-authorization-code

OBTER https://www.googleapis.com/admin/directory/v1/users/{userKey}

Obter o usuário configurado webex site

https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get

Perguntas mais frequentes

Como o Webex garante a integração?

O complemento é executado no servidor de plataformas da nuvem do Google e nenhum dado do Google é salvo, exceto as informações da reunião Webex (assunto, lista de convidados) que são armazenadas no backend do Webex e excluídas após o reunião agendada terminar.

Consulte .https://help.webex.com/ituhp0

Como podemos proteger os dados dos clientes que "retiramos" dessa integração?

Nós coletamos apenas os dados de que precisamos e os armazenamos apenas enquanto necessário.

Nós coletamos informações da reunião Webex e as armazenamos na nuvem Webex. Excluímos as informações da reunião após um determinado período de tempo, que você controla com sua política de retenção do Webex.

Usamos uma API pública ou privada para conectar ao serviço Google?

O Addon é executado na plataforma de nuvem do Google e acessa diretamente as bibliotecas integrados do Google.

Consulte .https://developers.google.com/apps-script/overview