Este artigo é a tradução do Blog em inglês do dia 17 de Novembro.



O que vai mudar 
Além de ler e gravar os dados do local de trabalho, estamos ampliando as funções da API Calendar também para as informações sobre horário de concentração e tempo fora do escritório. Os desenvolvedores poderão usar a API para ler e gravar esses dados e sincronizar a disponibilidade dos usuários com sistemas externos. Por exemplo, é possível usar a API junto com sistemas de RH para incluir automaticamente o tempo fora do escritório na agenda do usuário durante o período de férias. A API também pode ser usada para bloquear horários de concentração automaticamente na agenda de um usuário para a realização de treinamentos. 
 
  • Esta atualização é útil para: 
  • Criar e atualizar os eventos "Horário de concentração" e "Fora do escritório" (Events.Insert, Events.Update, Events.Patch). 
  • Especificar recursos para os eventos "Horário de concentração" e "Fora do escritório", como recusar reuniões automaticamente e definir o status "Não perturbe". 
  • Selecionar qualquer combinação dos tipos de eventos para ler em uma agenda (Events.List). 
 
Além disso, com a leitura e gravação desses dados, os usuários não precisam mais inserir as mesmas informações em vários sistemas, eliminando esse tipo de transtorno.
 
 
Para quem isso é válido?
Desenvolvedores
 
 
Por que usar
A compatibilidade com os eventos "Horário de concentração" e "Fora do escritório", além da leitura e gravação dos dados do local de trabalho (anunciadas neste ano), aprimoram a funcionalidade da API para eventos da agenda. Cada tipo de evento específico pode ser sincronizado com o ecossistema de TI da organização, o que simplifica as jornadas dos usuários e conecta os funcionários entre si e aos recursos. Confira alguns exemplos:
 
 
  • Mapear os dados do local de trabalho para adaptar melhor os recursos disponíveis e atualizar outras plataformas de terceiros, como ferramentas de reserva de mesas compartilhadas. 
  • Bloquear automaticamente períodos fora do escritório com base nos pedidos de descanso semanal remunerado ou férias.
  • Bloquear a agenda durante eventos "Horário de concentração" para que os usuários possam participar de integrações ou de outros treinamentos da empresa.
 
  Mais detalhes
Antes, se você solicitasse a leitura da agenda de um usuário com a API v3, os eventos "Fora do escritório" e "Horário de concentração" eram retornados com unknownorganizer@calendar.google.com no campo "Organizador" e sem recursos específicos. Com a atualização, esses eventos serão retornados com as respectivas propriedades e vão mostrar o usuário como organizador. Verifique seu código para garantir que ele não faça suposições implícitas nos valores retornados para a API anterior e use o parâmetro eventType para aplicar operações com eventos regulares, "Fora do escritório", "Horário de concentração" ou "Local de trabalho". 
 
 
Comece agora
 
Opções de lançamento
Disponibilidade
  • A API Calendar já está disponível para todos os usuários. 
     
  • Os eventos "Fora do escritório" estão disponíveis para clientes do Google Workspace Essentials, Enterprise Essentials, Frontline, Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Starter, Business Standard, Business Plus, Education Fundamentals, Education Standard e Education Plus.
     
  • Os eventos "Horário de concentração" estão disponíveis para clientes do Google Workspace Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Standard, Business Plus, Education Fundamentals, Education Standard e Education Plus.
Recursos