Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Obtenha a tendência no número de usuários ativos. Um usuário será considerado ativo se tiver executado uma atividade de arquivo (salvar, sincronizar, modificar ou compartilhar) ou visitado uma página dentro do período especificado.
Observação: Para obter detalhes sobre diferentes visualizações e nomes de relatório, consulte Relatórios do Microsoft 365 - atividade do SharePoint.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegada (conta corporativa ou de estudante) | Reports.Read.All | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | Reports.Read.All | Indisponível. |
Observação: para permissões delegadas para permitir que os aplicativos leiam relatórios de uso do serviço em nome de um usuário, o administrador do locatário deve ter atribuído ao usuário a função de administrador limitada do Microsoft Entra apropriada. Para obter mais informações, consulte Autorização para APIs lerem relatórios de uso do Microsoft 365.
Solicitação HTTP
GET /reports/getSharePointActivityUserCounts(period='{period_value}')
Parâmetros de função
Na URL da solicitação, forneça um valor válido ao seguinte parâmetro.
| 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 Dn, em que n representa o número de dias em que o relatório é agregado. Obrigatório. |
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| If-None-Match | Se este 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 pré-autenticadas são válidas apenas por um curto período de tempo (alguns minutos) e não exigem um Authorization cabeçalho.
O arquivo CSV possui os seguintes cabeçalhos para colunas.
- Data de atualização do relatório
- Página visitada
- Exibidos ou editados
- Sincronizados
- Compartilhados internamente
- Compartilhados externamente
- Data do relatório
- Período de Relatório
Exemplo
Solicitação
Veja um exemplo da solicitação.
GET https://graph.microsoft.com/v1.0/reports/getSharePointActivityUserCounts(period='D7')
Resposta
Veja 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 que é baixado tem o esquema a seguir.
HTTP/1.1 200 OK
Content-Type: application/octet-stream
Report Refresh Date,Visited Page,Viewed Or Edited,Synced,Shared Internally,Shared Externally,Report Date,Report Period