Visão geral do Microsoft GraphOverview of Microsoft Graph

O Microsoft Graph é o gateway para dados e inteligência no Microsoft 365.Microsoft Graph is the gateway to data and intelligence in Microsoft 365. Ele fornece um modelo de programabilidade unificada que você pode usar para acessar a grande quantidade de dados disponíveis no Office 365, no Windows 10 e no Enterprise Mobility + Security.It provides a unified programmability model that you can use to access the tremendous amount of data in Office 365, Windows 10, and Enterprise Mobility + Security. Você pode usar a grande quantidade de dados no Microsoft Graph para criar aplicativos para organizações e clientes que interagem com milhões de usuários.Use the wealth of data in Microsoft Graph to build apps for organizations and consumers that interact with millions of users.

Alimentar a plataforma do Microsoft 365Powering the Microsoft 365 platform

O Microsoft Graph, Microsoft Graph Data Connect e Microsoft Graph Connectors permitem ampliar as experiências Microsoft 365 e desenvolver aplicativos inteligentes.

Na plataforma do Microsoft 365, três componentes principais facilitam o acesso e o fluxo de dados:In the Microsoft 365 platform, three main components facilitate the access and flow of data:

  • A API do Microsoft Graph oferece um único ponto de extremidade, https://graph.microsoft.com, para fornecer acesso a dados avançados focados nas pessoas, e informações expostas como recursos dos serviços do Microsoft 365.The Microsoft Graph API offers a single endpoint, https://graph.microsoft.com, to provide access to rich, people-centric data and insights exposed as resources of Microsoft 365 services. Você pode usar as APIs REST ou SDKs para acessar o ponto de extremidade e desenvolver aplicativos compatíveis com cenários que abrangem a produtividade, colaboração, educação, segurança, identidade, acesso, gerenciamento de dispositivo e muito mais.You can use REST APIs or SDKs to access the endpoint and build apps that support scenarios spanning across productivity, collaboration, education, security, identity, access, device management, and much more.
  • Os Conectores do Microsoft Graph (versão prévia) funcionam na direção de entrada, fornecendo dados externos à nuvem da Microsoft para os aplicativos e serviços do Microsoft Graph a fim de aprimorar as experiências do Microsoft 365, como a Pesquisa da Microsoft.Microsoft Graph connectors (preview) work in the incoming direction, delivering data external to the Microsoft cloud into Microsoft Graph services and applications, to enhance Microsoft 365 experiences such as Microsoft Search.
  • Microsoft Graph Data Connect fornece um conjunto de ferramentas para simplificar entrega segura e escalonável de dados do Microsoft Graph para repositórios populares de dados do Azure.Microsoft Graph data connect provides a set of tools to streamline secure and scalable delivery of Microsoft Graph data to popular Azure data stores. Esses dados armazenados em cache servem como fontes de dados para ferramentas de desenvolvimento do Azure que você pode usar para desenvolver aplicativos inteligentes.This cached data serves as data sources for Azure development tools that you can use to build intelligent applications.

Juntos, a API do Microsoft Graph Data, os conectores (versão prévia) e os dados alimentam a plataforma do Microsoft 365.Together, the Microsoft Graph API, connectors (preview), and data connect power the Microsoft 365 platform. Com a capacidade de acessar dados e outros conjuntos de dados do Microsoft Graph para gerar informação e análise, você pode ampliar as experiências Microsoft 365 ou desenvolver aplicativos exclusivos e inteligentes.With the ability to access Microsoft Graph data and other datasets to derive insights and analytics, you can extend Microsoft 365 experiences, or build unique, intelligent applications.

Observação

Os conectores do Microsoft Graph estão em versão prévia.Microsoft Graph connectors is in preview. Para saber mais sobre a versão prévia, confira versão prévia de conectores.To learn more about the preview, see connectors preview. Para participar da versão prévia, primeiro você deve enviar o formulário de inscrição na versão prévia dos conectores do Microsoft Graph.To participate in the preview, you must first submit the Microsoft Graph connectors preview signup form.

Serviços do Microsoft GraphWhat's in Microsoft Graph?

