- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébalo
Recupera un informe que es una colección de propiedades y estadísticas para un conjunto de usuarios con la cuenta. Para obtener más información, consulta la Guía del informe de uso de los usuarios. Para obtener más información sobre los parámetros del informe de usuarios, consulta las guías de referencia de los parámetros de uso de los usuarios.
Solicitud HTTP
GET https://admin.googleapis.com/admin/reports/v1/usage/users/{userKey or all}/dates/{date}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
user |
Representa el ID de perfil o el correo electrónico del usuario para el que se deben filtrar los datos. Puede ser |
date |
Representa la fecha en la que se produjo el uso, según la hora UTC-8:00 (hora estándar del Pacífico). La marca de tiempo está en el formato ISO 8601, |
Parámetros de consulta
Parámetros | |
---|---|
customer |
Es el ID único del cliente del que se recuperarán los datos. |
filters |
La cadena de consulta Los filtros tienen el formato En este ejemplo, el operador GET https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time &filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z Los operadores relacionales incluyen los siguientes:
|
max |
Determina cuántos registros de actividad se muestran en cada página de respuesta. Por ejemplo, si la solicitud establece |
org |
Es el ID de la unidad organizacional sobre la que se generarán los informes. La actividad del usuario solo se mostrará para los usuarios que pertenezcan a la unidad organizativa especificada. |
page |
Es un token para especificar la página siguiente. Un informe con varias páginas incluye una propiedad |
parameters |
La cadena de consulta |
group |
IDs de grupo separados por comas (ofuscados) en los que se filtran las actividades de los usuarios; es decir, la respuesta contendrá actividades solo para los usuarios que forman parte de, al menos, uno de los IDs de grupo mencionados aquí. Formato: "id:abc123,id:xyz456" |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de UsageReports
.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/admin.reports.usage.readonly
Para obtener más información, consulta la Guía de autorización.