El informe de uso del usuario muestra la información de uso del servicio de Google Workspace de un usuario determinado del dominio. Estos informes se pueden personalizar y filtrar para obtener información de uso específica. El período predeterminado y máximo de cada informe comprende los últimos 450 días.
Estos informes de uso de usuarios solo se podrán utilizar con fines legales de acuerdo con el Acuerdo de cliente. Y estos informes se aplican a Google Workspace y Education.
Recuperar todas las actividades de uso de los usuarios
Para recuperar un informe de todas las actividades del usuario en tu cuenta, usa la siguiente solicitud HTTP GET e incluye el token de autorización descrito en la documentación de autorización. Para facilitar la lectura, el siguiente ejemplo tiene formato con saltos de línea:
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
El valor dates es la fecha en la que se produjo el uso y la marca de tiempo tiene el formato ISO 8601, aaaa-mm-dd. Para obtener más información sobre los parámetros de las strings de consulta y las propiedades de respuesta, consulte la Referencia de la API. Para obtener información sobre los parámetros del informe de uso de los usuarios, consulta la referencia de los parámetros de uso de los usuarios.
En el siguiente ejemplo, se obtiene un informe de todas las actividades del usuario para la cuenta.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?maxResults=2
En el siguiente ejemplo, se obtiene un informe de todas las actividades del usuario para una cuenta de cliente específica.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?customerId=C03az79cb
En el siguiente ejemplo, se obtiene un informe de las marcas de tiempo del último acceso de los usuarios de la cuenta. Para ver un ejemplo de una respuesta de la API, consulta el ejemplo de respuesta de JSON.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&maxResults=2
En el siguiente ejemplo, se obtiene un informe de las marcas de tiempo del último acceso de los usuarios de la cuenta, filtrado por los usuarios que accedieron después de una hora específica. Para ver un ejemplo de una respuesta de la API, consulta el ejemplo de respuesta de 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"
En el siguiente ejemplo, se obtiene un informe de las marcas de tiempo del último acceso y la suspensión de los usuarios de la cuenta. Para ver un ejemplo de una respuesta de la API, consulta el ejemplo de respuesta de 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 las actividades de uso de un usuario específico
Para recuperar un informe de las actividades de un usuario específico en tu cuenta, utiliza la siguiente solicitud HTTP GET e incluye el token de autorización descrito en la documentación de autorización. Para facilitar la lectura, el siguiente ejemplo tiene formato con saltos de línea.
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
El elemento userKey puede ser la dirección de correo electrónico principal del usuario que aparece en el informe o el archivo profileId de Google Workspace único del usuario. El valor dates es la fecha en la que se produjo el uso y la marca de tiempo tiene el formato ISO 8601, aaaa-mm-dd. Para obtener más información sobre los parámetros de las strings de consulta y las propiedades de respuesta, consulte la Referencia de la API. Para obtener información sobre los parámetros del informe de uso de los usuarios, consulta la referencia de los parámetros de uso de los usuarios.
En el siguiente ejemplo, se obtiene el informe de uso de juan@ejemplo.com.
https://admin.googleapis.com/admin/reports/v1/usage/users/john@example.com/dates/2013-03-03
Respuesta JSON de ejemplo del informe de uso
Una respuesta correcta muestra un código de estado HTTP 200. Junto con el código de estado, la respuesta muestra un informe.
Respuesta JSON para el informe del usuario
{
"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"
}
]
}
]
}