Data Destinations Availability API를 사용하여 데이터 대상의 데이터가 최신 상태인지 확인합니다. 이 API는 사용자 측 (S3 등)의 어제 데이터가 Singular 데이터베이스의 가장 최신 데이터와 동일한지 확인합니다.
구성된 각 데이터 대상에 대해 API는 is_all_data_updated (true 또는 false)를 반환합니다. 또한 데이터 대상 내보내기에 포함된 각 데이터 커넥터에 대해 is_updated를 반환합니다.
비교되는 데이터는 항상 어제의 데이터입니다.
Data Destinations Availability 엔드포인트
| 메서드 | 엔드포인트 |
|---|---|
| GET | https://api.singular.net/api/v2.0/data_destinations_availability_status |
샘플 쿼리 (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)
쿼리 매개변수
| 매개변수 | 형식 | 설명 |
|---|---|---|
| api_key | String | Singular API 키 (Singular 웹 앱의 Developer Tools > Reporting API Key에서 확인할 수 있습니다). |
출력 샘플
다음 샘플은 두 개의 데이터 커넥터를 포함하는 하나의 데이터 대상에 대한 결과를 보여줍니다. 이 샘플에서는 모든 데이터 커넥터에 대해 "is_updated"가 true이므로 "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
}
...
출력 매개변수
| 매개변수 | 형식 | 설명 |
|---|---|---|
| 'data_destination_info' 객체의 매개변수 | ||
| data_destination_id | String | 데이터 대상의 고유 식별자입니다. |
| data_destination_source_name | String | Singular 웹 앱에 표시되는 데이터 대상 이름입니다. |
| data_destination_schema | String | Singular 웹 앱에 표시되는 데이터 대상 스키마입니다. 동일한 데이터 대상에 구성된 두 개의 내보내기를 구분하는 데 도움이 됩니다. |
| is_all_data_updated | Boolean | 관련된 모든 데이터 커넥터의 데이터가 데이터 대상에서 업데이트된 경우 True입니다. |
| 데이터 커넥터별 매개변수 | ||
| data_connector_id | String | 데이터 커넥터의 고유 식별자입니다. |
| display_name | String | Singular 웹 앱에 표시되는 데이터 커넥터의 이름입니다. |
| data_connector_username | String | Singular 웹 앱에 구성된 데이터 커넥터의 사용자 이름입니다. 동일한 광고 네트워크에 대해 서로 다른 자격 증명으로 서로 다른 데이터를 가져오는 여러 커넥터가 있는 경우 올바른 데이터 커넥터를 식별하는 데 도움이 됩니다. |
| is_updated | Boolean | 이 데이터 커넥터의 데이터가 데이터 대상 (BI 플랫폼, S3 버킷 등)에서 업데이트된 경우 True입니다. |
| is_loading_progress | Boolean | 이 데이터 커넥터의 데이터가 아직 데이터 대상으로 로드 중인 경우 True입니다. is_loading_progress가 true이면 is_updated가 false인 이유를 설명합니다. 다시 확인하기 전에 로드가 완료될 시간을 주세요. |
| is_data_delay | Boolean | Singular가 소스 (예: 광고 네트워크)에서 데이터를 가져오는 데 지연이 발생하는 경우 True입니다. is_data_delay가 true이면 is_updated가 false인 이유를 설명합니다. 나중에 다시 확인하거나 Singular 웹 앱의 Data Connectors 페이지에서 지연 상태에 대한 세부 정보를 확인하세요. |