Visão Geral do Microsoft Graph

O Microsoft Graph é a porta de entrada para dados e inteligência em serviços de nuvem da Microsoft, como o Microsoft Entra e o Microsoft 365. Use a riqueza de dados acessíveis por meio do Microsoft Graph para criar aplicativos para organizações e consumidores que interagem com milhões de usuários.

Diagrama que mostra como a API do Graph, os conectores do Copilot e o Data Connect potencializam a plataforma Microsoft 365.

Dados e serviços que impulsionam a plataforma Microsoft 365

Na plataforma Microsoft 365, três componentes principais permitem o acesso e o fluxo de dados:

  • A API do Microsoft Graph oferece um único ponto de extremidade, https://graph.microsoft.com, para fornecer acesso a dados e insights avançados e centrados em pessoas na nuvem da Microsoft, incluindo Microsoft 365, Windows e Enterprise Mobility + Security. Use APIs REST ou SDKs para acessar o ponto de extremidade e criar aplicativos para cenários do Microsoft 365. Esses cenários abrangem produtividade, colaboração, educação, inteligência de pessoas e do local de trabalho e muito mais. O Microsoft Graph também inclui um conjunto avançado de serviços que gerencia a identidade do usuário e do dispositivo, acesso, conformidade, e segurança e ajuda a proteger organizações contra vazamento ou perda de dados.
  • Os conectores do Microsoft 365 Copilot (anteriormente conectores do Microsoft Graph) trabalham na direção de entrada, fornecendo dados externos à nuvem da Microsoft em serviços e aplicativos do Microsoft Graph para aprimorar as experiências do Microsoft 365, como a Pesquisa da Microsoft. Existem conectores para muitas fontes de dados comumente usadas, como Box, Google Drive, Jira e Salesforce.
  • Conexão de Dados do Microsoft Graph fornece um conjunto de ferramentas para simplificar a entrega segura e escalonável de dados do Microsoft Graph para armazenamentos de dados populares do Azure. Os dados em cache servem como fontes de dados para ferramentas de desenvolvimento do Azure que você pode usar para criar aplicativos inteligentes.

Juntos, a API do Microsoft Graph, os conectores e a conexão de dados capacitam a plataforma Microsoft 365. Com a capacidade de acessar dados do Microsoft Graph e outros conjuntos de dados, você pode obter percepções e análises, estender as experiências do Microsoft 365 e criar aplicativos exclusivos e inteligentes.

Serviços do Microsoft Graph

O Microsoft Graph expõe as APIs REST e bibliotecas do cliente para acessar dados nos seguintes serviços na nuvem da Microsoft:

  • Serviços principais do Microsoft 365: Bookings, Calendar, Excel, Descoberta Eletrônica do Microsoft Purview, Pesquisa da Microsoft, OneDrive, OneNote, Outlook/Exchange, People (contatos do Outlook), Planner, SharePoint, Teams, To-Do, Viva Insights
  • Serviços do Enterprise Mobility + Security: Advanced Threat Analytics, Proteção Avançada contra Ameaças, Microsoft Entra, Identity Manager e Intune
  • Serviços do Windows: atividades, dispositivos, notificações, Impressão Universal
  • Serviços Dynamics 365 Business Central
  • Serviços do Microsoft Partner Center

Para saber mais, confira os Principais serviços e recursos do Microsoft Graph.

Diagrama que mostra os principais recursos e relacionamentos que fazem parte do Microsoft Graph

O que você pode fazer com o Microsoft Graph?

Você pode usar o Microsoft Graph para criar experiências de acordo com o contexto exclusivo do usuário para ajudá-lo a ser mais produtivo. Imagine um aplicativo que...

  • Analisa sua próxima reunião e o ajuda a se preparar para ela ao fornecer informações de perfil dos participantes, incluindo os cargos e com quem eles trabalham, bem como informações sobre os documentos e projetos mais recentes nos quais eles estão colaborando.
  • Verifica seu calendário e sugere os horários recomendados para a próxima reunião de equipe.
  • Busca o gráfico de projeção mais recente das vendas de um arquivo do Excel em seu OneDrive e permite atualizar a previsão em tempo real, tudo em seu telefone.
  • Assina as alterações em seu calendário, envia um alerta quando você está gastando muito tempo em reuniões e fornece recomendações para aqueles que você pode perder ou delegar com base na relevância dos participantes para você.
  • Ajuda você a classificar informações pessoais e profissionais em seu telefone, por exemplo, categorizando imagens que devem seguir para seu OneDrive pessoal e recibos comerciais que devem seguir para seu OneDrive for Business.
  • Analisa os dados do Microsoft 365 em escala para que os tomadores de decisões possam desbloquear informações valiosas sobre os padrões de colaboração e a alocação de tempo que aumentam a produtividade do negócio.
  • Exibe dados personalizados de negócios para o Microsoft Graph, fazendo indexação para torná-los pesquisáveis juntamente com os dados dos serviços do Microsoft 365.

