Google G 스위트 활동 보고서 REST API 프로토콜 FAQ

이벤트 지연 옵션은 어디에 사용됩니까?

이벤트 지연 옵션은 이벤트가 누락되지 않도록 하는 데 사용됩니다. 이 컨텍스트에서 누락된 이벤트는 프로토콜이 해당 조회 범위를 이벤트의 도착 시간보다 최신 시간 프레임으로 업데이트한 후에 사용 가능하게 되기 때문에 발생합니다. 이벤트가 발생했지만 Google G 스위트 활동 보고서 REST API에 게시되지 않은 경우에는 프로토콜이 해당 이벤트의 작성 시간을 조회할 때 프로토콜이 해당 이벤트를 가져오지 않습니다.

예제 1: 다음 예제는 이벤트가 어떻게 유실될 수 있는지 보여줍니다.

프로토콜은 오후 2:00에 Google G Suite Activity Reports REST API를 조회하여 오후 1:00-오후 1:59사이의 이벤트를 수집합니다. Google G 스위트 활동 보고서 REST API 응답은 Google G 스위트 활동 보고서 REST API에서 오후 1:00-오후 1:59사이에 사용 가능한 이벤트를 리턴합니다. 프로토콜은 모든 이벤트가 수집되는 것처럼 작동합니다. 그런 다음 오후 3시에 Google G Suite Activity Reports REST API에 다음 조회를 전송하여 오후 2:00-오후 2:59사이에 발생한 이벤트를 가져옵니다. 이 시나리오의 문제점은 Google G 스위트 활동 보고서 REST API가 오후 1:00-오후 1:59사이에 발생한 모든 이벤트를 포함하지 않을 수 있다는 것입니다. 이벤트가 오후 1:58에 발생한 경우, 해당 이벤트는 오후 2:03까지 Google G Suite Activity Reports REST API에서 사용할 수 없습니다. 그러나 프로토콜은 이미 1:00 PM-1:59 PM 시간 범위를 조회했으며 중복 이벤트를 가져오지 않으면 해당 범위를 다시 요청할 수 없습니다. 이 지연은 여러 시간이 걸릴 수 있습니다.

예제 2: 이 시나리오에서는 15분 지연이 추가되었다는 점을 제외하고 다음 예제는 예제 1과 동일합니다.

이 예제에서는 프로토콜이 조회 호출을 수행할 때 15분 지연을 사용합니다. 프로토콜이 오후 2:00에 Google G Suite Activity Reports REST API에 대한 조회 호출을 작성하면 오후 1:00-1:45사이에 발생한 이벤트를 수집합니다. 프로토콜은 모든 이벤트가 수집되는 것처럼 작동합니다. 그런 다음 오후 3시에 Google G Suite Activity Reports REST API에 다음 조회를 전송하고 오후 1:45-오후 2:45사이에 발생한 모든 이벤트를 수집합니다. 예제 1에서와 같이 이벤트가 누락되는 대신 1:45 PM-2:45 PM 사이의 다음 조회 호출에서 선택됩니다.

예제 3: 이 시나리오에서는 하루 후에 이벤트를 사용할 수 있다는 점을 제외하고 다음 예제는 예제 2와 동일합니다.

이벤트가 오후 1:58에 발생했지만 다음 날 오후 1:57에 Google G Suite Activity Reports REST API에서만 사용 가능하게 된 경우 예제 2 의 이벤트 지연은 해당 이벤트를 가져오지 않습니다. 대신 이벤트 지연이 더 높은 값(이 경우 24시간)으로 설정되어야 합니다.

이벤트 지연 옵션은 어떻게 작동합니까?

마지막 수신 이벤트 시간 에서 현재 시간으로 조회하는 대신, 프로토콜은 마지막 수신 이벤트 시간 에서 현재 시간 - <이벤트 지연> 으로 조회합니다. 이벤트 지연은 초 단위입니다. 예를 들어, 지연이 15분(900초)이면 최대 15분전까지만 조회함을 의미합니다. 이 조회는 이벤트가 유실되기 전에 이벤트를 사용할 수 있도록 Google G 스위트 활동 보고서 REST API에 15분을 제공합니다. 현재 시간 - <event delay> 가 마지막 수신 이벤트 시간미만인 경우 프로토콜은 Google G Suite Activity Reports REST API를 조회하지 않습니다. 대신 조회하기 전에 조건이 패스될 때까지 대기합니다.

이벤트 지연 옵션에 어떤 값을 사용합니까?

Google G 스위트 활동 보고서 REST API는 이벤트의 가용성을 지연시킬 수 있습니다. 이벤트가 누락되지 않도록 하기 위해 이벤트 지연 매개변수 옵션 값을 168시간 (1주일) 으로 설정할 수 있습니다. 그러나 이벤트 지연이 클수록 결과가 발생하는 실제 시간이 줄어듭니다. 예를 들어, 24시간이벤트 지연이 있는 경우 즉시 발생하지 않고 24시간후에 발생하는 이벤트를 볼 수 있습니다. 이 값은 감수할 수 있는 위험의 정도와 실시간 데이터의 중요도에 따라 달라집니다. 기본 지연 2시간 (7200초) 은 실시간으로 설정되는 값을 제공하며 대부분의 이벤트가 누락되지 않도록 합니다. 지연에 대한 자세한 정보는 데이터 보존 및 지연 시간 (https://support.google.com/a/answer/7061566?hl=en) 을 참조하십시오.