Métrica de engajamento agregada do período, sem granularidade de criança — planejado
Planejado — ainda não implementado. Este endpoint (e o Partner Gateway próprio e isolado que o servirá) foi deliberadamente adiado para uma revisão dedicada, dado o tratamento de dado de criança. O contrato abaixo é o desenho de destino.
Retorna contagens agregadas no nível de conta do parceiro como um todo — nunca por criança, nunca por família individual, nunca com nome. Pensado para alimentar o painel de KPIs do parceiro (contas ativas, histórias concluídas no período) sem que nenhum dado identificável de menor deixe o perímetro do HistorinhAI. Ver O que esta API deliberadamente não expõe para a justificativa completa de design.
Piso mínimo de amostra (k-anonimato). Para evitar que um corte pequeno vire uma forma indireta de identificar uma família específica, a resposta suprime os campos numéricos (retorna null) sempre que active_accounts no período consultado fica abaixo de min_sample_threshold (hoje 30). Isso é deliberado mesmo sabendo que reduz a utilidade do endpoint em pilotos pequenos — um piloto de dezenas de milhares de usuários deve operar bem acima desse piso na maior parte dos recortes de período.
Não aceita filtro por subscriber_id, por child_id, nem por qualquer outro identificador individual — o único parâmetro de recorte é a janela de tempo.
Authorizations
Client credentials, escopado ao HistorinhAI — ver /oauth2/token acima (planejado: hoje o emissor que existe é o da Platform API, em https://api.googa.com.br/v1/oauth2/token).
Query Parameters
Janela máxima suportada: 366 dias. Recomendamos alinhar ao ciclo mensal da Nota de Débito da Platform API para facilitar a correlação com billing.
Response
Resumo do período (possivelmente suprimido pelo piso de amostra).
Todo campo numérico é um agregado sobre a base completa de contas do parceiro no período — nunca uma lista, nunca uma linha por conta ou por criança.
Contas do parceiro com ao menos um entitlement HistorinhAI ativo em algum momento do período. null se abaixo do piso de amostra.
Total de histórias concluídas por qualquer criança de qualquer conta do parceiro no período, somado sem distinção de conta ou criança. null se abaixo do piso de amostra.
Minutos lidos no período, somados por conta e depois em média entre contas.
Piso mínimo de active_accounts exigido para retornar os campos acima.
30
true quando os campos numéricos foram omitidos por estarem abaixo do piso de amostra.