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 uma coleção de recursos itemActivityStats para as atividades que ocorreram neste recurso dentro do intervalo de tempo especificado.
Nota: O recurso itemAnalytics ainda não está disponível em todas as implementações nacionais.
Os agregados de análise podem não estar disponíveis para todos os tipos de ações.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Files.Read | Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | Files.Read.All | Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
Solicitação HTTP
GET /drives/{drive-id}/items/{item-id}/getActivitiesByInterval(startDateTime={startDateTime},endDateTime={endDateTime},interval={interval})
GET /sites/{site-id}/getActivitiesByInterval(startDateTime={startDateTime},endDateTime={endDateTime},interval={interval})
GET /sites/{site-id}/lists/{list-id}/items/{item-id}/getActivitiesByInterval(startDateTime={startDateTime},endDateTime={endDateTime},interval={interval})
Parâmetros de função
| Parâmetro | Tipo | Descrição |
|---|---|---|
| startDateTime | cadeia (carimbo de data/hora) | A hora de início sobre a qual agregar atividades. |
| endDateTime | cadeia (carimbo de data/hora) | A hora de fim para agregar atividades. |
| interval | string | O intervalo de agregação. |
Nota: Esta API só suporta um intervalo de tempo de 90 dias para contagens diárias. O valor dos
startDateTimeparâmetros eendDateTimetem de representar um intervalo de tempo inferior a 90 dias.
Parâmetros de consulta opcionais
Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | Portador {código}. Obrigatório. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e uma coleção de objeto itemActivityStats no corpo da resposta.
Exemplo
Solicitação
GET /drives/{drive-id}/items/{item-id}/getActivitiesByInterval(startDateTime='2017-01-01',endDateTime='2017-01-3',interval='day')
Resposta
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"startDateTime": "2017-01-01T00:00:00.000Z",
"endDateTime": "2017-01-02T00:00:00.000Z",
"delete": {
"actionCount": 1,
"actorCount": 1
},
"access": {
"actionCount": 5,
"actorCount": 3
}
},
{
"startDateTime": "2017-01-02T00:00:00.000Z",
"endDateTime": "2017-01-03T00:00:00.000Z",
"edit": {
"actionCount": 3,
"actorCount": 1
},
"access": {
"actionCount": 7,
"actorCount": 6
}
}
]
}