Compartilhar via

Trabalhar com o Explorador do Graph

O Graph Explorer é uma ferramenta de programador que pode utilizar para saber mais sobre as APIs do Microsoft Graph. Tem uma variedade de funcionalidades para ajudá-lo no seu percurso. Este artigo descreve algumas das funcionalidades importantes do Graph Explorer e como utilizá-las.

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

Na navegação superior, pode iniciar sessão, ver o inquilino que está a utilizar, aceder às suas definições e encontrar ligações úteis e um mecanismo de feedback.

Captura de ecrã do cabeçalho do Graph Explorer

  • Inquilino: veja o inquilino que está a utilizar atualmente.
  • Definições: o Access Graph Explorer definições para alterar o tema da interface ou para obter um sandbox instantâneo gratuito pré-configurado com pacotes de dados de exemplo.
  • Ajuda: aceda a ligações úteis, como a documentação ou o repositório do GitHub para o Graph Explorer.
  • Feedback: se quiser fornecer comentários, pode preencher o formulário de inquérito.
  • Avatar do perfil: inicie sessão, veja o seu perfil, consoante as permissões, mude de conta ou termine sessão na sua conta. Para obter detalhes sobre como consentir permissões, veja Consent to permissions (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. Pode consentir permissões no Graph Explorer ao selecionar o separador Modificar permissões ou a opção Consentimento para permissões no avatar do perfil quando tiver sessão iniciada.

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 selecione 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

O separador Modificar permissões lista todas as permissões de que poderá ter de executar a consulta na barra de endereço. Sempre que possível, escolha a permissão com menos privilégios.

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

A funcionalidade Modificar permissões está atualmente em pré-visualização e algumas consultas podem ter permissões em falta.

Painel esquerdo

O painel esquerdo permite-lhe aceder às principais funcionalidades do Graph Explorer:

Consultas de exemplo

O separador Consultas de exemplo fornece um conjunto de consultas categorizadas pelo serviço que pode selecionar e executar para o ajudar a começar a utilizar as chamadas do Microsoft API do Graph.

Captura de ecrã a mostrar o separador Consultas de exemplo

Quando seleciona uma consulta, a consulta selecionada preenche a caixa de consulta. Para experimentar o pedido, selecione Executar consulta.

Recursos

Utilize o separador Recursos para explorar os recursos do Microsoft Graph nos pontos finais beta e v1.0. Procure na lista de recursos ou utilize a barra de pesquisa para procurar um recurso específico.

Captura de ecrã do separador recursos

No separador Recursos , pode exportar uma coleção de recursos para uma coleção do Postman ao fazer o seguinte:

  1. No menu do atalho junto ao recurso, selecione Adicionar à coleção.
  2. Quando terminar de adicionar recursos, selecione Pré-visualizar coleção.
  3. Na vista de coleção, pode rever os recursos que selecionou e remover quaisquer, se preferir.
  4. Selecione Transferir coleção do Postman.

Captura de ecrã do ecrã da coleção de pré-visualização

Histórico

Todas as consultas executadas no Graph Explorer são guardadas durante 30 dias no separador Histórico. No separador Histórico, pode:

  • Exportar 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.
  • Exportar um item de histórico no formato .har .
  • Excluir um item do histórico.

Captura de ecrã do separador Histórico

Para partilhar as consultas que executa, selecione o botão Partilhar situado junto ao botão Executar consulta e, em seguida, selecione Copiar. Esta ação copia uma ligação partilhável que permite que outras pessoas vejam a sua consulta e os resultados.

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

Área de consulta

Utilize a área de consulta para executar pedidos e ver as respostas. A área de consulta inclui os seguintes elementos:

  • Métodos HTTP: uma lista pendente dos métodos HTTP.
  • Versão da API: uma lista pendente das versões da API disponíveis publicamente.
  • Caixa de consulta: uma barra onde pode criar manualmente a consulta ou ver a consulta preenchida automaticamente se tiver selecionado uma no painel esquerdo.
  • Corpo do pedido: um espaço para escrever o corpo do pedido no formato JSON ou conteúdo MIME, de acordo com o pedido pretendido.
  • Cabeçalhos do pedido: uma secção para adicionar cabeçalhos ao seu pedido ao especificar a chave e o valor.
  • Modificar permissões: tem de consentir as permissões certas para poder executar uma consulta. Para obter detalhes, veja Consenting to permissions (Consentimento para permissões).
  • Token de acesso: este separador mostra o token de acesso quando tem sessão iniciada. Pode copiar o token se precisar de utilizá-lo na sua aplicação cliente REST favorita.

Captura de ecrã do Graph Explorer a realçar a área de consulta

Quando executar uma consulta, verá os cabeçalhosResponse preview (Pré-visualização da resposta) e Response (Resposta) no painel de resposta.

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

Utilizar o poder das bibliotecas de cliente

Para cada consulta da API REST que selecionar ou introduzir no Graph Explorer, pode encontrar como efetuar essa chamada em cada uma das linguagens suportadas: 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 da arquitetura para aceder 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-lhe visualizar componentes do Microsoft Graph Toolkit que correspondem às consultas da API. Um ponto azul no separador do componente do toolkit indica que o Toolkit fornece um componente para a consulta da API REST atualmente especificada no Graph Explorer. Você pode copiar facilmente o código do componente em seu aplicativo.

Captura de ecrã a mostrar o separador Componentes do Toolkit

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 no separador Cartões ajustáveis indica que está disponível uma card adaptá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