Data Destinations (ETL) Availability API

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 페이지에서 지연 상태에 대한 세부 정보를 확인하세요.