Conteos de publicaciones del rango: por estado, por red y por día.
Ojo con las dos series, que responden a preguntas distintas y sobre conjuntos distintos:
by_day cuenta lo CREADO cada día (trabajo hecho, incluidas las programadas y los
borradores) y published_by_day cuenta lo que SALIÓ cada día, sólo sended. Una publicación
creada el mes pasado y publicada ayer sale en la segunda y no en la primera.
El día se calcula en UTC: un post de madrugada puede caer en el día anterior.
El listado de publicaciones del rango CON sus métricas, paginado y ordenado por la métrica pedida. Es la pantalla de estadísticas entera en una llamada.
Dos cosas que se pagan caras si se ignoran:
summary cubre siempre la organización entera; social_network y accounts filtran
sólo el listado. La cabecera no cambia al filtrar por Instagram, y eso es deliberado.summary: false. Los agregados sólo dependen del rango, así que
recalcularlos en cada página son tres agregaciones tiradas.A diferencia de topPublications, aquí SÍ salen las publicaciones sin medir, con
metrics ausente. Ordenando en descendente caen al final solas.
La pantalla de inicio entera en UN viaje: salud operativa, publicaciones, métricas de publicación y de cuenta, consumo del plan, planes de IA y mensajes sin leer.
Un bloque que falta no es un error. Cada uno se comprueba contra su propio permiso y se
omite si quien llama no puede leerlo, en vez de tumbar la petición entera; available_blocks
dice cuáles se permitieron. Un bloque en true que no viene en el cuerpo significa que no
había datos — salvo messages, que también se apaga cuando el plan no incluye chat.
El ranking de publicaciones del rango por una métrica.
Sólo entra lo que ya se ha medido: una publicación que la red aún no ha reportado, o de una red que no publica esa métrica, no compite — no es que haya sacado un 0. Para verlas todas con su hueco, publicationStats.
Cuidado con la forma: una fila no es una Publication. No tiene _id —el identificador es
id_publication— y el contenido viaja anidado en publication.
El consumo del plan de la organización: lo que gasta, lo que ha repartido entre sus hijas y los límites que le aplican.
Una organización sin plan propio hereda el del primer padre que tenga uno, así que limits
puede no ser suyo. Es la forma barata de pintar una barra de progreso: antes había que
bajarse el listado entero de organizaciones del cliente.
Las métricas de CUENTA agregadas: seguidores, impresiones, alcance, visitas al perfil.
group_bydecide el eje —daypara una serie,networkoaccountpara un desglose,totalpara un solo número— y entotalcada fila traegroup: null. Los nombres son los del vocabulario común, no los crudos de cada red.