Usar o Explorador do Graph para tentar Microsoft Graph APIs

O Graph Explorer é uma ferramenta de desenvolvedor para explorar APIs do Microsoft Graph. Use-o para:

  • Teste APIs em um locatário de exemplo e explore os recursos disponíveis.
  • Entre em seu próprio locatário para criar protótipos de cenários de aplicativos.
  • Saiba mais sobre as permissões necessárias para diferentes APIs.
  • Explore os componentes do Microsoft Graph Toolkit, os cartões adaptáveis e os trechos de código para consultas.

Para começar, acesse o Graph Explorer em seu navegador.

Explorar uma consulta de exemplo

Você pode executar as consultas de exemplo predefinidas para ver como a API funciona. Selecione qualquer consulta de exemplo, como Obter meu perfil, para ver a solicitação e a resposta.

Captura de tela da interface do usuário do Graph Explorer, que exibe os resultados retornados da consulta GET my profile.

Entre para mais recursos

Você pode usar o Graph Explorer sem entrar. Os usuários que entrarem poderão acessar seus próprios locatários e realizar operações mais avançadas. Para experimentar solicitações POST, PUT, PATCH e DELETE, entre com sua conta do Microsoft 365.

Recomendamos entrar em seu locatário de área restrita do Desenvolvedor do Microsoft 365 em vez de seu locatário de produção para evitar a execução de operações que possam afetar seus dados de produção.

Importante

Se você optar por entrar com sua conta organizacional, a execução de qualquer solicitação de gravação no Graph Explorer poderá afetar os dados no locatário.

Executar sua primeira consulta

Para executar uma consulta no Graph Explorer:

  1. Selecione uma consulta de amostra ou digite sua consulta no campo de solicitação.
  2. Edite o corpo da solicitação e os cabeçalhos da solicitação conforme necessário para a consulta. Por exemplo, para executar uma solicitação Post, selecione POST na lista suspensa para o verbo HTTP e adicione um corpo de solicitação e cabeçalhos de solicitação conforme apropriado.
  3. Selecione Executar consulta. A resposta é exibida na seção Visualização de resposta. Ele inclui o código de status HTTP e os dados retornados pela API.
  4. Ao lado da guia visualização da resposta, você também pode exibir os cabeçalhos de resposta, snippets de código, componentes do Kit de Ferramentas e cartões adaptáveis relevantes para a consulta.

Captura de tela do Graph Explorer executando uma consulta POST para criar um novo aplicativo.

Modificar permissões

Algumas consultas exigem permissões específicas. Se uma consulta falhar devido a permissões insuficientes, você verá uma mensagem de erro. Para consentir as permissões:

  1. Selecione Modificar permissões para consentir com as permissões necessárias.
  2. Execute a consulta novamente.
  3. Você também pode selecionar o avatar do perfil e escolher Consentimento para permissões. Na lista de todas as permissões disponíveis, dê seu consentimento para as permissões desejadas.

Captura de tela da guia Modificar permissões no Graph Explorer.

Encontre a API certa para seu aplicativo

Use a guia Recursos e o recurso de documentação para encontrar a API certa para seu aplicativo.

Guia Recursos

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

Você também pode selecionar consultas específicas para adicionar à sua coleção. Quando terminar de adicionar recursos, escolha Visualizar coleção. Na exibição da coleção, você pode examinar, remover e baixar os recursos selecionados.

À esquerda, há uma captura de tela da guia Resources no Graph Explorer. O lado direito exibe o painel Visualizar coleção.

Selecione Documentação em cada consulta para saber mais sobre o ponto de extremidade da API. A referência de API relevante fornece mais informações sobre os parâmetros da solicitação, a estrutura de resposta e as permissões necessárias.

Integrar APIs do Microsoft Graph ao seu aplicativo

Use os seguintes recursos no Graph Explorer para integrar APIs do Microsoft Graph ao seu aplicativo.

Trechos de código

Depois de executar uma consulta, selecione a guia Snippets de código para ver como executar a mesma operação em sua linguagem preferida (C#, JavaScript, Java, Go, PowerShell).

Captura de tela da guia trechos de código no Graph Explorer.

Componente do kit de ferramentas

O Microsoft Graph Toolkit fornece componentes e auxiliares da Web reutilizáveis e agnósticos de estrutura que têm provedores integrados que se autenticam e buscam dados do Microsoft Graph.

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

Captura de tela da guia Microsoft Graph Toolkit no Graph Explorer.

Cartões adaptáveis

Os cartões adaptáveis fornecem snippets de interface do usuário independentes de plataforma, criados em JSON, que aplicativos e serviços podem trocar abertamente. 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 Graph Explorer com os detalhes da resposta destacados.

Mais recursos do Graph Explorer

Para ajudá-lo a aproveitar ao máximo o Graph Explorer, familiarize-se com os seguintes recursos adicionais da ferramenta.

Histórico

Selecione Histórico para acessar e exportar consultas executadas nos últimos 30 dias.

Captura de tela da guia de histórico no Graph Explorer.

Configurações

Você pode personalizar a interface do usuário do Graph Explorer usando o ícone de configurações no canto superior direito. Você também pode expandir, recolher ou redimensionar a barra lateral.

Compartilhar

Para compartilhar sua consulta atual, selecione Compartilhar para que as pessoas possam experimentar a consulta específica no Graph Explorer.

Conteúdo relacionado

  • Last updated on