Foire aux questions du protocole d'API REST Google G Suite Activity Reports

A quoi sert l'option de retardement des événements ?

L'option de retardement des événements est utilisée pour éviter que des événements ne soient manquants. Les événements manqués, dans ce contexte, se produisent parce qu'ils deviennent disponibles après que le protocole a mis à jour sa plage de requêtes à une période plus récente que l'heure d'arrivée de l'événement. Si un événement s'est produit mais n'a pas été publié dans l'API REST Google G Suite Activity Reports, lorsque le protocole demande l'heure de création de cet événement, le protocole ne le reçoit pas.

Exemple 1 : l'exemple suivant montre comment un événement peut être perdu.

Le protocole interroge l'API REST Google G Suite Activity Reports à 14h00 pour collecter les événements entre 13h00 et 13h59. La réponse de l'API REST Google G Suite Activity Reports renvoie les événements qui sont disponibles dans l'API REST Google G Suite Activity Reports entre 13h00 et 13h59. Le protocole fonctionne comme si tous les événements étaient collectés. Ensuite, il envoie la requête suivante à l'API REST Google G Suite Activity Reports à 15h00 pour obtenir les événements qui se sont produits entre 14h00 et 14h59. Le problème de ce scénario est que l'API REST Google G Suite Activity Reports peut ne pas inclure tous les événements qui se sont produits entre 13h00 et 13h59. Si un événement s'est produit à 13h58, cet événement peut ne pas être disponible dans l'API REST Google G Suite Activity Reports jusqu'à 14h03. Cependant, le protocole a déjà interrogé la plage horaire de 13h00 à 13h59 et ne peut pas réinterroger cette plage sans obtenir d'événements dupliqués. Ce délai peut prendre plusieurs heures.

Exemple 2 : l'exemple suivant montre l'exemple 1, sauf que dans ce scénario un délai de 15 minutes est ajouté.

Cet exemple utilise un délai de 15 minutes lorsque le protocole effectue des appels de requête. Lorsque le protocole effectue un appel de requête à l'API REST Google G Suite Activity Reports à 14h00, il collecte les événements qui se sont produits entre 13h00 et 13h45. Le protocole fonctionne comme si tous les événements étaient collectés. Ensuite, il envoie la requête suivante à l'API REST Google G Suite Activity Reports à 15h00 et collecte tous les événements qui se sont produits entre 13h45 et 14h45. Au lieu de manquer l'événement, comme dans l'exemple 1, il est récupéré dans l'appel de requête suivant entre 13h45 et 14h45.

Exemple 3 : l'exemple suivant montre l'exemple 2, sauf que dans ce scénario les événements sont disponibles un jour plus tard.

Si l'événement s'est produit à 13h58, mais n'est devenu disponible pour l'API REST Google G Suite Activity Reports qu'à 13h57 le lendemain, le délai d'événement de l'exemple 2 ne permet pas d'obtenir cet événement. Au lieu de cela, le délai d'événement doit être défini sur une valeur plus élevée, dans ce cas 24 heures.

Comment fonctionne l'option de retardement des événements ?

Au lieu d'interroger entre l'heure du dernier événement reçu et l'heure actuelle, le protocole interroge entre l'heure du dernier événement reçu et l'heure actuelle - <délai d'événement>. Le délai d'événement est exprimé en secondes. Par exemple, un délai de 15 minutes (900 secondes) signifie une interrogation jusqu'à 15 minutes plus tôt. Cette requête donne à l'API REST Google G Suite Activity Reports 15 minutes pour rendre un événement disponible avant que l'événement ne soit perdu. Lorsque l'heure actuelle - <délai d'événement> est inférieure à l'heure du dernier événement reçu, le protocole n'interroge pas l'API REST Google G Suite Activity Reports. Au lieu de cela, il attend que la condition soit transmise avant l'interrogation.

Quelle valeur dois-je utiliser pour l'option de retardement des événements ?

L'API REST Google G Suite Activity Reports peut retarder la disponibilité d'un événement. Pour éviter que des événements ne soient manqués, vous pouvez définir la valeur de l'option de paramètre Event Delay sur 168 heures (une semaine). Cependant, plus le délai d'événement est important, moins les résultats sont en temps réel. Par exemple, avec un délai d'événement de 24 heures, vous voyez les événements 24 heures après qu'ils se produisent et non immédiatement. La valeur dépend du niveau de risque que vous êtes prêt à prendre et de l'importance des données en temps réel. Le délai par défaut de 2 heures (7200 secondes) fournit une valeur définie en temps réel et empêche également la plupart des événements d'être manqués. Pour plus d'informations sur le délai, voir Data retention and lag times (https://support.google.com/a/answer/7061566?hl=en).