Lote

Às vezes, não é possível conseguir todas as informações necessárias em um único relatório. Por exemplo, quando há dimensões e métricas incompatíveis ou quando você quer agregar dados de maneiras diferentes.

Nessas situações, você precisará gerar vários relatórios.

Além disso, lotes são uma maneira eficaz de melhorar o desempenho do aplicativo, reduzindo o número de solicitações.

O problema em fazer várias solicitações independentes

Embora seja uma solução simples de implementar, fazer várias solicitações de API em um curto período de tempo pode fazer com que você encontre limitações de cota.

Uma solução melhor é evitar as solicitações paralelas e, em vez disso, criar solicitações em lote.

Lotes de relatórios

No exemplo de um aplicativo orientado ao usuário, uma primeira abordagem seria combinar o maior número possível de solicitações independentes em uma única solicitação em lote.

Relatório 1: os dez principais países em agosto
Relatório 2: valores dos mesmos dez países em julho, para comparação
Relatório 3: os dez principais canais em agosto
Relatório 4: valores dos mesmos dez canais em julho, para comparação

No exemplo acima, os relatórios 1 e 3 são independentes, mas não podem ser combinados em um único relatório, porque oferecem detalhamentos de dados diferentes. No entanto, elas podem ser agrupadas.

Os relatórios 2 e 4 só podem ser executados após obter os resultados do primeiro lote, pois precisamos configurar um filtro apropriado na solicitação. Elas poderão ser executadas como um segundo lote assim que os resultados do primeiro chegarem.

Uma opção diferente, que permitiria que todas as solicitações fossem combinadas em um único lote, seria simplesmente retornar todos os valores de julho (em vez de apenas os 10 principais) e, possivelmente, de agosto também. Essa pode ser uma opção razoável, dependendo do tamanho da conta do Google AdSense em questão e da quantidade de memória disponível para seu aplicativo.

Como isso acontece

Os lotes são tratados de forma diferente em cada biblioteca cliente, de modo que você deve verificar sua documentação para encontrar os detalhes. Aqui estão alguns links para a documentação relevante em várias bibliotecas de cliente:

Próximas etapas