- 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
- ApplicationName
Comienza a recibir notificaciones sobre las actividades de la cuenta. Para obtener más información, consulta Cómo recibir notificaciones push.
Solicitud HTTP
POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch
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 para el que se deben filtrar los datos. Puede ser |
applicationName |
Nombre de la aplicación para la que se recuperarán los eventos. |
Parámetros de consulta
Parámetros | |
---|---|
actorIpAddress |
La dirección de protocolo de Internet (IP) del host donde se realizó el evento Esta es una forma adicional de filtrar el resumen de un informe mediante la dirección IP del usuario cuya actividad se informa. Esta dirección IP puede reflejar la ubicación física del usuario o no. Por ejemplo, la dirección IP puede ser la dirección del servidor proxy del usuario o la dirección de una red privada virtual (VPN). Este parámetro es compatible con las versiones de direcciones IPv4 y IPv6. |
customerId |
El ID único del cliente para el que se recuperan los datos. |
endTime |
Establece el final del período que se muestra en el informe. La fecha debe estar en el formato RFC 3339, por ejemplo, 2010-10-28T10:26:35.000Z. El valor predeterminado es la hora aproximada de la solicitud a la API. Un informe de la API tiene tres conceptos de tiempo básicos:
endTime , el informe muestra todas las actividades desde la startTime hasta la hora actual o los 180 días más recientes si startTime hace más de 180 días en el pasado.
|
eventName |
El nombre del evento que consulta la API. Cada |
filters |
La cadena de consulta Estos parámetros de eventos están asociados con un En los siguientes ejemplos de actividad de Drive, la lista que se muestra consta de todos los eventos
Una consulta
Nota: La API no acepta varios valores del mismo parámetro. Si se proporciona un parámetro más de una vez en la solicitud a la API, la API solo acepta el último valor de ese parámetro. Además, si se proporciona un parámetro no válido en la solicitud a la API, la API ignora ese parámetro y muestra la respuesta correspondiente a los parámetros válidos restantes. Si no se solicitan parámetros, se muestran todos los parámetros. |
maxResults |
Determina cuántos registros de actividad se muestran en cada página de respuesta. Por ejemplo, si la solicitud establece |
orgUnitID |
ID de la unidad organizativa de la que se debe generar el informe. Los registros de actividad solo se mostrarán a los usuarios que pertenezcan a la unidad organizativa especificada. |
pageToken |
El token que se especificará en la página siguiente. Un informe con varias páginas incluye una propiedad |
startTime |
Establece el inicio del intervalo de tiempo que se muestra en el informe. La fecha debe estar en el formato RFC 3339, por ejemplo, 2010-10-28T10:26:35.000Z. El informe muestra todas las actividades desde el |
groupIdFilter |
Son los IDs de grupos separados por comas (ofuscados) en los que se filtran las actividades del usuario; 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 incluye una instancia de SubscriptionChannel
.
Cuerpo de la respuesta
Un canal de notificaciones que se usa para buscar cambios en los recursos.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "id": string, "token": string, "expiration": string, "type": string, "address": string, "payload": boolean, "params": { string: string, ... }, "resourceId": string, "resourceUri": string, "kind": string } |
Campos | |
---|---|
id |
Es un UUID o una cadena única similar que identifica este canal. |
token |
Una cadena arbitraria entregada a la dirección de destino con cada notificación entregada a través de este canal. Opcional. |
expiration |
Fecha y hora del vencimiento del canal de notificaciones, expresadas como una marca de tiempo de Unix, en milisegundos. Opcional. |
type |
Es el tipo de mecanismo de entrega que se usa para este canal. El valor se debe establecer en |
address |
La dirección a la que se envían las notificaciones de este canal. |
payload |
Un valor booleano para indicar si se desea una carga útil. Una carga útil son datos que se envían en el cuerpo de un mensaje HTTP POST, PUT o PATCH y que contienen información importante sobre la solicitud. Opcional. |
params |
Parámetros adicionales que controlan el comportamiento del canal de entrega. Opcional. Es un objeto que contiene una lista de pares |
resourceId |
Un ID opaco que identifica el recurso que se mira en este canal. Es estable en diferentes versiones de API. |
resourceUri |
Un identificador específico de la versión para el recurso observado. |
kind |
Lo identifica como un canal de notificaciones que se usa para buscar cambios en un recurso, que es " |
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/admin.reports.audit.readonly
Para obtener más información, consulta la guía de autorización.
ApplicationName
Nombre de la aplicación para la que se recuperarán los eventos.
Enumeradores | |
---|---|
access_transparency |
Los informes de actividad de Transparencia de acceso de Google Workspace muestran información sobre diferentes tipos de eventos de actividad de Transparencia de acceso. |
admin |
Los informes de actividad de la aplicación de la Consola del administrador muestran información de la cuenta sobre diferentes tipos de eventos de actividad del administrador. |
calendar |
Los informes de actividad de la aplicación Calendario de Google muestran información sobre varios eventos de actividad de Calendario. |
chat |
Los informes de actividad de Chat devuelven información sobre varios eventos de la actividad de Chat. |
drive |
Los informes de actividad de la aplicación de Google Drive muestran información sobre varios eventos de actividad de Google Drive. El informe de actividad de Drive solo está disponible para los clientes de Google Workspace Business y Google Workspace Enterprise. |
gcp |
Los informes de actividad de la aplicación de Google Cloud Platform muestran información sobre varios eventos de actividad de GCP. |
gplus |
Los informes de actividad de la aplicación Google+ devuelven información sobre varios eventos de actividad de Google+. |
groups |
Los informes de actividad de la aplicación de Grupos de Google muestran información sobre varios eventos de actividad de Grupos. |
groups_enterprise |
Los informes de actividad de grupos empresariales muestran información sobre varios eventos de actividad de grupos empresariales. |
jamboard |
Los informes de actividad de Jamboard muestran información sobre diversos eventos de actividad de Jamboard. |
login |
Los informes de actividad de la aplicación de acceso muestran información de la cuenta sobre los diferentes tipos de eventos de actividad de acceso. |
meet |
El informe de Actividad de auditoría de Meet muestra información sobre los diferentes tipos de eventos de actividad de auditoría de Meet. |
mobile |
El informe Actividad de auditoría de dispositivos muestra información sobre diferentes tipos de eventos de actividad de auditoría de dispositivos. |
rules |
El informe Actividad de las reglas muestra información sobre diferentes tipos de eventos de actividad de las reglas. |
saml |
El informe de actividad de SAML muestra información sobre diferentes tipos de eventos de actividad de SAML. |
token |
Los informes de actividad de la aplicación de tokens muestran información de la cuenta sobre los diferentes tipos de eventos de actividad de tokens. |
user_accounts |
Los informes de actividad de la aplicación de Cuentas de usuario muestran información de la cuenta sobre los diferentes tipos de eventos de actividad de Cuentas de usuario. |
context_aware_access |
Los informes de actividad del acceso adaptado al contexto muestran información sobre los eventos denegados del acceso a los usuarios debido a las reglas de acceso adaptado al contexto. |
chrome |
Los informes de actividad de Chrome muestran información sobre los eventos del navegador Chrome y de ChromeOS. |
data_studio |
Los informes de actividad de Data Studio muestran información sobre varios tipos de eventos de actividad de Data Studio. |
keep |
Los informes de actividad de la aplicación de Keep muestran información sobre varios eventos de actividad de Google Keep. El informe de actividad de Keep solo está disponible para los clientes de Google Workspace Business y Enterprise. |