Trabalhar com o Explorador do Graph

O Graph Explorer é uma ferramenta de desenvolvedor que você pode usar para aprender sobre as APIs do Microsoft Graph. Possui uma variedade de recursos para ajudá-lo em sua jornada. Este artigo descreve alguns dos recursos importantes do Graph Explorer e como usá-los.

Para obter uma visão geral, consulte Usar o Explorador do Graph para experimentar as APIs do Microsoft Graph.

Na navegação superior, você pode entrar, exibir o locatário que está usando, acessar suas configurações e encontrar links úteis e um mecanismo de comentários.

Captura de tela do cabeçalho do Graph Explorer

  • Locatário: exiba o locatário que você está usando no momento.
  • Configurações: acesse as configurações do Graph Explorer para alterar o tema da interface ou para obter uma área restrita instantânea gratuita pré-configurada com pacotes de dados de exemplo.
  • Ajuda: Acesse links úteis, como a documentação ou o repositório GitHub para Graph Explorer.
  • Feedback: Se você quiser fornecer feedback, preencha o formulário da pesquisa.
  • Avatar do perfil: entre, visualize seu perfil, concorde com permissões, troque de conta ou saia da sua conta. Para obter detalhes sobre como consentir com permissões, consulte Consentimento para permissões.

O usuário ou administrador deve conceder ao Explorador do Graph as permissões corretas utilizando um processo de consentimento para acessar dados no Microsoft Graph. Você pode consentir com as permissões no Graph Explorer escolhendo a guia Modificar permissões ou a opção Consentimento para permissões no avatar do perfil quando estiver conectado.

A opção Consentimento para permissões no avatar do perfil contém a lista de todas as permissões disponíveis:

  1. Clique no avatar do perfil e escolha a opção Consentimento para permissões . Essa opção contém a lista de todas as permissões disponíveis.
  2. Na lista de todas as permissões, concorde com as que deseja.

Captura de tela do Explorador do Graph com a opção Selecionar permissões realçada

A guia Modificar permissões lista todas as permissões necessárias para executar a consulta na barra de endereços. Quando possível, escolha a permissão menos privilegiada.

Para consentir as permissões:

  1. Selecione uma consulta de exemplo e execute-a.
  2. Selecione a guia Modificar permissões.
  3. Consulte a lista de permissões necessárias para executar a consulta.
  4. Selecione o botão Consentimento ao lado da permissão que você deseja consentir.

Captura de tela do Explorador do Graph com as etapas de consentimento para permissões realçadas

Observação

O recurso Modificar permissões está atualmente em versão prévia e algumas consultas podem ter permissões ausentes.

Painel esquerdo

O painel esquerdo permite acessar os principais recursos do Graph Explorer:

Consultas de exemplo

A guia Consultas de exemplo fornece um conjunto de consultas categorizadas por serviço que você pode selecionar e executar para ajudá-lo a começar a usar as chamadas à API do Graph.

Captura de tela da guia de consultas de exemplo

Quando você seleciona uma consulta, a consulta selecionada preenche a caixa de consulta. Para experimentar a solicitação, escolha Executar consulta.

Recursos

Use a guia Recursos para explorar os recursos do Microsoft Graph nos pontos de extremidade beta e v1.0. Navegue pela lista de recursos ou use a barra de pesquisa para pesquisar um recurso específico.

Captura de tela da guia de recursos

Na guia Recursos , você pode exportar uma coleção de recursos para uma coleção do Postman fazendo o seguinte:

  1. No menu kebab ao lado do recurso, selecione Adicionar à coleção.
  2. Quando terminar de adicionar recursos, escolha Visualizar coleção.
  3. No modo de exibição de coleção, você pode examinar os recursos selecionados e remover os que desejar.
  4. Escolha Baixar coleção do Postman.

Captura de tela da tela de pré-visualização da coleção

Histórico

Todas as consultas executadas no Graph Explorer são salvas por 30 dias na guia Histórico. Na guia Histórico, você pode:

  • Exporte todos os itens do histórico no formato .har .
  • Excluir todos os itens do histórico.
  • Visualizar um item do histórico.
  • Executar uma consulta.
  • Exporte um item de histórico no formato .har .
  • Excluir um item do histórico.

Captura de tela da guia Histórico

Para compartilhar consultas executadas, selecione o botão Compartilhar situado ao lado do botão Executar consulta e selecione Copiar. Isso copia um link compartilhável que permite que outras pessoas vejam sua consulta e os resultados.

Captura de tela do Explorador do Graph com as opções Compartilhar e Copiar realçadas

Área de consulta

Use a área de consulta para executar solicitações e ver as respostas. A área de consulta inclui os seguintes elementos:

  • Métodos HTTP: uma lista suspensa dos métodos HTTP.
  • Versão da API: uma lista suspensa das versões da API disponíveis publicamente.
  • Caixa de consulta: uma barra em que você pode criar manualmente sua consulta ou ver a consulta preenchida automaticamente, caso tenha selecionado uma no painel esquerdo.
  • Corpo da solicitação: Um espaço para gravar o corpo da solicitação em formato JSON ou conteúdo MIME, de acordo com a solicitação desejada.
  • Cabeçalhos de solicitação: uma seção para adicionar cabeçalhos à sua solicitação especificando a chave e o valor.
  • Modificar permissões: você precisa consentir com as permissões corretas para poder executar uma consulta. Para obter detalhes, consulte consentimento para permissões.
  • Token de acesso: esta guia mostra seu token de acesso quando você está conectado. Você poderá copiar o token se precisar usá-lo em seu aplicativo cliente REST favorito.

Captura de tela do Graph Explorer destacando a área de consulta

Ao executar uma consulta, você verá uma visualização de resposta e cabeçalhos de resposta no painel de resposta.

Além da resposta, este painel também inclui:

Use o poder das bibliotecas de cliente

Para cada consulta de API REST selecionada ou inserida no Graph Explorer, você pode descobrir como fazer essa chamada em cada uma das linguagens com suporte: C#, Java, JavaScript, Go e PowerShell.

Captura de tela do Explorador do Graph com a guia trechos de código realçada

Integração do Kit de ferramentas do Microsoft Graph

O Microsoft Graph Toolkit é uma coleção de componentes Web reutilizáveis e agnósticos de estrutura e auxiliares para acessar e trabalhar com o Microsoft Graph. Os componentes são totalmente funcionais, com fornecedores internos que se autenticam e buscam dados do Microsoft Graph.

O Graph Explorer permite visualizar os componentes do Microsoft Graph Toolkit que correspondem às consultas da API. Um ponto azul na guia de componentes do kit de ferramentas indica que o Kit de Ferramentas fornece um componente para a consulta da API REST especificada no momento no Graph Explorer. Você pode copiar facilmente o código do componente em seu aplicativo.

Captura de tela mostrando a guia Componentes do Kit de Ferramentas

Integração de cartões adaptáveis

Os Cartões adaptáveis são trechos da interface de usuário que não dependem da plataforma, criados em JSON, que os aplicativos e serviços podem dividir. Um ponto azul na guia Cartões adaptáveis indica que um card adaptável está disponível para a consulta selecionada.

Captura de tela da guia cartões adaptáveis no Explorador do Graph com os detalhes da resposta realçados

Próximas etapas

  • Last updated on