Disponibilidad de métricas por plataforma (API)

Cuando solicita analíticas de streaming a través de la API pública de LabelGrid y filtra por una única plataforma, la respuesta le indica si esa plataforma realmente informa la métrica que pidió. Esto permite que su integración distinga entre «aún no hay datos» y «esta plataforma nunca informa esta métrica».

El campo availability

Añada un filtro de plataforma a cualquier solicitud de analíticas —por ejemplo filter[platform]=SPOTIFY— y la respuesta incluirá un campo availability junto al habitual data:

• available — la plataforma informa esta métrica; data se rellena con normalidad.
• not_available_for_platform — la plataforma no informa esta métrica. data se devuelve vacío. Es un comportamiento esperado, no un error.

El campo availability aparece solo cuando filtra por una única plataforma. Las solicitudes sin filtro de plataforma devuelven data exactamente como antes, sin ninguna clave availability.

La forma de data no cambia: availability se añade junto a él, de modo que las integraciones existentes siguen funcionando sin modificación.

Endpoints de métrica individual

Cada endpoint de analíticas individual devuelve un único valor availability de nivel superior junto a su data:

{
  "availability": "not_available_for_platform",
  "data": []
}

El endpoint de resumen de analíticas

El endpoint /analiticas/summary devuelve varias secciones a la vez. Lleva un mapa availability paralelo con una entrada por sección, para que pueda saber qué secciones informa la plataforma y cuáles vuelven vacías:

{
  "availability": {
    "streams": "available",
    "listeners": "available",
    "streams_by_country": "available",
    "streams_by_gender": "available",
    "streams_by_age": "available",
    "saves": "not_available_for_platform"
  },
  "data": { }
}

Qué plataformas informan qué métricas

Plataforma (filter[platform])	Métricas informadas
SPOTIFY	Todas las métricas de analíticas
APPLE_MUSIC (también se acepta ITUNES)	Streams, oyentes, streams por país, streams por género y streams por edad

Para Apple Music, cualquier métrica fuera de esa lista devuelve not_available_for_platform con data vacío. Spotify informa todas las métricas de analíticas.

Cómo gestionarlo en su integración

• Lea availability antes de tratar un data vacío como «sin actividad». Un resultado vacío con not_available_for_platform significa que la plataforma no informa esa métrica en absoluto.
• Cuando solicita varias métricas a la vez mediante /analiticas/summary, compruebe la clave correspondiente en el mapa availability de cada sección.
• Si no filtra por plataforma, no hay campo availability: la respuesta es la vista combinada de todas las plataformas, exactamente como antes.

Relacionado

• Descripción general de la API — autenticación, endpoints y la referencia completa
• Analíticas — el panel de analíticas y qué muestra cada pestaña