Häufig gestellte Fragen zum REST-API-Protokoll für Aktivitätsberichte von Google G Suite

Wofür wird die Ereignisverzögerungsoption verwendet?

Die Ereignisverzögerungsoption wird verwendet, um zu verhindern, dass Ereignisse übersehen werden. Verpasste Ereignisse treten in diesem Kontext auf, weil sie verfügbar werden, nachdem das Protokoll seinen Abfragebereich auf einen neueren Zeitrahmen als die Eingangszeit des Ereignisses aktualisiert hat. Wenn ein Ereignis aufgetreten ist, aber nicht an die Aktivitätsberichte-REST-API von Google G Suite gesendet wurde, erhält das Protokoll dieses Ereignis nicht, wenn das Protokoll die Erstellungszeit dieses Ereignisses abfragt.

Beispiel 1: Das folgende Beispiel zeigt, wie ein Ereignis verloren gehen kann.

Das Protokoll fragt die REST-API für Aktivitätsberichte der Google G Suite um 14:00 Uhr ab, um Ereignisse zwischen 13:00 Uhr und 13:59 Uhr zu erfassen. Die REST-API-Antwort Google G Suite Activity Reports gibt die Ereignisse zurück, die in der REST-API Google G Suite Activity Reports zwischen 13:00 Uhr und 13:59 Uhr verfügbar sind. Das Protokoll funktioniert so, als würden alle Ereignisse erfasst. Anschließend sendet er die nächste Abfrage an die REST-API für Aktivitätsberichte der Google G Suite um 15:00 Uhr, um Ereignisse abzurufen, die zwischen 14:00 Uhr und 14:59 Uhr aufgetreten sind. Das Problem bei diesem Szenario besteht darin, dass die REST-API für Aktivitätsberichte der Google G Suite möglicherweise nicht alle Ereignisse enthält, die zwischen 13:00 Uhr und 13:59 Uhr aufgetreten sind. Wenn ein Ereignis um 13:58 Uhr eingetreten ist, ist dieses Ereignis möglicherweise erst ab 14:03 Uhr in der Aktivitätsberichte-REST-API von Google Suite verfügbar. Das Protokoll hat jedoch bereits den Zeitbereich von 13:00 Uhr bis 13:59 Uhr abgefragt und kann diesen Bereich nicht erneut anfordern, ohne doppelte Ereignisse zu erhalten. Diese Verzögerung kann mehrere Stunden dauern.

Beispiel 2: Das folgende Beispiel zeigt Beispiel 1, außer in diesem Szenario wird eine Verzögerung von 15 Minuten hinzugefügt.

In diesem Beispiel wird eine Verzögerung von 15 Minuten verwendet, wenn das Protokoll Abfrageaufrufe ausgibt. Wenn das Protokoll einen Abfrageaufruf an die REST-API für Aktivitätsberichte der Google G Suite um 14:00 Uhr absetzt, erfasst es die Ereignisse, die zwischen 13:00 und 13:45 Uhr aufgetreten sind. Das Protokoll funktioniert so, als würden alle Ereignisse erfasst. Anschließend sendet er die nächste Abfrage an die REST-API für Google G Suite-Aktivitätsberichte um 15:00 Uhr und erfasst alle Ereignisse, die zwischen 13:45 und 14:45 Uhr aufgetreten sind. Anstatt das Ereignis zu verpassen, wie in Beispiel 1, wird es im nächsten Abfrageaufruf zwischen 13:45 und 14:45 Uhr aufgenommen.

Beispiel 3:Das folgende Beispiel zeigt Beispiel 2. In diesem Szenario sind die Ereignisse jedoch einen Tag später verfügbar.

Wenn das Ereignis um 13:58 Uhr eingetreten ist, aber erst am nächsten Tag um 13:57 Uhr für die REST-API für Aktivitätsberichte der Google G Suite verfügbar wurde, erhält die Ereignisverzögerung von Beispiel 2 dieses Ereignis nicht. Stattdessen muss die Ereignisverzögerung auf einen höheren Wert gesetzt werden, in diesem Fall 24 Stunden.

Wie funktioniert die Ereignisverzögerungsoption?

Anstatt eine Abfrage vom Zeitpunkt des letzten empfangenen Ereignisses ( last received event time ) bis zum aktuellen Zeitpunktauszuführen, werden die Protokollabfragen vom Zeitpunkt des letzten empfangenen Ereignisses ( last received event time ) bis zum aktuellen Zeitpunkt (current time) -<Ereignisverzögerung>. Die Ereignisverzögerung wird in Sekunden angegeben. Eine Verzögerung von 15 Minuten (900 Sekunden) bedeutet beispielsweise, dass Abfragen nur bis zu 15 Minuten zurückliegen. Diese Abfrage gibt der Google G Suite Activity Reports-REST-API 15 Minuten an, um ein Ereignis verfügbar zu machen, bevor es verloren geht. Wenn die aktuelle Zeit -<Ereignisverzögerung> vor der Zeit des letzten empfangenen Ereignissesliegt, fragt das Protokoll die REST-API für Google G Suite-Aktivitätsberichte nicht ab. Stattdessen wird auf die Übergabe der Bedingung gewartet, bevor die Abfrage ausgeführt wird.

Welchen Wert verwende ich für die Ereignisverzögerungsoption?

Die REST-API für Google G Suite-Aktivitätsberichte kann die Verfügbarkeit eines Ereignisses verzögern. Um zu verhindern, dass Ereignisse verpasst werden, können Sie den Wert der Parameteroption Ereignisverzögerung auf 168 Stunden (eine Woche) setzen. Je größer die Ereignisverzögerung ist, desto weniger Echtzeit sind die Ergebnisse. Beispiel: Bei einer 24-Stunden-Ereignisverzögerung werden Ereignisse 24 Stunden nach ihrem Auftreten statt sofort angezeigt. Der Wert hängt davon ab, wie hoch Ihr Risiko ist und wie wichtig Echtzeitdaten sind. Die Standardverzögerung von 2 Stunden (7200 Sekunden) gibt einen Wert an, der in Echtzeit festgelegt wird und verhindert, dass die meisten Ereignisse verpasst werden. Weitere Informationen zur Verzögerung finden Sie in Datenaufbewahrung und Zeitverzögerung (https://support.google.com/a/answer/7061566?hl=en).