Demand Partners API
Creating a Demand Partner
SDK
Use tab completion with SDK to auto-complete function names or show field options!
In [40]: partner = springserve.demand_partners.new({"name": "API Docs partner"})
In [41]: print partner.id, partner.name
1764 API Docs partner
REST API
POST /api/v0/demand_partners
Headers
Content-Type application/json Authorization "yourAuthToken"
Body (example)
{ "name": "API Docs partner", } |
Required parameters: name
Response
Status code 200
{
'account_id': 1,
'buy_flagged_supply': True,
'default_tier': 1,
'direct_connect': False,
'id': 1764,
'name': 'API Docs partner',
'targeting_page_attribute_profile': {
'id': 123,
'user_agent_devices': [],
'user_agent_operating_systems': [],
'detected_player_size_targeting': false,
'player_sizes': [
'xs',
's',
'm',
'l',
'xl',
'u'
],
'detected_domain_targeting': null,
'domain_white_list': '',
'domain_list_ids': [],
'app_bundle_white_list': '',
'app_bundle_list_ids': [],
'app_name_white_list': '',
'app_name_list_ids': [],
'key_value_targeting': null,
'key_values': null,
'targeting_secure': false,
'goal_targetings': [],
'realtime_viewability': false,
'min_aspect_ratio': null,
'max_aspect_ratio': null,
'device_id_required': null,
'ip_white_list': '',
'ip_list_ids': [],
'created_at': '2018-06-21T12:56:50.442Z'
},
'targeting_spend_profile': {
'id': 5678,
'budget_metric': null,
'budget_period': null,
'budget_pacing': null,
'budget_value': null,
'created_at': '2018-06-21T12:56:50.432Z'
},
'targeting_time_profile': {
'id': 91011,
'frequency_cap_period': null,
'frequency_cap_period_amount': null,
'frequency_cap_metric': null,
'frequency_cap_value': null,
'start_date': null,
'end_date': null,
'day_parting': [],
'day_parting_users_timezone': null,
'created_at': '2018-06-21T12:56:50.436Z'
},
'third_party_fee': '0.0',
'third_party_fee_metric': 0
}
Get a Demand Partner
SDK
In [1]: partner = springserve.demand_partners.get(1764) In [2]: print partner.name "API Docs partner"
REST API
GET /api/v0/demand_partners/<id>
Headers
Content-Type application/json Authorization "yourAuthToken"
Response
Status code 200
{
'account_id': 1,
'buy_flagged_supply': True,
'default_tier': 1,
'direct_connect': False,
'id': 1764,
'name': 'API Docs partner',
'targeting_page_attribute_profile': {
'id': 123,
'user_agent_devices': [],
'user_agent_operating_systems': [],
'detected_player_size_targeting': false,
'player_sizes': [
'xs',
's',
'm',
'l',
'xl',
'u'
],
'detected_domain_targeting': null,
'domain_white_list': '',
'domain_list_ids': [],
'app_bundle_white_list': '',
'app_bundle_list_ids': [],
'app_name_white_list': '',
'app_name_list_ids': [],
'key_value_targeting': null,
'key_values': null,
'targeting_secure': false,
'goal_targetings': [],
'realtime_viewability': false,
'min_aspect_ratio': null,
'max_aspect_ratio': null,
'device_id_required': null,
'ip_white_list': '',
'ip_list_ids': [],
'created_at': '2018-06-21T12:56:50.442Z'
},
'targeting_spend_profile': {
'id': 5678,
'budget_metric': null,
'budget_period': null,
'budget_pacing': null,
'budget_value': null,
'created_at': '2018-06-21T12:56:50.432Z'
},
'targeting_time_profile': {
'id': 91011,
'frequency_cap_period': null,
'frequency_cap_period_amount': null,
'frequency_cap_metric': null,
'frequency_cap_value': null,
'start_date': null,
'end_date': null,
'day_parting': [],
'day_parting_users_timezone': null,
'created_at': '2018-06-21T12:56:50.436Z'
},
'third_party_fee': '0.0',
'third_party_fee_metric': 0
}
Edit a Demand Partner
SDK
In [1]: partner = springserve.demand_partners.get(1764) In [2]: partner.name = "I want to change the name" In [3]: changed = partner.save() In [4]: changed.ok Out [5]: True In [5]: print changed.name "I want to change the name"
REST API
PUT /api/v0/demand_partners/<id>
Headers
Content-Type application/json Authorization "yourAuthToken"
Body (example)
{ "name": "I want to change the name"} |
Response
Status code 200
{
'account_id': 1,
'buy_flagged_supply': True,
'default_tier': 1,
'direct_connect': False,
'id': 1764,
'name': 'I want to change the name',
'targeting_page_attribute_profile': {
'id': 123,
'user_agent_devices': [],
'user_agent_operating_systems': [],
'detected_player_size_targeting': false,
'player_sizes': [
'xs',
's',
'm',
'l',
'xl',
'u'
],
'detected_domain_targeting': null,
'domain_white_list': '',
'domain_list_ids': [],
'app_bundle_white_list': '',
'app_bundle_list_ids': [],
'app_name_white_list': '',
'app_name_list_ids': [],
'key_value_targeting': null,
'key_values': null,
'targeting_secure': false,
'goal_targetings': [],
'realtime_viewability': false,
'min_aspect_ratio': null,
'max_aspect_ratio': null,
'device_id_required': null,
'ip_white_list': '',
'ip_list_ids': [],
'created_at': '2018-06-21T12:56:50.442Z'
},
'targeting_spend_profile': {
'id': 5678,
'budget_metric': null,
'budget_period': null,
'budget_pacing': null,
'budget_value': null,
'created_at': '2018-06-21T12:56:50.432Z'
},
'targeting_time_profile': {
'id': 91011,
'frequency_cap_period': null,
'frequency_cap_period_amount': null,
'frequency_cap_metric': null,
'frequency_cap_value': null,
'start_date': null,
'end_date': null,
'day_parting': [],
'day_parting_users_timezone': null,
'created_at': '2018-06-21T12:56:50.436Z'
},
'third_party_fee': '0.0',
'third_party_fee_metric': 0
}
, multiple selections available,