- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- Pruébala
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 del usuario. Para obtener más información sobre los parámetros del informe del usuario, consulta las guías de referencia de 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 | |
---|---|
userKey or all |
Representa el ID de perfil o el correo electrónico del usuario que se usará para filtrar los datos. Puede ser |
date |
Representa la fecha en que se produjo el uso, según UTC-8:00 (hora estándar del Pacífico). La marca de tiempo debe estar en formato ISO 8601, |
Parámetros de consulta
Parámetros | |
---|---|
customerId |
El ID único del cliente para el que se recuperarán los datos. |
filters |
La string 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 Entre los operadores relacionales, se incluyen los siguientes:
|
maxResults |
Determina cuántos registros de actividad se muestran en cada página de respuesta. Por ejemplo, si la solicitud establece |
orgUnitId |
Es el ID de la unidad organizativa sobre la cual se informará. La actividad del usuario solo se mostrará para los usuarios que pertenezcan a la unidad organizativa especificada. |
pageToken |
Token para especificar la página siguiente. Un informe con varias páginas tiene una propiedad |
parameters |
La cadena de consulta |
groupIdFilter |
ID de grupos separados por comas (ofuscados) en los que se filtran las actividades de los usuarios, es decir, la respuesta contendrá actividades solo para aquellos usuarios que forman parte de al menos uno de los ID de grupos que se mencionan 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 Descripción general de OAuth 2.0.