Usa la Data Destinations Availability API para verificar si los datos en tus data destinations están actualizados. La API comprueba si los datos de ayer en tu extremo (tu S3, etc.) son idénticos a los datos más actualizados en la base de datos de Singular.
Para cada data destination que tengas configurado, la API devuelve is_all_data_updated (true o false). También devuelve is_updated para cada data connector incluido en la exportación del data destination.
Ten en cuenta que los datos que se comparan son siempre los datos de ayer.
Endpoint de Data Destinations Availability
| Método | Endpoint |
|---|---|
| GET | https://api.singular.net/api/v2.0/data_destinations_availability_status |
Consulta de ejemplo (Python)
import requests
url = "https://api.singular.net/api/v2.0/data_destinations_availability_status"
queryparams = {"api_key":"<API_KEY>"}
response = requests.get(url=url, params=queryparams)Parámetros de consulta
| Parámetro | Formato | Descripción |
|---|---|---|
| api_key | String | Tu clave de API de Singular (se puede obtener en la aplicación web de Singular en Developer Tools > Reporting API Key). |
Salida de ejemplo
El siguiente ejemplo muestra el resultado para un data destination, que contiene dos data connectors. En este ejemplo, "is_updated" es true para todos los data connectors y por lo tanto "is_all_data_updated" es true.
{
'status': 0,
'substatus': 0,
'value': [
{
'data_destination_info': {
'data_destination_id': 'dhjeghdj11',
'data_destination_source_name': 'Postgres Destination',
'data_destination_schema': 'Campaign and creative data',
'is_all_data_updated': True,
'status': 'Active',
'data_connectors': [
{
'data_connector_id': 'dhe836dh',
'display_name': 'AdWords',
'data_connector_username': 'myUserName',
'is_updated': True,
'is_data_delay': False,
'is_loading_progress': False
},{
'data_connector_id': '75encfrr',
'display_name': 'Vungle',
'data_connector_username': 'myUserName',
'is_updated': True,
'is_data_delay': False,
'is_loading_progress': False
}
...Parámetros de salida
| Parámetro | Formato | Descripción |
|---|---|---|
| Parámetros en el objeto 'data_destination_info' | ||
| data_destination_id | String | El identificador único del data destination. |
| data_destination_source_name | String | El nombre del data destination tal como se muestra en la aplicación web de Singular. |
| data_destination_schema | String | El esquema del data destination tal como se muestra en la aplicación web de Singular. Esto te ayuda a distinguir entre dos exportaciones configuradas al mismo data destination. |
| is_all_data_updated | Boolean | True si los datos de todos los data connectors relevantes se han actualizado en el data destination. |
| Parámetros por data connector | ||
| data_connector_id | String | El identificador único del data connector. |
| display_name | String | El nombre del data connector tal como aparece en la aplicación web de Singular. |
| data_connector_username | String | El nombre de usuario del data connector, configurado en la aplicación web de Singular. Esto te ayuda a identificar el data connector correcto si tienes varios conectores para la misma red de publicidad con credenciales diferentes que extraen datos diferentes. |
| is_updated | Boolean | True si los datos de este data connector se han actualizado en el data destination (tu plataforma de BI, bucket de S3, etc.) |
| is_loading_progress | Boolean | True si los datos de este data connector aún se están cargando en el data destination. Si is_loading_progress es true, explica por qué is_updated es false. Da tiempo a que la carga termine antes de volver a verificar. |
| is_data_delay | Boolean | True si Singular está experimentando un retraso al extraer los datos de la fuente (por ejemplo, una red de publicidad). Si is_data_delay es true, explica por qué is_updated es false. Verifica de nuevo más tarde o consulta la página Data Connectors en la aplicación web de Singular para obtener detalles sobre el estado del retraso. |