O Microsoft Graph expõe as APIs REST e bibliotecas do cliente para acessar dados nos seguintes serviços Microsoft 365:Microsoft Graph exposes REST APIs and client libraries to access data on the following Microsoft 365 services:

  • Serviços Office 365: Delve, Excel, Microsoft Bookings, Microsoft Teams, OneDrive, OneNote, Outlook/Exchange, Planner, e SharePointOffice 365 services: Delve, Excel, Microsoft Bookings, Microsoft Teams, OneDrive, OneNote, Outlook/Exchange, Planner, and SharePoint
  • Serviços Enterprise Mobility e Security: Advanced Threat Analytics, Advanced Threat Protection, Azure Active Directory, Identity Manager, e IntuneEnterprise Mobility and Security services: Advanced Threat Analytics, Advanced Threat Protection, Azure Active Directory, Identity Manager, and Intune
  • Serviços do Windows 10: atividades, dispositivos e notificaçõesWindows 10 services: activities, devices, notifications
  • Dynamics 365 Business CentralDynamics 365 Business Central

Para saber mais, confira os Principais serviços e recursos do Microsoft Graph.To find out more, see Major services and features in Microsoft Graph.

Uma imagem mostrando os recursos principais e as relações que fazem parte do gráfico

O que você pode fazer com o Microsoft Graph?What can you do with 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.Use Microsoft Graph to build experiences around the user's unique context to help them be more productive. Imagine um aplicativo que...Imagine an app that...

  • 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.Looks at your next meeting and helps you prepare for it by providing profile information for attendees, including their job titles and managers, as well as information about the latest documents they're working on, and people they're collaborating with.
  • Verifica seu calendário e sugere os horários recomendados para a próxima reunião de equipe.Scans your calendar, and suggests the best times for the next team meeting.
  • 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.Fetches the latest sales projection chart from an Excel file in your OneDrive and lets you update the forecast in real time, all from your phone.
  • Assina alterações em seu calendário, envia um alerta quando você está gastando muito tempo em reuniões e oferece recomendações sobre as que você pode perder ou delegar com base na relevância dos participantes para você.Subscribes to changes in your calendar, sends you an alert when you’re spending too much time in meetings, and provides recommendations for the ones you can miss or delegate based on how relevant the attendees are to you.
  • 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.Helps you sort out personal and work information on your phone; for example, by categorizing pictures that should go to your personal OneDrive and business receipts that should go to your OneDrive for Business.
  • Analisa os dados do Office 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.Analyzes at-scale Office 365 data so that decision makers can unlock valuable insights into time allocation and collaboration patterns that improve business productivity.
  • 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.Brings custom business data into Microsoft Graph, indexing it to make it searchable along with data from Microsoft 365 services.

Escolha o primeiro cenário sobre a pesquisa de participantes da reunião como um exemplo.Pick the first scenario about researching meeting attendees as an example. Com a API do Microsoft Graph, você pode:With the Microsoft Graph API, you can:

  1. Obtenha os endereços de email dos participantes de um evento de reunião.Get the email addresses of the meeting event attendees.
  2. Faça a pesquisa individualmente como um usuário no Azure Active Directory para obter as informações de perfil.Look them up individually as a user in Azure Active Directory to get their profile information.

Você pode navegar por outros recursos usando relações:You can then navigate to other resources using relationships:

Microsoft Graph continua a abrir a plataforma Microsoft 365 para os desenvolvedores, e sempre somente com as permissões apropriadas.Microsoft Graph continues to open up the Microsoft 365 platform for developers, and always only with the appropriate permissions.

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.When you use the Microsoft Graph API, you agree to the Microsoft APIs Terms of Use and the Microsoft Privacy Statement.

Veja alguns desses cenários mais comuns para trabalhar com a API do Microsoft Graph.Check out some of these common scenarios for working with the Microsoft Graph API. Os links levam você ao Explorador do Graph.The links take you to the Graph Explorer.

OperaçãoOperation URLURL
GET meu perfilGET my profile https://graph.microsoft.com/v1.0/me
GET meus arquivosGET my files https://graph.microsoft.com/v1.0/me/drive/root/children
GET minha fotoGET my photo https://graph.microsoft.com/v1.0/me/photo/$value
GET meu emailGET my mail https://graph.microsoft.com/v1.0/me/messages
GET meu email de alta prioridadeGET my high importance email https://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20'high'
GET eventos do meu calendárioGET my calendar events https://graph.microsoft.com/v1.0/me/events
GET meu gerenteGET my manager https://graph.microsoft.com/v1.0/me/manager
GET o último usuário que modificou o arquivo foo.txtGET last user to modify file foo.txt https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
GET grupos do Office365 dos quais eu sou membroGET Office365 groups I’m member of 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çãoGET users in my organization https://graph.microsoft.com/v1.0/users
GET grupos em minha organizaçãoGET groups in my organization https://graph.microsoft.com/v1.0/groups
GET as pessoas relacionadas a mimGET people related to me https://graph.microsoft.com/v1.0/me/people
Itens GET mais populares à minha voltaGET items trending around me https://graph.microsoft.com/beta/me/insights/trending
GET minhas anotaçõesGET my notes https://graph.microsoft.com/v1.0/me/onenote/notebooks

