Preguntas más frecuentes sobre el protocolo de la API REST de informes de actividad de Google G Suite

¿Para qué se utiliza la opción de retardo de sucesos?

La opción de retardo de sucesos se utiliza para evitar que se pierdan sucesos. Los sucesos que faltan, en este contexto, se producen porque pasan a estar disponibles después de que el protocolo haya actualizado su rango de consulta a un periodo de tiempo más reciente que la hora de llegada del suceso. Si se ha producido un suceso pero no se ha publicado en la API REST de informes de actividad de Google G Suite, cuando el protocolo consulta la hora de creación de dicho suceso, el protocolo no obtiene dicho suceso.

Ejemplo 1: el ejemplo siguiente muestra cómo se puede perder un suceso.

El protocolo consulta la API REST de informes de actividad de Google G Suite a las 2:00 PM para recopilar sucesos entre la 1:00 PM y la 1:59 PM. La respuesta de la API REST de informes de actividad de G Suite de Google devuelve los sucesos que están disponibles en la API REST de informes de actividad de G Suite de Google entre la 1:00 PM y la 1:59 PM. El protocolo funciona como si se recopilaran todos los sucesos. A continuación, envía la siguiente consulta a la API REST de informes de actividad de Google G Suite a las 3:00 PM para obtener los sucesos que se han producido entre las 2:00 PM y las 2:59 PM. El problema con este escenario es que es posible que la API REST de informes de actividad de Google G Suite no incluya todos los sucesos que se han producido entre la 1:00 PM y la 1:59 PM. Si se ha producido un suceso a las 1:58 PM, es posible que dicho suceso no esté disponible en la API REST de informes de actividad de Google G Suite hasta las 2:03 PM. Sin embargo, el protocolo ya ha consultado el intervalo de tiempo de la 1:00 PM a la 1:59 PM y no puede solicitar dicho intervalo sin obtener sucesos duplicados. Este retardo puede tardar varias horas.

Ejemplo 2: El ejemplo siguiente muestra el Ejemplo 1, excepto en este caso de ejemplo, se añade un retardo de 15 minutos.

Este ejemplo utiliza un retardo de 15 minutos cuando el protocolo realiza llamadas de consulta. Cuando el protocolo realiza una llamada de consulta a la API REST de informes de actividad de Google G Suite a las 2:00 PM, recopila los sucesos que se han producido entre la 1:00 y la 1:45 PM. El protocolo funciona como si se recopilaran todos los sucesos. A continuación, envía la siguiente consulta a la API REST de informes de actividad de Google G Suite a las 3:00 PM y recopila todos los sucesos que se han producido entre las 1:45 PM-2:45 PM. En lugar de faltar el suceso, como en el Ejemplo 1, se recoge en la siguiente llamada de consulta entre las 1:45 PM-2:45 PM.

Ejemplo 3: El ejemplo siguiente muestra el Ejemplo 2, excepto en este escenario, los sucesos están disponibles un día después.

Si el suceso se ha producido a la 1:58 PM, pero solo ha pasado a estar disponible para la API REST de informes de actividad de Google G Suite a la 1:57 PM del día siguiente, el retardo de suceso del Ejemplo 2 no obtiene dicho suceso. En su lugar, el retardo del suceso debe establecerse en un valor más alto, en este caso 24 horas.

¿Cómo funciona la opción de retardo de suceso?

En lugar de consultar de la hora del último suceso recibido a la hora actual, el protocolo consulta de la hora del último suceso recibido a la hora actual -<retardo de suceso>. El retardo del suceso es en segundos. Por ejemplo, un retardo de 15 minutos (900 segundos) significa que sólo consulta hasta hace 15 minutos. Esta consulta proporciona a la API REST de informes de actividad de Google G Suite 15 minutos para hacer que un suceso esté disponible antes de que se pierda el suceso. Cuando la hora actual -<retardo de suceso> es menor que la última hora de suceso recibida, el protocolo no consulta la API REST de informes de actividad de G Suite de Google . En su lugar, espera a que pase la condición antes de realizar la consulta.

¿Qué valor utilizo para la opción de retardo de evento?

La API REST de informes de actividad de Google G Suite puede retrasar la disponibilidad de un suceso. Para evitar que se pierdan sucesos, puede establecer el valor de opción del parámetro Retardo de sucesos en 168 horas (una semana). Sin embargo, cuanto mayor sea el retardo del evento, menos tiempo real serán los resultados. Por ejemplo, con un retardo de suceso de 24 horas, verá los sucesos 24 horas después de que se produzcan en lugar de inmediatamente. El valor depende del riesgo que esté dispuesto a asumir y de la importancia de los datos en tiempo real. El retardo predeterminado de 2 horas (7200 segundos) proporciona un valor que se establece en tiempo real y también impide que la mayoría de los sucesos se pierdan. Para obtener más información sobre el retardo, consulte Retención de datos y tiempos de retardo (https://support.google.com/a/answer/7061566?hl=en).