Use a Data Destinations Availability API para verificar se os dados nos seus data destinations estão atualizados. A API verifica se os dados de ontem do seu lado (seu S3, etc.) são idênticos aos dados mais atualizados no banco de dados da Singular.
Para cada data destination configurado, a API retorna is_all_data_updated (true ou false). Também retorna is_updated para cada data connector incluído na exportação do data destination.
Observe que os dados comparados são sempre os dados de ontem.
Endpoint de Data Destinations Availability
| Método | Endpoint |
|---|---|
| GET | https://api.singular.net/api/v2.0/data_destinations_availability_status |
Consulta de exemplo (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 | Descrição |
|---|---|---|
| api_key | String | Sua chave de API da Singular (pode ser obtida no aplicativo web da Singular em Developer Tools > Reporting API Key). |
Saída de exemplo
O exemplo a seguir mostra o resultado para um data destination, que contém dois data connectors. Neste exemplo, "is_updated" é true para todos os data connectors e, portanto, "is_all_data_updated" é 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 saída
| Parâmetro | Formato | Descrição |
|---|---|---|
| Parâmetros no objeto 'data_destination_info' | ||
| data_destination_id | String | O identificador único do data destination. |
| data_destination_source_name | String | O nome do data destination conforme exibido no aplicativo web da Singular. |
| data_destination_schema | String | O esquema do data destination conforme exibido no aplicativo web da Singular. Isso ajuda a distinguir entre duas exportações configuradas para o mesmo data destination. |
| is_all_data_updated | Boolean | True se os dados de todos os data connectors relevantes foram atualizados no data destination. |
| Parâmetros por data connector | ||
| data_connector_id | String | O identificador único do data connector. |
| display_name | String | O nome do data connector conforme aparece no aplicativo web da Singular. |
| data_connector_username | String | O nome de usuário do data connector, conforme configurado no aplicativo web da Singular. Isso ajuda a identificar o data connector correto se você tiver múltiplos conectores para a mesma rede de anúncios com credenciais diferentes, extraindo dados diferentes. |
| is_updated | Boolean | True se os dados deste data connector foram atualizados no data destination (sua plataforma de BI, bucket S3, etc.) |
| is_loading_progress | Boolean | True se os dados deste data connector ainda estão sendo carregados no data destination. Se is_loading_progress for true, explica por que is_updated é false. Aguarde o término do carregamento antes de verificar novamente. |
| is_data_delay | Boolean | True se a Singular estiver enfrentando um atraso ao extrair os dados da fonte (por exemplo, rede de anúncios). Se is_data_delay for true, explica por que is_updated é false. Verifique novamente mais tarde ou consulte a página Data Connectors no aplicativo web da Singular para obter detalhes sobre o status do atraso. |