Escolha o primeiro cenário sobre a pesquisa de participantes da reunião como um exemplo. Com a API do Microsoft Graph, você pode:

  1. Obtenha os endereços de email dos participantes de um evento de reunião.
  2. Procure-os individualmente como um usuário no Microsoft Entra ID para obter suas informações de perfil.

Você pode navegar por outros recursos usando relações:

Para saber mais, consulte Padrões de integração.

O Microsoft Graph é protegido e somente chamadores autorizados podem acessar os dados. Para obter mais informações, consulte Autenticação e autorização.

Observação

Ao usar APIs do Microsoft Graph, você concorda com os Termos de Uso das APIs da Microsoft e com a Política de Privacidade da Microsoft.

Veja alguns desses cenários mais comuns para trabalhar com a API do Microsoft Graph. Os links levam você ao Explorador do Graph.

Operação URL
GET meu perfil https://graph.microsoft.com/v1.0/me
GET meus arquivos https://graph.microsoft.com/v1.0/me/drive/root/children
GET minha foto https://graph.microsoft.com/v1.0/me/photo/$value
GET meu email https://graph.microsoft.com/v1.0/me/messages
GET meu email de alta prioridade https://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20'high'
GET eventos do meu calendário https://graph.microsoft.com/v1.0/me/events
GET meu gerente https://graph.microsoft.com/v1.0/me/manager
GET o último usuário que modificou o arquivo foo.txt https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
GET Grupos do Microsoft 365 dos quais sou membro https://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a%20eq%20'unified')
GET os usuários em minha organização https://graph.microsoft.com/v1.0/users
GET grupos em minha organização https://graph.microsoft.com/v1.0/groups
GET as pessoas relacionadas a mim https://graph.microsoft.com/v1.0/me/people
Itens GET mais populares à minha volta https://graph.microsoft.com/beta/me/insights/trending
GET minhas anotações https://graph.microsoft.com/v1.0/me/onenote/notebooks

Trazer os dados de uma fonte de conteúdo externa para o Microsoft Graph

Use conectores do Copilot para trazer dados externos à nuvem da Microsoft para o Microsoft Graph. Exemplos desses dados podem ser um banco de dados de recursos humanos ou catálogo de produtos de uma organização, hospedados no local ou nas nuvens pública ou privada.

Os conectores do Copilot criam conexões com fontes de dados externas, indexam os dados e os armazenam como itens e arquivos personalizados externos. Depois de indexados, esses itens podem aparecer na Pesquisa da Microsoft e em aplicativos que usam a API de Pesquisa da Microsoft.

Acesse os dados do Microsoft Graph em escala

Use o Microsoft Graph Data Connect para acessar dados no Microsoft Graph em escala, permitindo aos administradores consentimento granular e controle total sobre seus dados do Microsoft Graph. A Conexão de Dados simplifica a entrega destes dados para o Microsoft Azure.

Ao usar ferramentas Azure, você pode então criar aplicativos inteligentes que:

  • Encontre o especialista no assunto mais próximo em sua organização.
  • Automatize a criação da base de conhecimento.
  • Analise as solicitações de reunião para fornecer informações sobre a utilização da sala de conferência.
  • Detecte fraudes com dados de produtividade e comunicação.

Quando devo usar a API do Microsoft Graph ou a Conexão de Dados?

O Microsoft Graph Data Connect permite que você interaja com os dados disponíveis por meio das APIs do Microsoft Graph. O Data Connect fornece ferramentas para simplificar a criação de aplicativos inteligentes, tudo dentro da nuvem da Microsoft.

Recurso API do Microsoft Graph Microsoft Graph Data Connect
Escopo de acesso Usuário único ou locatário inteiro Muitos usuários ou grupos
Padrão de acesso Tempo real Cronograma recorrente
Operações de dados Opera com base nos dados de origem Funciona em um cache dos dados
Proteção de dados Os dados são protegidos no serviço de origem, como Microsoft 365 e Microsoft Entra A proteção de dados é estendida ao cache dos dados em sua assinatura do Azure
Consentimento do usuário Self
Tipos de recursos
Nenhum
Consentimento do administrador Toda a organização
Tipos de recursos
Selecione grupos de usuários
Propriedades e tipos de recursos
Exclui usuários
Ferramentas de acesso Consultas da Web RESTful Azure Data Factory

Experimentar um aplicativo de exemplo

Use o início rápido para configurar um aplicativo de exemplo pronto para execução.