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

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

Os conjuntos de API no v1.0 ponto de extremidade (https://graph.microsoft.com/v1.0) atingiram a 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

• Obtenha o perfil e a foto de um usuário.
• Obtenha as informações de perfil para o gerenciador de um usuário e as IDs de seus relatórios diretos, todos armazenados em Microsoft Entra ID.
• Acesse os arquivos de um usuário no OneDrive, localize a identidade da última pessoa que modificou um arquivo lá e vá para o perfil dessa pessoa.
• Acesse o calendário de um usuário no Exchange Online e determine a melhor hora para se encontrar com sua equipe nas próximas duas semanas.
• Assine e acompanhe as alterações no calendário de um usuário e informe ao usuário quando ele estiver gastando mais de 80% de seu tempo em reuniões.
• Defina respostas automáticas quando um usuário estiver longe do escritório.
• Obtenha as pessoas mais relevantes para um usuário, com base em comunicação, colaboração e relações comerciais.
• Obtenha a projeção de vendas mais recente de um gráfico em um arquivo do Excel no OneDrive de um usuário.
• Encontre as tarefas atribuídas a um usuário em Planner.

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

• 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.
• Localizar os planos desse grupo do Microsoft 365 e a atribuição de tarefas nesse plano.
• Iniciar uma nova conversa no grupo do Microsoft 365 para determinar se os membros desejam criar outro grupo para compartilhar a carga de trabalho.
• Obter o bloco de anotações padrão para o grupo e criar uma página para anotar o resultado da investigaçã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 obter mais informações sobre chamadas de API REST do Microsoft Graph, consulte Usar o Microsoft API do Graph.

Ponto de extremidade beta do Microsoft Graph

Atualmente, duas versões das APIs REST do Microsoft Graph estão disponíveis: 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.

Para obter mais informações, consulte Versão e suporte.

Novidades

Descubra as novidades no ponto de extremidade v1.0.

Para obter detalhes sobre as alterações nas APIs do Microsoft Graph na v1.0, explore o changelog da API.

Conteúdo relacionado

• Visão geral do Microsoft Graph
• Microsoft Graph Explorer
• Início rápido do Microsoft Graph
• Usar SDKs do Microsoft Graph