Skip to main content

GET All Select Options

Overview


The following table contains important information about the GET method in regards to receiving all select options for ad schedules.

GET All Select Options
MethodGET
URL or Endpoint/api/projects/projectId/ad-schedules/select-options
HeadersAuthorization
ParametersprojectId
BodyNot Applicable

The description of the URL parameters is as follows:

URL Parameter NameMandatoryTypeDescription
projectIdYesstringUnique ID of the project.

Request Body

The request does not contain a request body.

Response

{
"success": true,
"errors": [],
"messages": [],
"result": {
"adManagerOptions": [
{
"id": 0,
"Value": "{Value}"
}
],
"vpaidModeOptions": [
{
"id": 0,
"name": "{name}"
}
],
"adSeenOnSubsequentVisitOptions": [
{
"id": 0,
"name": "{name}"
}
],
"adBreakTypeOptions": [
{
"id": 0,
"name": "{name}"
}
],
"breakTimingTypeOptions": [
{
"id": 0,
"name": "{name}"
}
],
"biddingTemplateOptions": [
{
"name": "{name}",
"publicId": "{publicId}",
"mediationOptionId": 0,
"biddingTemplateBidders": [
{
"id": 0,
"biddingTemplatePublicId": "{biddingTemplatePublicId}",
"bidderAlias": "{bidderAlias}",
"bidderId": 0,
"name": "{name}",
"bidderLogoPath": "{bidderLogoPath}",
"bidParamValues": [
{
"id": 0,
"biddingTemplateBidderId": 0,
"bidParamId": 0,
"value": "{value}",
"placeholder": "{placeholder}"
}
]
}
]
}
],
"adScheduleTypeOptions": [
{
"id": 0,
"name": "{name}",
"value": "{value}",
"description": "{description}"
}
],
"distributionMethodTypeOptions": [
{
"id": 0,
"name": "{name}",
"value": "{value}",
"description": "{description}"
}
],
"midrollTypeOptions": [
{
"id": 0,
"name": "{name}",
"value": "{value}",
"description": "{description}",
"icon": "{icon}"
}
],
"playerTypeOptions": [
{
"id": 0,
"name": "{name}",
"value": "{value}",
"description": "{description}"
}
]
},
"resultInfo": null,
"statusCode": 200
}

Information about the fields that appear when you receive the response are displayed in the table below.

Top-Level Properties

Field NameTypeDescription
successbooleanIf the response is successful it will return true. Otherwise will return false.
errorsarray[string]Indicates if there was an error.
messagesarray[string]Returns the response message from back-end.
resultobjectReturns the object containing all select option lists.
adManagerOptionsarray[object]Returns the available ad manager options.
vpaidModeOptionsarray[object]Returns the available VPAID mode options.
adSeenOnSubsequentVisitOptionsarray[object]Returns the ad seen on subsequent visit options.
adBreakTypeOptionsarray[object]Returns the available ad break type options.
breakTimingTypeOptionsarray[object]Returns the available break timing type options.
biddingTemplateOptionsarray[object]Returns the available bidding template options.
adScheduleTypeOptionsarray[object]Returns the available ad schedule type options.
distributionMethodTypeOptionsarray[object]Returns the available distribution method type options.
midrollTypeOptionsarray[object]Returns the available midroll type options.
playerTypeOptionsarray[object]Returns the available player type options.
resultInfostringReturns extra information about the result.
statusCodeintegerReturns the HTTP Status Code.

adManagerOptions Properties

Field NameTypeDescription
idintegerThe ID of the ad manager.
ValuestringThe name of the ad manager.

vpaidModeOptions Properties

Field NameTypeDescription
idintegerThe ID of the VPAID mode option.
namestringName of the VPAID mode option.

adSeenOnSubsequentVisitOptions Properties

Field NameTypeDescription
idintegerThe ID of the subsequent visit option.
namestringName of the subsequent visit option.

adBreakTypeOptions Properties

Field NameTypeDescription
idintegerThe ID of the ad break type.
namestringName of the ad break type.

breakTimingTypeOptions Properties

Field NameTypeDescription
idintegerThe ID of the break timing type.
namestringName of the break timing type.

biddingTemplateOptions Properties

Field NameTypeDescription
namestringThe name of the bidding template.
publicIdstringThe public ID of the bidding template.
mediationOptionIdintegerThe ID of the mediation option.
biddingTemplateBiddersarray[object]Returns the bidders associated with the bidding template.

biddingTemplateBidders Properties

Field NameTypeDescription
idintegerThe ID of the bidding template bidder.
biddingTemplatePublicIdstringThe public ID of the associated bidding template.
bidderAliasstringThe alias of the bidder.
bidderIdintegerThe ID of the bidder.
namestringThe name of the bidder.
bidderLogoPathstringThe path to the bidder's logo.
bidParamValuesarray[object]Returns the bid parameter values for this bidder.

bidParamValues Properties

Field NameTypeDescription
idintegerThe ID of the bid parameter value.
biddingTemplateBidderIdintegerThe ID of the associated bidding template bidder.
bidParamIdintegerThe ID of the bid parameter.
valuestringThe value of the bid parameter.
placeholderstringThe placeholder text for the bid parameter.

adScheduleTypeOptions Properties

Field NameTypeDescription
idintegerThe ID of the ad schedule type.
namestringName of the ad schedule type.
valuestringValue of the ad schedule type.
descriptionstringDescription of the ad schedule type.

distributionMethodTypeOptions Properties

Field NameTypeDescription
idintegerThe ID of the distribution method type.
namestringName of the distribution method type.
valuestringValue of the distribution method type.
descriptionstringDescription of the distribution method type.

midrollTypeOptions Properties

Field NameTypeDescription
idintegerThe ID of the midroll type.
namestringName of the midroll type.
valuestringValue of the midroll type.
descriptionstringDescription of the midroll type.
iconstringIcon identifier for the midroll type.

playerTypeOptions Properties

Field NameTypeDescription
idintegerThe ID of the player type.
namestringName of the player type.
valuestringValue of the player type.
descriptionstringDescription of the player type.

If the action is successful, the service sends back an HTTP 200 or 201 response.

Errors

For information about the errors that are common to all actions, see Common Errors:

  • HTTP Status Code 400: Bad Request

  • HTTP Status Code 401: Unauthorized

  • HTTP Status Code 403: Forbidden

  • HTTP Status Code 404: Result Not Found

  • HTTP Status Code 500: Internal Server Error

  • HTTP Status Code 503: Backend Fetch Failed