Skip to content

Latest commit

 

History

History
80 lines (47 loc) · 12.7 KB

outlook-calendar-concept-overview.md

File metadata and controls

80 lines (47 loc) · 12.7 KB
Raw

Visão geral da API do calendário do Outlook

O calendário do Outlook faz parte do hub de mensagens do Outlook no Office 365 que também permite gerenciar emails e contatos, encontrar informações sobre usuários em uma organização, iniciar conversas online, compartilhar arquivos e colaborar em grupos.

Por que integrar-se com o calendário do Outlook?

Alcance centenas de milhões de clientes e crie cenários sofisticados

Muitos milhões de clientes usam o calendário do Outlook como parte de um hub integrado que permite que eles se comuniquem e realizem tarefas com eficiência. Eles podem configurar reuniões, gerenciar emails, encontrar informações sobre contatos e outros usuários e iniciar conversas ou reuniões online, tudo em um único lugar, na Web, em dispositivos móveis ou na área de trabalho. O Microsoft Graph não só conecta os aplicativos aos dados do calendário, email e contatos desses clientes, permite que os aplicativos se integrem ao melhor do Microsoft 365 e ofereçam suporte a uma ampla variedade de cenários que aumentam a produtividade e a colaboração.

Automatizar a organização de compromissos e o calendário

Os clientes gostam da forma como o Outlook permite que eles organizem seu tempo dedicado ao trabalho, família e atividades pessoais. A API REST do Microsoft Graph mantém uma estreita paridade com a experiência do cliente, permitindo que os aplicativos criem, gerenciem e respondam a eventos com a mesma naturalidade:

  • No Outlook, os clientes podem criar calendários individuais para fins profissionais, familiares e outros e organizá-los em grupos do calendário. Eles podem ativar o calendário gratuito de Aniversários e Feriados para lembrá-los dos aniversários e dos feriados locais dos contatos. Eles podem adicionar calendários que correspondam aos seus interesses, como calendários de times esportivos e programas de TV. Os clientes podem escolher e sobrepor calendários e ver seus eventos na mesma visualização. Com a API de calendário, seu aplicativo pode organizar calendários em grupos de calendários e interagir com calendários interessantes como qualquer outro calendário na caixa de correio do usuário.

  • Os clientes do Outlook podem aplicar categorias a eventos, mensagens, contatos, tarefas e postagens de grupo de maneira consistente para melhorar a organização e a recuperação. A API de calendário permite acessar e definir uma lista mestra de categorias de usuários que abre outros cenários de criação. Por exemplo, um clube de atletismo pode organizar um torneio esportivo e oferecer um aplicativo que diferencia emails e eventos de cada esporte com sua própria categoria de cor. Para saber as últimas notícias, como alterações de horários imprevistas, o aplicativo também pode definir a propriedade importance desses eventos e emails para alertar os clientes.

  • Em uma pasta de calendário, você pode criar e atualizar eventos de instância única ou agendar e manter eventos recorrentes. Você pode deixar seus clientes responderem a solicitações de reunião e adiar ou dispensar lembretes usando a propriedade de navegação event.

Ajude os clientes a manterem-se sincronizados e a orientar seu dia de trabalho

A API de calendário ajuda os clientes a orientar seu dia de trabalho e aumentar a produtividade. Com ela, você pode:

Melhorar a colaboração

  • No Outlook, os clientes podem compartilhar calendários com entre eles e conceder permissões para ler, gravar ou excluir conteúdo do calendário. Ou podem delegar um calendário para que outro cliente responda a solicitações de reunião em nome deles. De forma programática, embora não seja possível iniciar uma ação de compartilhamento ou delegação em nome de um usuário, você pode usar um conjunto de propriedades para verificar o status de compartilhamento e habilitar cenários em torno de calendários compartilhados ou delegados: canEdit, canShare, canViewPrivateItems, isShared e isSharedWithMe.
  • A API de calendário permite que você receba itens de calendário do usuário conectado ou de usuários que compartilharam ou delegaram seus calendários ao usuário conectado. Por exemplo, se Henrique tiver compartilhado um calendário com Davi ou tiver delegado acesso a Davi, as permissões delegadas de Davi também concederão acesso de leitura ao calendário e ao conteúdo que Henrique compartilhou.
  • ** Os grupos do Office 365 permitem que os membros do grupo colaborem e acessem conversas e calendários de grupo diretamente no Outlook de forma prática. Além de algumas pequenas diferenças entre os calendários de grupo e os calendários de usuários, a API de calendário permite que você interaja com os calendários de grupo da mesma forma que interagiria com os calendários de usuários. Confira o recurso calendário para saber mais.

