Referência da API REST do Microsoft Graph v1.0Microsoft Graph REST API v1.0 reference

Bem-vindo à referência da API REST do Microsoft Graph para o ponto de extremidade v1.0.Welcome to Microsoft Graph REST API reference for the v1.0 endpoint.

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.API sets on the v1.0 endpoint (https://graph.microsoft.com/v1.0) are in general availability (GA) status, and have gone through a rigorous review-and-feedback process with customers to meet practical, production needs. Atualizações para APIs neste ponto de extremidade são de natureza aditiva e não quebram os cenários de aplicativos existentes.Updates to APIs on this endpoint are additive in nature and do not break existing app scenarios.

Casos comuns de usoCommon use cases

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.The power of Microsoft Graph lies in easy navigation of entities and relationships across different services exposed on a single Microsoft Graph REST endpoint.

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.A number of these services are designed to enable rich scenarios around a user and around a group.

Casos de uso centrado no usuário na v1.0User-centric use cases in v1.0

  1. Obter o perfil e a foto de um usuário, Lisa.Get the profile and photo of a user, 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.Get the profile information about Lisa's manager and IDs of her direct reports, all stored in 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.Access Lisa's files on OneDrive for Business, find the identity of the last person who modified a file there, and navigate to that person's profile.
  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.Access Lisa's calendar on Exchange Online and determine the best time for Lisa to meet with her team in the next two weeks.
  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.Subscribe to and track changes in Lisa's calendar, tell Lisa when she is spending more than 80% of her time in meetings.
  6. Definir respostas automáticas quando Lisa estiver fora do escritório.Set automatic replies when Lisa is away from the office.
  7. Receber as pessoas mais relevantes para a Lisa, com base nas relações de comunicação, colaboração e negócios.Get the people who are most relevant to Lisa, based on communication, collaboration, and business relationships.
  8. Obter a última projeção de vendas de um gráfico em um arquivo do Excel no OneDrive for Business de Lisa.Get the latest sales projection from a chart in an Excel file in Lisa's OneDrive for Business.
  9. Encontrar as tarefas atribuídas a Lisa no Planner.Find the tasks assigned to Lisa in Planner.

Casos de uso de grupo do Office 365 na v1.0Office 365 group use cases in v1.0

  1. Executar um relatório sobre grupos do Office 365 em uma organização e identificar o grupo com mais comunicação entre os membros do grupo.Run a report on Office 365 groups in an organization and identify the group with the most communication among group members.
  2. Encontrar os planos desse grupo do Office 365 e a atribuição de tarefas nesse plano.Find the plans of this Office 365 group, and the assignment of tasks in that plan.
  3. Iniciar uma nova conversa no grupo do Office 365 para determinar se os membros desejam criar outro grupo para compartilhar a carga de trabalho.Start a new conversation in the Office 365 group to determine if members want to create another group to share the workload.
  4. Obter o bloco de anotações padrão para o grupo e criar uma página para anotar o resultado da investigação.Get the default notebook for the group and create a page to note the outcome of the investigation.

Outras versões da APIOther API versions

Existem atualmente 2 versões de APIs REST do Microsoft Graph - v1.0 e beta.There are currently 2 versions of Microsoft Graph REST APIs - v1.0 and 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.If you're interested in new or enhanced APIs that are still in preview status, see Microsoft Graph beta endpoint reference. 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.Be aware that APIs in preview status are subject to change, and may break existing scenarios without notice. Não obtenha uma dependência de produção de APIs no ponto de extremidade beta.Don't take a production dependency on APIs in the beta endpoint.

Encontre mais informações em Suporte e controle de versão.Find more information about versioning and support.

Fale conoscoConnect with us

Existem APIs adicionais ou recursos que você gostaria de ver no Microsoft Graph?Are there additional APIs or features you'd like to see in Microsoft Graph? Poste novas solicitações de recursos no UserVoice.Post new feature requests on UserVoice.

Possui comentários para APIs existentes do Microsoft Graph?Have feedback for existing Microsoft Graph APIs? Conecte-se conosco em Github.Connect with us on Github.