Editar

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

  • Artigo
  • 2 minutos para o fim da leitura

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

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

Vários desses serviços são projetados para permitir cenários ricos 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. Obter as informações de perfil sobre o gerente de Lisa e as IDs de seus subordinados diretos, todos armazenados no Azure Active Directory.
  3. Acessar os arquivos de Lisa no OneDrive for Business, localizar a identidade da última pessoa que modificou um arquivo e navegar 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. Inscrever-se e acompanhar as mudanças no calendário de Lisa, dizer a Lisa quando ela estiver gastando 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. Obter a última projeção de vendas de um gráfico em um arquivo do Excel no OneDrive for Business de 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

Existem atualmente 2 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. Esteja ciente de que as APIs no status de visualização estão sujeitas a alterações e podem interromper os cenários existentes sem aviso prévio. Não obtenha uma dependência de produção de APIs no ponto de extremidade beta.

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

Saiba mais sobre os recursos e atualizações mais recentes no ponto de extremidade v1.0.

Fale conosco

Existem APIs adicionais ou recursos que você gostaria de ver no Microsoft Graph? Poste novas solicitações de recursos noFórum de ideias de Plataforma de Desenvolvedor Microsoft 365.

Possui comentários para APIs existentes do Microsoft Graph? Conecte-se conosco no Github.