Perguntas mais frequentes do protocolo da API de REST do Google G Suite Activity Reports

Para que a opção de atraso de evento é usada?

A opção de atraso do evento é usada para evitar que eventos sejam perdidos. Os eventos perdidos, nesse contexto, ocorrem porque se tornam disponíveis depois que o protocolo atualiza seu intervalo de consulta para um intervalo de tempo mais novo que o horário de chegada do evento. Se um evento tiver ocorrido, mas não tiver sido postado na API de REST do Google G Suite Activity Reports, quando o protocolo consultar o horário de criação desse evento, ele não o obterá.

Exemplo 1: o exemplo a seguir mostra como um evento pode ser perdido.

O protocolo consulta a API de REST do Google G Suite Activity Reports às 14h para coletar eventos entre 13h e 13h59. A resposta da API de REST do Google G Suite Activity Reports retorna os eventos que estão disponíveis na API de REST do Google G Suite Activity Reports entre 13h e 13h59. O protocolo opera como se todos os eventos fossem coletados. Em seguida, ele envia a próxima consulta para a API de REST do Google G Suite Activity Reports às 15h para obter os eventos ocorridos entre 14h e 14h59. O problema com esse cenário é que a API de REST do Google G Suite Activity Reports pode não incluir todos os eventos ocorridos entre as 13h e 13h59. Se um evento tiver ocorrido às 13h58, ele poderá não estar disponível na API de REST do Google G Suite Activity Reports até às 14h03. No entanto, o protocolo já terá consultado o intervalo de tempo 13h – 13h59 e não poderá consultá-lo novamente sem obter eventos duplicados. Esse atraso pode levar várias horas.

Exemplo 2: o exemplo a seguir mostra o Exemplo 1, exceto que neste cenário um atraso de 15 minutos é incluído.

Este exemplo usa um atraso de 15 minutos quando o protocolo faz chamadas de consulta. Quando o protocolo faz uma chamada de consulta para a API de REST do Google G Suite Activity Reports às 14h, ele coleta os eventos ocorridos entre as 13h e 13h45. O protocolo opera como se todos os eventos fossem coletados. Em seguida, ele envia a próxima consulta para a API de REST do Google G Suite Activity Reports às 15h e coleta todos os eventos ocorridos entre 13h45 e 14h45. Em vez de o evento ser perdido, como no Exemplo 1, ele é coletado na próxima chamada de consulta entre 13h45 e 14h45.

Exemplo 3: o exemplo a seguir mostra o Exemplo 2, exceto que neste cenário os eventos estão disponíveis um dia depois.

Se o evento tiver ocorrido às 13h58, mas se tornado disponível para a API de REST do Google G Suite Activity Reports apenas às 13h57 do dia seguinte, o atraso de evento do Exemplo 2 não obterá esse evento. Em vez disso, o atraso do evento deve ser configurado com um valor mais alto, neste caso 24 horas.

Como a opção de atraso de eventos funciona?

Em vez de consultar a partir do último horário de evento recebido até horário atual, as consultas de protocolo do último horário de evento recebido até horário atual -<atraso do evento>. O atraso do evento está em segundos. Por exemplo, um atraso de 15 minutos (900 segundos) significa que ele consulta apenas até 15 minutos atrás. Essa consulta fornece à API de REST do Google G Suite Activity Reports 15 minutos para disponibilizar um evento antes de ele ser perdido. Quando o horário atual -<atraso do evento> for menor do que o último horário de evento recebido, o protocolo não consulta a API de REST do Google G Suite Activity Reports. Como alternativa, ele aguarda a condição passar antes de consultar.

Qual valor usar para a opção de atraso de evento?

A API de REST do Google G Suite Activity Reports pode atrasar a disponibilidade de um evento. Para evitar a perda de eventos, é possível configurar o valor da opção do parâmetro Event Delay para 168 horas (uma semana). No entanto, quanto maior o atraso do evento, menos em tempo real são os resultados. Por exemplo, com um atraso de evento de 24 horas, você verá os eventos 24 horas depois que eles ocorrerem, em vez de imediatamente. O valor depende de quanto risco você esteja disposto a assumir e o quão importantes são os dados em tempo real. O atraso padrão de 2 horas (7.200 segundos) fornece um valor configurado em tempo real e também impede que a maioria dos eventos seja perdida. Para obter mais informações sobre o atraso, consulte Retenção de dados e tempos de lag (https://support.google.com/a/answer/7061566?hl=en).