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

Bem-vindo à Referência da API REST do Microsoft Graph para o v1.0 ponto final.

Os conjuntos de API no v1.0 ponto final (https://graph.microsoft.com/v1.0) atingiram a disponibilidade geral (GA) e passaram por um rigoroso processo de revisão e feedback com os clientes para satisfazer necessidades práticas e de produção. As atualizações às APIs neste ponto final são aditivas por natureza e não interrompem os cenários de aplicações 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 destes serviços foram concebidos para permitir cenários avançados em torno de um utilizador e de um grupo.

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

• Obtenha o perfil e a fotografia de um utilizador.
• Obtenha as informações de perfil do gestor de um utilizador e os IDs dos respetivos relatórios diretos, todos armazenados no Microsoft Entra ID.
• Aceda aos ficheiros de um utilizador no OneDrive, localize a identidade da última pessoa que modificou um ficheiro e aceda ao perfil dessa pessoa.
• Aceda ao calendário de um utilizador no Exchange Online e determine a melhor altura para se reunir com a equipa nas próximas duas semanas.
• Subscreva e registe alterações no calendário de um utilizador e informe o utilizador quando estiver a gastar mais de 80% do seu tempo em reuniões.
• Definir respostas automáticas quando um utilizador está fora do escritório.
• Obtenha as pessoas mais relevantes para um utilizador, com base na comunicação, colaboração e relações empresariais.
• Obtenha a projeção de vendas mais recente a partir de um gráfico num ficheiro do Excel no OneDrive de um utilizador.
• Localize as tarefas atribuídas a um utilizador no 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 as chamadas à API REST do Microsoft Graph, veja Utilizar a Microsoft Graph API.

Ponto final beta do Microsoft Graph

Atualmente, estão disponíveis duas versões das 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 no estado de pré-visualização estão sujeitas a alterações e podem interromper cenários existentes sem aviso prévio. Não assuma uma dependência de produção nas APIs no beta ponto final.

Para obter mais informações, consulte Controlo de versões e suporte.

Novidades

Descubra as novidades no ponto final v1.0.

Para obter detalhes sobre as alterações às APIs do Microsoft Graph na v1.0, explore o registo de alterações da API.

Conteúdo relacionado

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