Comentários Editar

reportRoot: getSkypeForBusinessActivityUserDetail

  • Artigo
  • 3 minutos para o fim da leitura

Namespace: microsoft.graph

Obtenha dados sobre a atividade do Skype for Business por usuário.

Observação: para saber mais sobre diferentes visualizações e nomes de relatórios, confira Relatórios do Microsoft 365 - Atividade do Skype for Business.

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/getSkypeForBusinessActivityUserDetail(period='{period_value}')
GET /reports/getSkypeForBusinessActivityUserDetail(date={date_value})

Parâmetros de função

Na URL da solicitação, forneça um valor válido a um dos seguintes parâmetros.

Parâmetro Tipo Descrição
ponto cadeia de caracteres Especifica o período de tempo durante o qual o relatório é agregado. Os valores com suporte para {period_value} são: D7, D30, D90 e D180. Eles seguem o formato D n, em que n representa o número de dias em que o relatório é agregado.
data Data Especifica a data para a qual você deseja visualizar os usuários que realizaram qualquer atividade. {date_value} deve ter um formato de AAAA-MM-DD. Como este relatório está disponível apenas para os últimos 30 dias, {date_value} deve ser uma data desse intervalo.

Observação: você precisa definir o período ou data na URL.

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
  • Excluído
  • Data de exclusão
  • Data da última atividade
  • Contagem total de sessão de ponto a ponto
  • Contagem total de conferência organizada
  • Contagem total de conferência participada
  • Data da última atividade ponto a ponto
  • Data da última atividade da conferência organizada
  • Data da última atividade da conferência participada
  • Contagem de mensagens instantâneas ponto a ponto
  • Contagem de áudios ponto a ponto
  • Minutos de áudios ponto a ponto
  • Contagem de vídeos ponto a ponto
  • Minutos de vídeos ponto a ponto
  • Contagem de compartilhamentos de aplicativos ponto a ponto
  • Contagem de transferências de arquivos ponto a ponto
  • Contagem de mensagens instantâneas em conferência organizada
  • Contagem de áudios/vídeos em conferência organizada
  • Minutos de áudios/vídeos em conferência organizada
  • Contagem de compartilhamentos de aplicativos em conferência organizada
  • Contagem de Web em conferência organizada
  • Contagem de chamadas dial-in/out por terceiros em conferência organizada
  • Contagem de chamadas dial-in/out pela Microsoft em conferência organizada
  • Minutos de chamadas dial-in pela Microsoft em conferência organizada
  • Minutos de chamadas dial-out pela Microsoft em conferência organizada
  • Contagem de IMs de Conferências Participadas
  • Contagem de áudios/vídeos em conferência participada
  • Minutos de áudios/vídeos em conferência participada
  • Contagem de compartilhamentos de aplicativos em conferência participada
  • Contagem de Web em conferência participada
  • Contagem de chamadas dial-in/out por terceiros em conferência participada
  • Produtos Atribuídos
  • Período de Relatório

Exemplo

Solicitação

Este é um exemplo de solicitação.

GET https://graph.microsoft.com/v1.0/reports/getSkypeForBusinessActivityUserDetail(period='D7')

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,Is Deleted,Deleted Date,Last Activity Date,Total Peer-to-peer Session Count,Total Organized Conference Count,Total Participated Conference Count,Peer-to-peer Last Activity Date,Organized Conference Last Activity Date,Participated Conference Last Activity Date,Peer-to-peer IM Count,Peer-to-peer Audio Count,Peer-to-peer Audio Minutes,Peer-to-peer Video Count,Peer-to-peer Video Minutes,Peer-to-peer App Sharing Count,Peer-to-peer File Transfer Count,Organized Conference IM Count,Organized Conference Audio/Video Count,Organized Conference Audio/Video Minutes,Organized Conference App Sharing Count,Organized Conference Web Count,Organized Conference Dial-in/out 3rd Party Count,Organized Conference Dial-in/out Microsoft Count,Organized Conference Dial-in Microsoft Minutes,Organized Conference Dial-out Microsoft Minutes,Participated Conference IM Count,Participated Conference Audio/Video Count,Participated Conference Audio/Video Minutes,Participated Conference App Sharing Count,Participated Conference Web Count,Participated Conference Dial-in/out 3rd Party Count,Assigned Products,Report Period