Comentários Editar

reportRoot: getOffice365ActivationsUserDetail

  • Artigo
  • 2 minutos para o fim da leitura

Namespace: microsoft.graph

Obter detalhes sobre usuários que ativaram Microsoft 365.

Observação: Para obter detalhes sobre diferentes exibições de relatório e nomes, consulte Microsoft 365 relatórios - Microsoft Office ativações.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegada (conta corporativa ou de estudante) Reports.Read.All
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo Reports.Read.All

Observação: para as permissões delegadas para permitir que os aplicativos leiam relatórios de uso do serviço em nome de um usuário, o administrador de locatários deve ter atribuído ao usuário a função de administrador limitada apropriada do Azure AD. Para obter mais detalhes, consulte Autorização para as APIs lerem os relatórios de uso do Microsoft 365.

Solicitação HTTP

GET /reports/getOffice365ActivationsUserDetail

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório.
If-None-Match Se esse cabeçalho de solicitação estiver incluso e a eTag fornecida corresponder à marca atual do arquivo, um código de resposta 304 Not Modified será exibido. Opcional.

Resposta

Se for bem-sucedido, este método retorna uma resposta 302 Found que redireciona para uma URL de download pré-autenticada para o relatório. Essa URL pode ser encontrada no cabeçalho Location na resposta.

As URLs de download previamente autenticadas são válidas apenas por um curto período de tempo (alguns minutos) e não exigem um cabeçalho Authorization.

O arquivo CSV possui os seguintes cabeçalhos para colunas.

  • Data de atualização do relatório
  • Nome UPN
  • Nome de exibição
  • Tipo de produto
  • Data da última ativação
  • Windows
  • Mac
  • Windows 10 Mobile
  • iOS
  • Android
  • Ativado no computador compartilhado

Exemplo

Solicitação

Este é um exemplo de solicitação.

GET https://graph.microsoft.com/v1.0/reports/getOffice365ActivationsUserDetail

Resposta

Este é um exemplo de resposta.

HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe

Siga o redirecionamento 302 e o arquivo CSV baixado terá o seguinte esquema.

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer