Obter activityStatisticsGet activityStatistics

Importante

As /beta APIs na versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported.

Obter as propriedades de um objeto activityStatistics para um usuário.Get the properties of an activityStatistics object for a user.

Você pode obter as propriedades de um tipo de activityStatistics para o usuário especificado e o intervalo de datas.You can get the properties of a type of activityStatistics for the specified user and date range. Você pode especificar o tipo de estatísticas e o intervalo de datas usando o formato com suporte da Propriedade Activity ID para id na consulta.You can specify the type of statistics and date range by using the supported format of the activity id property for id in the query.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Analytics.ReadAnalytics.Read
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Sem suporte.Not supported.

Solicitação HTTPHTTP request

GET /me/analytics/activitystatistics/{id}
GET /users/{id|userPrincipalName}/analytics/activitystatistics/{id}

Parâmetros de consulta opcionaisOptional query parameters

Este método não oferece suporte a parâmetros de consulta opcionais para personalizar a resposta.This method does not support optional query parameters to customize the response.

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization Portador {token}Bearer {token}

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se tiver êxito, este método retornará 200 OK um código de resposta e o tipo solicitado de estatísticas de atividade, que é um dos seguintes recursos derivados de ActivityStatistics: {Call, chat, email, Focus, e reunião}.If successful, this method returns a 200 OK response code and the requested type of activity statistics, which is one of the following resources derived from activityStatistics:{Call, Chat, Email, Focus, and Meeting}.

ExemploExample

SolicitaçãoRequest

O exemplo a seguir solicita estatísticas do tipo emailActivityStatistics do usuário conectado, para o intervalo de datas entre 2019-06-16 e 2019-06-17.The following example requests statistics of the type emailActivityStatistics of the signed-in user, for the date range between 2019-06-16 and 2019-06-17. Para obter mais informações sobre o formato de propriedade de ID geral, consulte Activity ID Property.For more information about the general id property format, see activity id property.

GET https://graph.microsoft.com/beta/me/analytics/activitystatistics/email_2019-06-16_2019-06-17

RespostaResponse

Veja a seguir um exemplo da resposta que obtém as estatísticas de atividade de um usuário conectado para uma atividade e um dia específicos.The following is an example of the response that gets activity statistics of a signed-in user for a specific activity and day.

HTTP/1.1 200 OK

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#activitystatistics/$entity",
    "@odata.type": "#microsoft.graph.emailActivityStatistics",
    "activity": "Email",
    "startDate": "2019-06-16",
    "endDate": "2019-06-17",
    "id": "email_2019-06-16_2019-06-17",
    "timeZoneUsed": "Pacific Standard Time",
    "duration": "PT0S",
    "afterHours": "PT0S",
    "readEmail": "PT0S",
    "sentEmail": "PT0S"
}