Referência do ponto de extremidade do Microsoft Graph v1.0 API REST

  • Artigo

Bem-vindo à referência de API REST do Microsoft Graph para o v1.0 ponto de extremidade.

Os v1.0 conjuntos de API no ponto de extremidade (https://graph.microsoft.com/v1.0) estão em status de GA (disponibilidade geral) e passaram por um rigoroso processo de revisão e comentários com os clientes para atender às necessidades práticas de produção. Atualizações às APIs neste ponto de extremidade são de natureza aditiva e não quebram cenários de aplicativo existentes.

Casos comuns de uso

O poder do Microsoft Graph reside na fácil navegação de entidades e relacionamentos entre diferentes serviços expostos em um único ponto de extremidade REST do Microsoft Graph.

Alguns desses serviços são projetados para habilitar cenários avançados em torno de um usuário e em torno de um grupo.

Casos de uso centrado no usuário na v1.0

  1. Obter o perfil e a foto de um usuário, Lisa.
  2. Obtenha as informações de perfil sobre o gerente de Lisa e as IDs de seus relatórios diretos, todos armazenados em Microsoft Entra ID.
  3. Acesse os arquivos de Lisa no OneDrive, localize a identidade da última pessoa que modificou um arquivo lá e navegue até o perfil dessa pessoa.
  4. Acessar o calendário de Lisa no Exchange Online e determinar o melhor horário para Lisa se reunir com sua equipe nas próximas duas semanas.
  5. Assine e acompanhe as mudanças no calendário de Lisa, diga a Lisa quando ela está passando mais de 80% de seu tempo em reuniões.
  6. Definir respostas automáticas quando Lisa estiver fora do escritório.
  7. Receber as pessoas mais relevantes para a Lisa, com base nas relações de comunicação, colaboração e negócios.
  8. Obtenha a projeção de vendas mais recente de um gráfico em um arquivo do Excel no OneDrive da Lisa.
  9. Encontrar as tarefas atribuídas a Lisa no Planner.

Casos de uso de um grupo do Microsoft 365 na v1.0

  1. Emitir um relatório sobre grupos do Microsoft 365 em uma organização e identificar o grupo com mais comunicação entre os membros do grupo.
  2. Localizar os planos desse grupo do Microsoft 365 e a atribuição de tarefas nesse plano.
  3. Iniciar uma nova conversa no grupo do Microsoft 365 para determinar se os membros desejam criar outro grupo para compartilhar a carga de trabalho.
  4. Obter o bloco de anotações padrão para o grupo e criar uma página para anotar o resultado da investigação.

Outras versões da API

Atualmente, há duas versões de APIs REST do Microsoft Graph – v1.0 e beta. Se você estiver interessado em APIs novas ou aprimoradas que ainda estejam no status de visualização, consulte referência de ponto de extremidade beta do Microsoft Graph.

Cuidado

AS APIs em status de visualização estão sujeitas a alterações e podem quebrar cenários existentes sem aviso prévio. Não faça uma dependência de produção em APIs no beta ponto de extremidade.

Encontre mais informações em Suporte e controle de versão.

Chame o ponto de extremidade do v 1.0

As solicitações da API do Microsoft Graph para o ponto de extremidade v1.0 usam o seguinte padrão:

https://graph.microsoft.com/v1.0/{resource}?[query_parameters]

Para detalhes, consulte Usando a API do Microsoft Graph.

Novidades

Descubra as novidades no ponto de extremidade v1.0.

Explore o changelog de API para obter mais detalhes sobre as alterações nas APIs do Microsoft Graph.

Conteúdo relacionado