O relatório de uso do usuário retorna as informações de uso do serviço do Google Workspace de um usuário específico no seu domínio. Esses relatórios podem ser personalizados e filtrados por informações de uso específico. O período padrão e máximo de cada relatório são os últimos 450 dias.
Esses relatórios de uso do usuário só podem ser utilizados para fins legais, de acordo com o Contrato do Cliente. Esses relatórios também se aplicam ao Google Workspace e ao Google Workspace for Education.
Recuperar todas as atividades de uso do usuário
Para recuperar um relatório de todas as atividades do usuário na sua conta, use a seguinte solicitação HTTP GET e inclua o token de autorização descrito na documentação de autorização. Para facilitar a leitura, o exemplo a seguir é formatado com retornos de linha:
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
O valor dates é a data em que o uso ocorreu e o carimbo de data/hora está no formato ISO 8601, aaaa-mm-dd. Para mais informações sobre os parâmetros de string de consulta e as propriedades de resposta, consulte a Referência da API. Para mais informações sobre os parâmetros do relatório de uso do usuário, consulte a referência dos parâmetros de uso do usuário.
O exemplo a seguir gera um relatório sobre todas as atividades do usuário da conta.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?maxResults=2
O exemplo a seguir obtém um relatório sobre todas as atividades do usuário para uma conta de cliente específica.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?customerId=C03az79cb
O exemplo a seguir gera um relatório com os carimbos de data/hora do último login dos usuários na conta. Para conferir um exemplo de resposta da API, consulte o exemplo de resposta JSON.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&maxResults=2
O exemplo a seguir gera um relatório com os carimbos de data/hora do último login dos usuários na conta, filtrados pelos usuários que fizeram login após um horário específico. Para conferir um exemplo de resposta da API, consulte o exemplo de resposta JSON.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&filters=accounts:last_login_time >2010-10-28T10:26:35.000Z"
O exemplo a seguir gera um relatório com os carimbos de data/hora do último login e o status de suspensão dos usuários na conta. Para conferir um exemplo de resposta da API, consulte o exemplo de resposta JSON.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time,accounts:is_disabled"
Recuperar as atividades de uso de um usuário específico
Para recuperar um relatório das atividades de um usuário específico na sua conta, use a seguinte solicitação HTTP GET e inclua o token de autorização descrito na documentação de autorização. Para facilitar a leitura, o exemplo a seguir é formatado com retornos de linha.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/userKey/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
O userKey pode ser o endereço de e-mail principal do usuário no relatório ou o profileId exclusivo do Google Workspace. O valor dates é a data em que o uso ocorreu e o carimbo de data/hora está no formato ISO 8601, aaaa-mm-dd. Para mais informações sobre os parâmetros de string de consulta e as propriedades de resposta, consulte a Referência da API. Para mais informações sobre os parâmetros do relatório de uso do usuário, consulte a referência dos parâmetros de uso do usuário.
O exemplo a seguir exibe o relatório de uso de joao@example.com.
https://admin.googleapis.com/admin/reports/v1/usage/users/john@example.com/dates/2013-03-03
Exemplo de resposta JSON de relatório de uso
Uma resposta bem-sucedida retorna um código de status HTTP 200. Junto com o código de status, a resposta retorna um relatório.
Resposta JSON para o relatório do usuário
{
"kind": "reports#usageReports",
"warnings": [
{
"code": warning machine-readable code,
"message": warning human-readable message,
"data": [
{
"key": key for key-value pair that gives detailed warning information,
"value": value for key-value pair giving detailed warning information
}
]
}
],
"nextPageToken": "N:NNN:NNN:N:C03az79cb",
"usageReports": [
{
"kind": "usageReport",
"date": "2013-03-03",
"entity": {
"type": "USER",
"customerId": "C03az79cb",
"userEmail": "liz@example.com",
"profileId": "user's unique Google Workspace ID"
},
"parameters": [
{
"name": "accounts:is_disabled",
"boolValue": false
},
{
"name": "accounts:disabled_reason",
"stringValue": "reason description"
},
{
"name": "accounts:first_name",
"stringValue": "Liz"
},
{
"name": "accounts:is_2sv_enforced",
"boolValue": false
},
{
"name": "accounts:is_2sv_enrolled",
"boolValue": false
},
{
"name": "accounts:last_name",
"stringValue": "Smith"
},
{
"name": "accounts:creation_time",
"datetimeValue": "2010-10-28T10:26:35.000Z"
},
{
"name": "accounts:last_login_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
},
{
"name": "accounts:last_sso_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
}
]
}
]
}