Visão geral da API de relatórios do Microsoft GraphMicrosoft Graph reports API overview

A API de relatórios do Microsoft Graph permite entender as atividades de aplicativos e recursos no seu locatário no Azure Active Directory.The reports API in Microsoft Graph enable you to understand application and resource activity in your Azure Active Directory tenant.

Por que usar a API de relatórios?Why use the reports API?

Integre os relatórios de uso do Microsoft 365 à solução de relatórios existente na sua organizaçãoIntegrate Microsoft 365 usage reporting into your organization's existing reporting solution

Muitas empresas têm soluções de relatório existentes que utilizam um aplicativo ou o portal da Web para gerar relatórios.Many companies have existing reporting solutions that use a reporting application or web portal. Você pode usar a API de relatórios para incorporar os dados de uso do Microsoft 365 à solução de relatórios existente na sua organização, para que todos os relatórios do serviço de TI estejam em um único local.You can use the reports API to incorporate Microsoft 365 usage data into your organization's existing reporting solution so that all IT service reports are in a unified location.

Reter relatórios de uso para análise de históricoRetain usage reports for historical analysis

Você pode usar a API de relatórios para obter os dados que estão disponíveis em todos os relatórios de uso, incluindo resumos no nível da organização de acordo com o serviço, informações de uso no nível da entidade (usuários, sites, contas) para os últimos 7/30/90/180 dias e agregações de atividades diárias.You can use the reports API to get the data that's available in all usage reports, including organization-level summaries per service, entity-level (user, sites, accounts) usage information for the last 7/30/90/180 days, and daily activity aggregates. Isso permite que você mantenha informações de uso históricas por quanto tempo precisar.This gives you the option to keep historical usage information for as long as required.

Analisar atividade e configuração de aplicativos do AD FSAnalize AD FS application activity and configuration

Fornece informações sobre uma terceira parte confiável configurada com os Serviços de Federação do Active Directory (AD FS), seu uso agregado e se a configuração da terceira parte confiável pode ser migrada para o Azure Active Directory.Provides information about a relying party configured with Active Directory Federation Services (AD FS), its aggregated usage, and whether the relying party configuration can be migrated to Azure Active Directory.

Monitorar logins de aplicativosMonitor application sign-ins

Monitore o uso dos seus aplicativos e tome decisões sobre os padrões de uso.Monitor the usage of your applications and make decisions about usage patterns.

Defina quem está usando seus aplicativos e como eles os estão usandoDetermine who is using your applications and how are they using them

Os relatórios de uso dos métodos de autenticação ajudam a entender como os usuários da sua organização utilizam os recursos do Azure Active Directory (Azure AD), como descanso de senha de autoatendimento e autenticação multifatorial (MFA).The authentication methods usage reports help you understand how users in your organization use Azure Active Directory (Azure AD) capabilities, such as self-service password rest and multi-factor authentication (MFA). Esses relatórios ajudam a determinar quais métodos de autenticação são mais bem-sucedidos para sua organização, quais tipos de erros os usuários finais estão enfrentando e qual a campanha que você precisa executar para ajudar seus usuários finais a adotar o uso de descanso por senha de autoatendimento e MFA.These reports help you determine which authentication methods are more successful for your organization, what types of errors end users are running into, and hat campaign you need to run to help your end users adopt the use of self-service password rest and MFA.

Monitorar a atividade em um locatário do Microsoft Azure Active DirectoryMonitor activity on an Azure AD tenant

Entenda melhor como seus usuários acessam e utilizam os serviços do Microsoft Azure Active Directory.Gain a better understanding of how your users access and use Azure AD services. Você pode analisar os dados para criar soluções personalizadas adaptadas às necessidades específicas da sua organização.You can analyze the data to create custom solutions tailored to your organization's specific needs.

Quais dados eu posso acessar usando as APIs de relatórios?What data can I access by using the reports APIs?

Você pode utilizar as APIs de relatórios para acessar os conjuntos de dados listados na tabela a seguir.You can use the reports APIs to access the data sets listed in the following table.

| APIs de relatóriosReports APIs | Conjunto de dadosData set | |:------------:------------ |:--------:-------- | |:------------ |:-------- | | AtividadeActivity | Auditoria de diretórioDirectory audit
EntrarSign-in
Provisionamento (Visualização)Provisioning (Preview) | | Aplicativos AD FSAD FS applications | Resumo detalhado da parte de confiança (Visualização)Relying part detailed summary (Preview) | | Registro de aplicativoApplication registration | Contagem da credencial de registro de usuário (Visualização)Credential user registration count (Preview)
Detalhes da credencial de registro de usuário (Visualização)Credential user registration details (Preview)
Detalhes de utilização da credencial do usuário (Visualização)User credential usage details (Preview)
Resumo de utilização da credencial (Visualização)Credential usage summary (Preview)| | Entrar no aplicativoApplication sign-in | Resumo da entrada (Visualização)Sign-in summary (Preview)
Detalhes da entrada (Visualização)Sign-in details (Preview)| | Microsoft TeamsMicrosoft Teams | Uso do dispositivoDevice usage
Atividades do usuárioUser activity | | Microsoft 365 (geral)Microsoft 365 (general) | AtivaçõesActivations
Usuários ativosActive users
Atividades de gruposGroups activity | | OneDriveOneDrive | AtividadesActivity
UsoUsage | | OutlookOutlook | AtividadesActivity
Uso do aplicativoApp usage
Uso de caixa de correioMailbox usage | | SharePointSharePoint | AtividadesActivity
Uso do siteSite usage | | Skype for BusinessSkype for Business | AtividadesActivity
Uso do dispositivoDevice usage
Uso do dispositivoDevice usage
Atividades dos participantesParticipant activity
Atividades de ponto a pontoPeer to peer activity | | YammerYammer | AtividadesActivity
Uso do dispositivoDevice usage
Atividades de gruposGroups activity |

Referência da APIAPI reference

Está procurando a referência de API para esse serviço?Looking for the API reference for this service?

Próximas etapasNext steps