visão geral do Kit de ferramentas do Microsoft Graph

Cuidado

O Microsoft Graph Toolkit foi preterido. O período de aposentadoria começa em 1º de setembro de 2025, com aposentadoria total planejada para 28 de agosto de 2026. Os desenvolvedores devem migrar para o uso dos SDKs do Microsoft Graph ou outras ferramentas do Microsoft Graph com suporte para criar experiências na Web. Para obter mais informações, consulte o anúncio de substituição.

Kit de ferramentas do Microsoft Graph é uma coleção de componentes e fornecedores de autenticação reutilizáveis e agnósticos de quadro para acessar e trabalhar com o Microsoft Graph. Os componentes são totalmente funcionais prontos para uso, com provedores integrados que se autenticam e buscam dados do Microsoft Graph.

O Kit de ferramentas do Microsoft Graph facilita o uso do Microsoft Graph em sua aplicação. No exemplo a seguir, um usuário conectado e seus eventos de calendário são exibidos com apenas duas linhas de código usando os componentes Logon e Agenda .

Por que usar o Microsoft Graph Toolkit?

O Microsoft Graph Toolkit permite que você integre de forma rápida e fácil experiências comuns da plataforma Microsoft Graph em seu próprio aplicativo. O kit de ferramentas:

  • Reduz o tempo de desenvolvimento. O trabalho de se conectar às APIs do Microsoft Graph e renderizar os dados em uma interface do usuário que se pareça com uma experiência do Microsoft 365 é feito para você, sem a necessidade de personalização.

  • Funciona em qualquer lugar. Todos os componentes são baseados em padrões da Web e funcionam perfeitamente com qualquer navegador moderno e estrutura da Web (como React, Angular ou Vue).

  • É bonito, mas flexível. Os componentes são projetados para se parecerem com as experiências do Microsoft 365, mas também são personalizáveis usando propriedades personalizadas CSS e modelos.

Quem deve usá-lo?

O Microsoft Graph Toolkit é ótimo para desenvolvedores de todos os níveis de experiência que desejam desenvolver um aplicativo que se conecte e acesse dados do Microsoft Graph, como:

  • Aplicativo Web
  • Guia Microsoft Teams
  • PWA (Aplicativo Web Progressivo)
  • Aplicativo Electron
  • Web Part do SharePoint

O que há no Microsoft Graph Toolkit?

Componentes

O Microsoft Graph Toolkit inclui uma coleção de componentes da Web para as experiências mais comumente criadas com APIs do Microsoft Graph.

Os componentes também estão disponíveis como componentes do React.

Componente Descrição
Agenda Exibe eventos no calendário de um usuário ou grupo.
Chat (versão prévia) Exibe uma conversa individual ou em grupo do Microsoft Teams
Arquivo Representa um arquivo ou pasta com um ícone, um nome de arquivo, um autor e muito mais.
Lista de arquivos Exibe uma lista de vários arquivos ou pastas.
Get Permite fazer uma consulta GET a qualquer API do Graph diretamente em seu HTML.
Logon Um botão e um controle de submenu para autenticar um usuário com a plataforma Microsoft Identity e exibir as informações de perfil do usuário quando ele entrar.
Novo chat (versão prévia) Um formulário para criar uma nova conversa individual ou em grupo no Microsoft Teams
Pessoas Exibe um grupo de pessoas ou contatos por suas fotos ou iniciais.
People picker Pesquisar pessoas e renderiza a lista de resultados.
Pessoa Exibe uma pessoa ou contato por sua foto, nome e/ou endereço de email.
Cartão pessoal Um submenu usado no componente pessoa para exibir mais informações de perfil sobre um usuário.
Seletor Renderiza um controle suspenso que permite a seleção de um único recurso de uma matriz de recursos.
Tarefas do Planner Exibe e habilita a adição, remoção, conclusão ou edição de tarefas do Microsoft Planner ou do Microsoft To Do.
Caixa de pesquisa Pesquise canais do Microsoft Teams para selecionar um canal em uma lista renderizada de resultados.
Resultados da pesquisa Permite que você faça uma consulta ao ponto de extremidade de pesquisa do Microsoft Graph diretamente em seu HTML.
Seletor de taxonomia Use o componente seletor de taxonomia para consultar a API do Graph Microsoft para Taxonomia e renderizar um controle suspenso com termos.
Seletor de canal do Teams Pesquise canais do Microsoft Teams para selecionar um canal em uma lista renderizada de resultados.
To Do Exibe e habilita a adição, remoção, conclusão ou edição de tarefas do Microsoft To Do.

Provedores

Os provedores habilitam a autenticação, fornecem a implementação para adquirir tokens de acesso em várias plataformas e expõem um cliente Microsoft Graph para chamar as APIs do Microsoft Graph. Os componentes funcionam melhor quando usados com um provedor, mas os provedores podem ser usados por conta própria.

Provedores Descrição
Personalizados Cria um provedor personalizado para habilitar a autenticação e o acesso ao Microsoft Graph usando o código de autenticação existente do aplicativo.
Elétron Autentica e fornece ao Microsoft Graph acesso aos componentes dentro dos aplicativos Electron.
MSAL2 Usa msal-browser para conectar usuários e adquirir tokens para usar com o Microsoft Graph.
Aplicativo Web Permite o uso da autenticação de back-end roteando todas as chamadas para o Microsoft Graph por meio de seu back-end.
SharePoint Autentica e fornece acesso do Microsoft Graph aos componentes dentro das Web Parts do SharePoint.
TeamsFx Use o provedor TeamsFx em seus aplicativos do Microsoft Teams para fornecer aos componentes do Microsoft Graph Toolkit acesso ao Microsoft Graph.

Onde posso usá-lo?

O Microsoft Graph Toolkit é compatível com os seguintes navegadores:

Borda Firefox Chrome Safari Opera Samsung Internet
Borda Firefox Chrome Safari Opera Samsung

Próximas etapas

  • Last updated on