** Indica recursos especificamente aplicáveis a calendários do Outlook em contas corporativas ou de estudante.

Agendar de forma inteligente

O Outlook e a API de calendário oferecem muitas conveniências inteligentes para agendar eventos:

  • Com as configurações do aplicativo de calendário do Outlook, os clientes podem ativar a adição automática de eventos nos emails, como reservas de voos, hotéis ou restaurantes, e cobrar faturas. Após a adição dessas configurações, você poderá interagir com esses eventos da mesma maneira que interagiria com outros objetos events na caixa de correio do usuário e criar cenários criativos sobre esse recurso do Outlook.
  • ** No Outlook, reservar uma sala de reunião é tão simples quanto adicionar um participante ao evento. A API de calendário representa uma sala de reunião como um objeto emailAddress. Você pode obter salas (versão prévia) e obter listas de salas (versão prévia) que estão disponíveis em um locatário. Para organizar uma reunião em uma sala específica, atribua-a à propriedade location de event.
  • ** Você pode consultar as informações de livre/ocupado de usuários e recursos (versão prévia) para um determinado período de tempo. Em seguida, pode usar esses dados em diversos cenários, incluindo no planejamento de recursos e agendamento de eventos.
  • ** Se o seu cenário envolve o agendamento de reuniões no momento ideal, você pode considerar usar findMeetingTimes para identificar possíveis horários ou locais para reuniões. A função findMeetingTimes considera o status de disponibilidade dos participantes, salas e horários preferenciais e outras restrições que você fornecer. Se a primeira tentativa não retornar um horário de reunião comum, verifique o motivo, ajuste seus critérios e chame findMeetingTimes novamente.

Teleconferência em vários locais e fusos horários

Com a globalização, as atuais reuniões de negócios geralmente envolvem participantes de diferentes locais e fusos horários. Veja aqui como você pode usar o API de calendário para gerenciar essas reuniões:

  • Como exemplo no Outlook, os clientes podem organizar uma reunião e incluir participantes de uma sala de conferências em Seattle, uma cafeteria em Paris e um escritório doméstico na China. De forma programática, a propriedade locations do evento, que é uma coleção de objetos location, pode refletir esse nível de detalhes em displayName e locationType para cada location. Veja um exemplo.
  • O Outlook oferece aos clientes a flexibilidade de organizar eventos e especificar um fuso horário para cada um dos horários de início e término de um evento. Para oferecer suporte a essa flexibilidade, por padrão, a API de calendário retorna os horários de início e término de um evento em UTC e oferece as propriedades originalStartTimeZone e originalEndTimeZone para observar os fusos horários usados quando o evento foi criado.
  • Como alternativa, você pode especificar o cabeçalho Prefer: outlook.timezone="{time zone name}" para que uma operação de evento GET retorne início e término no fuso horário especificado. O nome do fuso horário pode ser qualquer um dos nomes compatíveis com o Windows e, também, os nomes nesta lista. Confira um exemplo de cabeçalho Prefer em uso.

Aproveite a inteligência social e outras conveniências de desenvolvedor no Microsoft Graph

Use a API de pessoas no Microsoft Graph para conectar-se a dados de pessoas que são baseados nos padrões de comunicação e colaboração de um usuário e nas relações comerciais. Você pode implementar controles, como um seletor de pessoas, e sugerir pessoas relevantes para o usuário ao organizar reuniões em nome do usuário.

Economize custos indiretos ao armazenar e gerenciar dados de aplicativos em armazenamentos de dados externos. Com o Microsoft Graph, você pode armazenar dados de aplicativos personalizados como extensões abertas em instâncias de recursos individuais. Se você precisar que os dados sejam digitados ou gostaria de poder compartilhar o esquema digitado, poderá armazenar dados de aplicativos personalizados em extensões de esquema.

Próximas etapas