Visão Geral do Microsoft Graph

O Microsoft Graph é o gateway para dados e inteligência no Microsoft 365. Ele fornece um modelo de programação unificado que você pode usar para acessar a enorme quantidade de dados no Microsoft 365, Windows e Enterprise Mobility + Security. 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.

Os conectores do Microsoft Graph, do Microsoft Graph Data Connect e do Microsoft Graph permitem estender as experiências do Microsoft 365 e criar aplicativos inteligentes.

Dados e serviços que impulsionam a plataforma Microsoft 365

Na plataforma Microsoft 365, três componentes principais facilitam 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. Você pode usar APIs REST ou SDKs para acessar o endpoint e criar aplicativos que oferecem suporte a cenários do Microsoft 365, abrangendo produtividade, colaboração, educação, inteligência de pessoas e local de trabalho e 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.
  • Conectores do Microsoft Graph trabalham na direção de entrada, entregando dados externos à nuvem da Microsoft para os 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, Delve, Excel, Microsoft 365 compliance eDiscovery, Microsoft Search, OneDrive, OneNote, Outlook/Exchange, Pessoas (contatos do Outlook), Planner, SharePoint, Teams, To Do, Viva Insights
  • Enterprise Mobility + Security serviços: Análise Avançada de Ameaças, Proteção Avançada contra Ameaças, Microsoft Entra ID, Identity Manager e Intune
  • Serviços do Windows: atividades, dispositivos, notificações, Impressão Universal
  • Serviços Dynamics 365 Business Central

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

Uma imagem mostrando 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, confira Padrões de integração.

Microsoft Graph continua a abrir a plataforma Microsoft 365 para os desenvolvedores, e sempre somente com as permissões apropriadas.

Observação

Ao usar a API do Microsoft Graph, você concorda com os Termos de Uso das APIs da Microsoft e com a Declaração 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 os conectores do Microsoft Graph para reunir 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 Microsoft Graph criam conexões a fontes de dados externas, indexam os dados e os armazenam como arquivos e itens 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 mais próximo de você em um tópico 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?

Microsoft Graph Data Connect fornece uma nova maneira de interagir com os dados que estão disponíveis através das APIs do Microsoft Graph. A Conexão de Dados fornece um conjunto exclusivo de ferramentas que simplificam o desenvolvimento 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 Funciona em mestre de dados Funciona em um cache dos dados
Proteção de dados Os dados são protegidos enquanto estão no Microsoft 365 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