Exercício – Acessar as informações do usuário do Microsoft Graph usando o Explorador do Graph

  • 8 minutos

No exercício a seguir, você terá uma visão prática do Explorador do Graph e verá as APIs mais importantes do Microsoft Graph que o seu aplicativo pode chamar.

Noções básicas do Explorador do Graph

Digamos que um vendedor queira ver informações de perfil que incluem nome, cargo, e-mail e telefone celular. O processo para obter o perfil de um usuário no Explorador do Graph é o seguinte:

  1. Visite o site do Explorador do Graph.
  2. Na guia Exemplos de consultas no lado esquerdo, selecione qualquer API do Microsoft Graph.
  3. A consulta selecionada é executada automaticamente no Explorador do Graph. Observe o URL da API que você escolheu testar.
  4. Quando a consulta é executada com sucesso, você recebe uma notificação OK – 200.
  5. O resultado da solicitação aparece na guia Visualização da resposta.

Captura de tela mostrando o processo para obter o perfil de um usuário.

Testar consultas com sua própria conta no Explorador do Graph

Para esse exercício, vamos supor que um vendedor esteja procurando documentos compartilhados em reuniões, chats do Teams ou e-mails. A empresa de vendas também deseja uma maneira mais fácil de visualizar os documentos mais populares relativos aos usuários. Como desenvolvedor, você pode testar formas de obter os itens mais populares usando a API do Microsoft Graph para obter insights no Explorador do Graph.

Por padrão, o Explorador do Graph usa exemplos de dados da conta. Para testar consultas que obtêm seus próprios dados, você pode entrar com a sua conta. Você pode executar o teste utilizando o recurso de autenticação do Explorador do Graph.

Observação

Certifique-se de ter criado um locatário de desenvolvedor do Microsoft 365. Este é um dos pré-requisitos para este módulo.

  1. Selecione o botão Entrar no Explorador do Graph no lado esquerdo, entre com sua conta de locatário de desenvolvedor do Microsoft 365 e selecione Aceitar para dar consentimento às permissões solicitadas pelo Explorador do Graph.

    Após você entrar, suas informações de perfil aparecem no lado esquerdo.

  2. Selecione itens GET mais populares perto de mim no exemplos de consultas.

  3. Você recebe um aviso, significando que a API do Microsoft Graph para insights requer algumas permissões para executar a consulta.

  4. Selecione Modificar permissões. As permissões necessárias para a consulta selecionada aparecem.

  5. Selecione Consentir para dar seu consentimento a cada permissão.

    Captura de tela mostrando como testar consultas no Explorador do Graph com sua própria conta.

  6. Selecione Executar consulta.

  7. Após a API de Insights ter sido executada, você recebe uma mensagem OK – 200.

  8. Como resultado, você visualiza seus próprios itens mais populares na guia Visualização da resposta.

    Captura de tela mostrando como obter resultados de uma consulta no Explorador do Graph com sua própria conta.

Tente fazer uma solicitação POST no Explorador do Graph

Sempre que um novo vendedor é adicionado ao canal da equipe de vendas no Teams, você pode automatizar o envio de uma mensagem para o canal dando boas-vindas ao novo vendedor. Para enviar uma mensagem para um canal no Microsoft Teams, você pode usar uma solicitação POST no Explorador do Graph:

  1. Selecione POST na lista suspensa de verbos HTTP.

  2. Pesquise “equipes” na guia “Exemplos de consultas”.

  3. Selecione POST enviar mensagem ao canal na lista suspensa do Microsoft Teams.

  4. Você verá o pop-up de uma dica informando que precisará da ID da equipe e da ID do canal para essa consulta. A dica também recomenda executar GET minhas equipes associadas e GET o canal de uma equipe da qual sou membro para obter a ID da equipe e a ID do canal necessárias.

    Captura de tela mostrando como postar uma solicitação no Explorador do Microsoft Graph.

  5. Após obter a ID da equipe e a ID do canal, edite a consulta usando o editor de consultas. Certifique-se de substituir {team-id} e {channel-id} com as suas IDs.

  6. Dê seu consentimento às permissões necessárias na guia Modificar permissões.

  7. No Corpo da solicitação você encontrará conteúdos padrão, como “Olá, mundo”. Essa é a mensagem que você irá enviar ao seu canal no Microsoft Teams. Fique à vontade para alterar o conteúdo do corpo da solicitação com qualquer frase que você preferir enviar.

  8. Selecione Executar a consulta para executar a consulta.

  9. Quando a solicitação tiver sido concluída com sucesso, você verá uma mensagem Criada – 201.

    Captura de tela mostrando o resultado da postagem de uma solicitação no Explorador do Microsoft Graph.

  10. Para ver os resultados, vá para https://teams.microsoft.com e selecione Teams no menu do lado esquerdo. Localize a equipe e o canal que você escolheu para enviar a mensagem e clique no nome do canal para selecioná-lo. Você deverá ver a mensagem "Olá, Mundo" enviada por você no canal Postagens:

    Captura de tela mostrando o resultado da postagem de uma solicitação no Microsoft Teams.

Consumir o Microsoft Graph em seus aplicativos com a ajuda do Explorador do Graph

O Explorador do Graph tem outros recursos que podem ajudá-lo a conectar seus aplicativos ao Microsoft Graph:

  1. Token de acesso: as APIs do Microsoft Graph usam tokens de acesso para estabelecer a identidade do usuário e para executar a autenticação e a autorização. Na guia Token de acesso você pode copiar seu próprio token de acesso/autorização.

  2. Snippets de código: se você testar qualquer consulta do Microsoft Graph no Explorador do Graph e quiser consumir a mesma consulta no seu aplicativo, você pode ir para a guia Snippets de código para obter o respectivo código e adicioná-lo ao seu aplicativo. Snippets de código para todos os exemplos de consultas estão disponíveis em C#, em JavaScript, em Java e em Objective-C.

  3. Componente do kit de ferramentas: os componentes do Kit de Ferramentas do Microsoft Graph são componentes da web que não estão vinculados a nenhuma estrutura e podem ajudá-lo a acessar o Microsoft Graph. Você pode usar a guia Componente do kit de ferramentas para testar esses componentes em HTML e consumi-los nos seus aplicativos web para recuperar dados do Microsoft 365 por meio do Microsoft Graph. Quando você executa uma consulta e um componente do kit de ferramentas está disponível para a consulta, um ponto azul aparece no lado direito da guia.

  4. Cartões adaptáveis: os cartões adaptáveis são componentes da interface do usuário que não estão vinculados a nenhuma plataforma e são usados em bots. Se quiser consumir o Microsoft Graph nos seus chatbots, como o exemplo de bot de calendário mencionado anteriormente, você pode usar a guia Cartões adaptáveis para obter o snippet da interface do usuário. Se você executar uma consulta e um cartão adaptável estiver disponível para a consulta, um ponto azul aparece no lado direito da guia.

    Captura de tela mostrando como consumir o Microsoft Graph nos seus aplicativos com a ajuda do Explorador do Graph.

O Explorador do Graph é uma ferramenta em constante evolução, com muitos recursos que ajudam a facilitar o aprendizado e a prática para as pessoas que estão explorando os recursos do Microsoft Graph.