Reunir dados de uma fonte de conteúdo externo para o Microsoft Graph (versão prévia)Bring data from an external content source to Microsoft Graph (preview)

Use os conectores do Microsoft Graph para reunir dados externos à nuvem da Microsoft para o Microsoft Graph.Use Microsoft Graph connectors to bring data that is external to the Microsoft cloud into 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.Examples of such data can be an organization's human resources database or product catalog, hosted on-premises or in the public or private clouds.

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.Microsoft Graph connectors create connections to external data sources, index the data, and store it as external custom items and files. Depois de indexar, é possível mostrar os itens na Pesquisa da Microsoft e nos aplicativos que usam o API da Pesquisa da Microsoft.Once indexed, those items can show up in Microsoft Search, and for apps that use the Microsoft Search API.

Acessar dados do Microsoft Graph em escala com conexão de dados do Microsoft GraphAccess Microsoft Graph data at scale using Microsoft Graph data connect

Use o Microsoft Graph Data Connect para acessar os dados em escala no Microsoft Graph, enquanto permite que os administradores tenham autorização granular e controle total sobre seus dados do Microsoft Graph.Use Microsoft Graph data connect to access data on Microsoft Graph at scale, while allowing administrators granular consent and full control over their Microsoft Graph data. Data Connect simplifica a entrega desses dados para o Microsoft Azure.Data connect streamlines the delivery of this data to Microsoft Azure.

Ao usar ferramentas Azure, você pode então criar aplicativos inteligentes que:Using Azure tools, you can then build intelligent apps that:

  • Encontram para você o especialista em um determinado tópico mais próximo em sua organizaçãoFind you the closest expert on a topic to you in your organization
  • Automatizam a criação de base de dados de conhecimentoAutomate knowledge base creation
  • Analisam solicitações de reunião para fornecer insights sobre o uso de sala de conferênciaAnalyze meeting requests to provide insights into conference room utilization
  • Detectam fraudes envolvendo dados de comunicação e de produtividadeDetect fraud with productivity and communication data

Por que usar a API do Microsoft Graph ou o Data Connect?When should I use Microsoft Graph API or data connect?

O Microsoft Graph Data Connect fornece uma nova maneira de interagir com os dados disponíveis por meio de APIs do Microsoft Graph.Microsoft Graph data connect provides a new way for you to interact with the data that's available through Microsoft Graph APIs. Data Connect fornece um conjunto exclusivo de ferramentas que facilitam o desenvolvimento de aplicativos inteligentes, tudo isso na nuvem da Microsoft.Data connect provides a unique set of tools that streamline the building of intelligent applications, all within the Microsoft cloud.

RecursoFeature API do Microsoft GraphMicrosoft Graph API Microsoft Graph Data ConnectMicrosoft Graph data connect
Escopo de acessoAccess scope Usuário único ou locatário inteiroSingle user or entire tenant Muitos usuários ou gruposMany users or groups
Padrão de acessoAccess pattern Tempo realReal time Cronograma recorrenteRecurrent schedule
Operações de dadosData operations Funciona em mestre de dadosOperates on data master Funciona em um cache dos dadosOperates on a cache of the data
Proteção de dadosData protection Os dados são protegidos enquanto estão no Microsoft 365Data is protected while in Microsoft 365 A proteção de dados é estendida ao cache dos dados em sua assinatura do AzureData protection is extended to the cache of data in your Azure subscription
Consentimento do usuárioUser consent SelfSelf
Tipos de recursosResource types
NenhumNone
Consentimento do administradorAdmin consent Toda a organizaçãoEntire organization
Tipos de recursosResource types
Selecione grupos de usuáriosSelect groups of users
Propriedades e tipos de recursosResource types and properties
Exclui usuáriosExcludes users
Ferramentas de acessoAccess tools Consultas da Web RESTfulRESTful web queries Azure Data FactoryAzure Data Factory

Para obter mais informações, consulte Microsoft Graph Data Connect, e Introdução ao Microsoft Graph Data Connect.See Microsoft Graph data connect for more information, and get started using Microsoft Graph data connect.

Próximas etapasNext steps