Advertisement
Not a member of Pastebin yet?
Sign Up,
it unlocks many cool features!
- ---
- swagger: "2.0"
- info:
- version: "6.3-SNAPSHOT"
- title: "campaign-service"
- tags:
- - name: "Ads"
- description: "Ads operations"
- - name: "Banner Areas"
- description: "Banner Areas operations"
- - name: "Campaigns"
- description: "Campaign operations"
- - name: "Goals"
- description: "goal operations"
- - name: "VAST URLs"
- description: "VAST Operations."
- paths:
- /campaign-internal/v3/sites:
- get:
- summary: "getSites"
- description: ""
- operationId: "getSites"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "option"
- in: "query"
- required: false
- type: "array"
- items:
- type: "string"
- collectionFormat: "multi"
- responses:
- 200:
- description: "OK"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/Site"
- 500:
- description: "Internal Server Error"
- /campaign-internal/v3/sites/{siteId}:
- get:
- summary: "getSite"
- description: ""
- operationId: "getSite"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "option"
- in: "query"
- required: false
- type: "array"
- items:
- type: "string"
- collectionFormat: "multi"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/Site"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- /campaign-internal/v3/sites/{siteId}/advertisers:
- get:
- operationId: "getAdvertisers"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 200:
- description: "successful operation"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/Client"
- /campaign-internal/v3/sites/{siteId}/agencies:
- get:
- operationId: "getAgencies"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 200:
- description: "successful operation"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/Client"
- /campaign-internal/v3/sites/{siteId}/brands:
- get:
- operationId: "getBrands"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 200:
- description: "successful operation"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/Client"
- /campaign-internal/v3/sites/{siteId}/categories:
- get:
- operationId: "getCategories"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "leaves"
- in: "query"
- required: false
- type: "string"
- enum:
- - "PRESENT"
- - "ABSENT"
- responses:
- 200:
- description: "successful operation"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/Category"
- /campaign-internal/v3/sites/{siteId}/categories/{shareId}:
- get:
- operationId: "getCategory"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "shareId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 200:
- description: "successful operation"
- schema:
- $ref: "#/definitions/Category"
- /campaign-internal/v3/sites/{siteId}/content-partners:
- get:
- operationId: "getContentPartners"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 200:
- description: "successful operation"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/Share"
- /campaign-internal/v3/sites/{siteId}/devicecontainers:
- get:
- operationId: "getDeviceContainers"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "includeDeleted"
- in: "query"
- required: false
- type: "string"
- enum:
- - "PRESENT"
- - "ABSENT"
- responses:
- 200:
- description: "successful operation"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/DeviceContainer"
- /campaign-internal/v3/sites/{siteId}/devicecontainers/{deviceContainerId}:
- get:
- operationId: "getDeviceContainerByID"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "deviceContainerId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "includeDeleted"
- in: "query"
- required: false
- type: "string"
- enum:
- - "PRESENT"
- - "ABSENT"
- responses:
- 200:
- description: "successful operation"
- schema:
- $ref: "#/definitions/DeviceContainer"
- /campaign-internal/v3/sites/{siteId}/external-trackers:
- get:
- summary: "getExternalTrackers"
- description: ""
- operationId: "getExternalTrackers"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 200:
- description: "OK"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/ExternalTracker"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- post:
- summary: "createExternalTrackers"
- description: ""
- operationId: "createExternalTracker"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 201:
- description: "Created"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- put:
- summary: "replaceExternalTrackers"
- description: ""
- operationId: "replaceExternalTrackers"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 200:
- description: "OK"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- /campaign-internal/v3/sites/{siteId}/external-trackers/count:
- get:
- operationId: "countExternalTrackers"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 200:
- description: "OK"
- schema:
- type: "integer"
- format: "int64"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- /campaign-internal/v3/sites/{siteId}/options:
- get:
- operationId: "getOptions"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "startingWith"
- in: "query"
- required: false
- type: "string"
- responses:
- 200:
- description: "successful operation"
- schema:
- type: "object"
- additionalProperties:
- type: "string"
- post:
- operationId: "setOptions"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "siteId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- default:
- description: "successful operation"
- /v3/ads:
- get:
- tags:
- - "Ads"
- summary: "List Ads"
- description: ""
- operationId: "getAdsForSite"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "embed"
- in: "query"
- description: "Embed additional information about objects. Note that projections\
- \ is only available for goals."
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "projections"
- - "metrics"
- collectionFormat: "multi"
- enum:
- - "projections"
- - "metrics"
- - name: "metrics"
- in: "query"
- description: "Specify which metrics to return."
- required: false
- type: "array"
- items:
- type: "string"
- collectionFormat: "multi"
- enum:
- - "impression"
- - "clickThrough"
- - "start"
- - "complete"
- - "firstQuartile"
- - "midpoint"
- - "thirdQuartile"
- - "all"
- - name: "ads.created.before"
- in: "query"
- description: "Filter the result based on ad created date."
- required: false
- type: "string"
- - name: "ads.created.after"
- in: "query"
- description: "Filter the result based on ad created date."
- required: false
- type: "string"
- - name: "goal.id"
- in: "query"
- description: "Filter the result based on goal id."
- required: false
- type: "string"
- format: "uuid"
- - name: "pageSize"
- in: "query"
- description: "The number of entries to return in one page."
- required: false
- type: "integer"
- format: "int32"
- - name: "pageNumber"
- in: "query"
- description: "The page number"
- required: false
- type: "integer"
- format: "int32"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/Ads"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/ads/{adId}:
- get:
- tags:
- - "Ads"
- summary: "Get Ad by Id"
- description: ""
- operationId: "getAdByAdId"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "adId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "embed"
- in: "query"
- description: "Embed additional information about objects. Note that projections\
- \ is only available for goals."
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "projections"
- - "metrics"
- collectionFormat: "multi"
- enum:
- - "projections"
- - "metrics"
- - name: "metrics"
- in: "query"
- description: "Specify which metrics to return."
- required: false
- type: "array"
- items:
- type: "string"
- collectionFormat: "multi"
- enum:
- - "impression"
- - "clickThrough"
- - "start"
- - "complete"
- - "firstQuartile"
- - "midpoint"
- - "thirdQuartile"
- - "all"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/Ad"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/ads/{adId}/vasturl/category/{id}:
- get:
- tags:
- - "VAST URLs"
- summary: "Get VAST URLs by Ad and Category."
- description: ""
- operationId: "getVastUrlByAdIdAndCategory"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "adId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "id"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "rt"
- in: "query"
- description: "The format of the response ticket."
- required: false
- type: "string"
- default: "vast_3.0"
- enum:
- - "VAST_2_0"
- - "VAST_2_0_1"
- - "VAST_3_0"
- - "VMAP_1_0"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/VastUrl"
- 404:
- description: "Not Found"
- 412:
- description: "Precondition Failed"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/ads/{adId}/vasturl/content-partner/{id}:
- get:
- tags:
- - "VAST URLs"
- summary: "Get VAST URLs by Ad and Content Partner."
- description: ""
- operationId: "getVastUrlByAdIdAndContentPartner"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "adId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "id"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "rt"
- in: "query"
- description: "The format of the response ticket."
- required: false
- type: "string"
- default: "vast_3.0"
- enum:
- - "VAST_2_0"
- - "VAST_2_0_1"
- - "VAST_3_0"
- - "VMAP_1_0"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/VastUrl"
- 404:
- description: "Not Found"
- 412:
- description: "Precondition Failed"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/banner-areas:
- get:
- tags:
- - "Banner Areas"
- summary: "List Banner Areas"
- description: ""
- operationId: "getBannerAreas"
- produces:
- - "application/json"
- parameters: []
- responses:
- 200:
- description: "OK"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/BannerArea"
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/ErrorDetail"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/banner-areas/{id}:
- get:
- tags:
- - "Banner Areas"
- summary: "Get Banner Area by Id"
- description: ""
- operationId: "getBannerAreaById"
- produces:
- - "application/json"
- parameters:
- - name: "id"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/BannerArea"
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/ErrorDetail"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/campaigns:
- get:
- tags:
- - "Campaigns"
- summary: "List Campaigns"
- description: ""
- operationId: "getCampaigns"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "includeDeletedGoals"
- in: "query"
- description: "Indicates whether the API should include deleted goals in the\
- \ resulting campaign(s)."
- required: false
- type: "string"
- enum:
- - "PRESENT"
- - "ABSENT"
- - name: "includeDeletedCampaigns"
- in: "query"
- required: false
- type: "string"
- enum:
- - "PRESENT"
- - "ABSENT"
- - name: "campaigns.started.before"
- in: "query"
- description: "Filter the result based on campaign start time."
- required: false
- type: "string"
- - name: "campaigns.started.after"
- in: "query"
- description: "Filter the result based on campaign start time."
- required: false
- type: "string"
- - name: "campaigns.ended.before"
- in: "query"
- description: "Filter the result based on campaign end time."
- required: false
- type: "string"
- - name: "campaigns.ended.after"
- in: "query"
- description: "Filter the result based on campaign end time."
- required: false
- type: "string"
- - name: "campaign.state"
- in: "query"
- description: "Filter the result based on campaign state."
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "ENABLED"
- - "DISABLED"
- - "ARCHIVED"
- collectionFormat: "multi"
- enum:
- - "enabled"
- - "disabled"
- - "archived"
- - name: "ids"
- in: "query"
- required: false
- type: "array"
- items:
- type: "string"
- format: "uuid"
- collectionFormat: "multi"
- - name: "pageSize"
- in: "query"
- description: "The number of entries to return in one page."
- required: false
- type: "integer"
- format: "int32"
- - name: "pageNumber"
- in: "query"
- description: "The page number"
- required: false
- type: "integer"
- format: "int32"
- - name: "embed"
- in: "query"
- description: "Embed additional information about objects. Note that projections\
- \ is only available for goals."
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "projections"
- - "metrics"
- collectionFormat: "multi"
- enum:
- - "projections"
- - "metrics"
- - name: "metrics"
- in: "query"
- description: "Specify which metrics to return."
- required: false
- type: "array"
- items:
- type: "string"
- collectionFormat: "multi"
- enum:
- - "impression"
- - "clickThrough"
- - "start"
- - "complete"
- - "firstQuartile"
- - "midpoint"
- - "thirdQuartile"
- - "all"
- - name: "expand"
- in: "query"
- description: "Adding &expand=goals or &expand=ads will expand goals in campaigns\
- \ and ads in goals. If these are not supplied, links to the expandable objects\
- \ are returned"
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "goals"
- - "ads"
- collectionFormat: "multi"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/Campaigns"
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/ErrorDetail"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/campaigns/{campaignId}:
- get:
- tags:
- - "Campaigns"
- summary: "Get Campaign by Id"
- description: ""
- operationId: "getCampaignBySiteAndCampaignId"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "campaignId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "includeDeletedGoals"
- in: "query"
- description: "Indicates whether the API should include deleted goals in the\
- \ resulting campaign(s)."
- required: false
- type: "string"
- enum:
- - "PRESENT"
- - "ABSENT"
- - name: "embed"
- in: "query"
- description: "Embed additional information about objects. Note that projections\
- \ is only available for goals."
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "projections"
- - "metrics"
- collectionFormat: "multi"
- enum:
- - "projections"
- - "metrics"
- - name: "metrics"
- in: "query"
- description: "Specify which metrics to return."
- required: false
- type: "array"
- items:
- type: "string"
- collectionFormat: "multi"
- enum:
- - "impression"
- - "clickThrough"
- - "start"
- - "complete"
- - "firstQuartile"
- - "midpoint"
- - "thirdQuartile"
- - "all"
- - name: "expand"
- in: "query"
- description: "Adding &expand=goals or &expand=ads will expand goals in campaigns\
- \ and ads in goals. If these are not supplied, links to the expandable objects\
- \ are returned"
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "goals"
- - "ads"
- collectionFormat: "multi"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/Campaign"
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/ErrorDetail"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/campaigns/{campaignId}/vasturl/category/{id}:
- get:
- tags:
- - "VAST URLs"
- summary: "Get VAST URLs by Campaign and Category."
- description: ""
- operationId: "getVastUrlsByCampaignIdAndCategory"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "campaignId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "id"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "rt"
- in: "query"
- description: "The format of the response ticket."
- required: false
- type: "string"
- default: "vast_3.0"
- enum:
- - "VAST_2_0"
- - "VAST_2_0_1"
- - "VAST_3_0"
- - "VMAP_1_0"
- responses:
- 200:
- description: "OK"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/VastUrl"
- 404:
- description: "Not Found"
- 412:
- description: "Precondition Failed"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/campaigns/{campaignId}/vasturl/content-partner/{id}:
- get:
- tags:
- - "VAST URLs"
- summary: "Get VAST URLs by Campaign and Content Partner."
- description: ""
- operationId: "getVastUrlsByCampaignIdAndContentPartner"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "campaignId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "id"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "rt"
- in: "query"
- description: "The format of the response ticket."
- required: false
- type: "string"
- default: "vast_3.0"
- enum:
- - "VAST_2_0"
- - "VAST_2_0_1"
- - "VAST_3_0"
- - "VMAP_1_0"
- responses:
- 200:
- description: "OK"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/VastUrl"
- 404:
- description: "Not Found"
- 412:
- description: "Precondition Failed"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/goals:
- get:
- tags:
- - "Goals"
- summary: "List Goals"
- description: ""
- operationId: "getGoalsForSite"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "goals.started.before"
- in: "query"
- description: "Filter the result based on goal start time."
- required: false
- type: "string"
- - name: "goals.started.after"
- in: "query"
- description: "Filter the result based on goal start time."
- required: false
- type: "string"
- - name: "goals.ended.before"
- in: "query"
- description: "Filter the result based on goal end time."
- required: false
- type: "string"
- - name: "goals.ended.after"
- in: "query"
- description: "Filter the result based on goal end time."
- required: false
- type: "string"
- - name: "goal.name"
- in: "query"
- description: "Filter the result based on goal name."
- required: false
- type: "string"
- - name: "campaign.name"
- in: "query"
- description: "Filter the result based on campaign name."
- required: false
- type: "string"
- - name: "campaign.id"
- in: "query"
- description: "Filter the result based on campaign id."
- required: false
- type: "string"
- format: "uuid"
- - in: "body"
- name: "body"
- required: false
- schema:
- $ref: "#/definitions/GoalFlags"
- - name: "campaign.state"
- in: "query"
- description: "Filter the result based on campaign state."
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "enabled"
- - "disabled"
- - "archived"
- collectionFormat: "multi"
- - name: "pageSize"
- in: "query"
- description: "The number of entries to return in one page."
- required: false
- type: "integer"
- format: "int32"
- - name: "pageNumber"
- in: "query"
- description: "The page number"
- required: false
- type: "integer"
- format: "int32"
- - name: "sorting"
- in: "query"
- description: "If this is present, the goals will be sorted based on given\
- \ value."
- required: false
- type: "string"
- enum:
- - "priority"
- - "type"
- - "booked"
- - "start"
- - "end"
- - "goalName"
- - "campaignName"
- - name: "sortingOrder"
- in: "query"
- description: "Specifies the sorting order: ascending or descending."
- required: false
- type: "string"
- default: "ascending"
- enum:
- - "ascending"
- - "descending"
- - name: "embed"
- in: "query"
- description: "Embed additional information about objects. Note that projections\
- \ is only available for goals."
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "projections"
- - "metrics"
- collectionFormat: "multi"
- enum:
- - "projections"
- - "metrics"
- - name: "metrics"
- in: "query"
- description: "Specify which metrics to return."
- required: false
- type: "array"
- items:
- type: "string"
- collectionFormat: "multi"
- enum:
- - "impression"
- - "clickThrough"
- - "start"
- - "complete"
- - "firstQuartile"
- - "midpoint"
- - "thirdQuartile"
- - "all"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/GoalList"
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/ErrorDetail"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/goals/{goalId}:
- get:
- tags:
- - "Goals"
- summary: "Get Goal by Id"
- description: ""
- operationId: "getGoalBySiteAndGoalId"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "goalId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - in: "body"
- name: "body"
- required: false
- schema:
- $ref: "#/definitions/GoalFlags"
- - name: "embed"
- in: "query"
- description: "Embed additional information about objects. Note that projections\
- \ is only available for goals."
- required: false
- type: "array"
- items:
- type: "string"
- enum:
- - "projections"
- - "metrics"
- collectionFormat: "multi"
- enum:
- - "projections"
- - "metrics"
- - name: "metrics"
- in: "query"
- description: "Specify which metrics to return."
- required: false
- type: "array"
- items:
- type: "string"
- collectionFormat: "multi"
- enum:
- - "impression"
- - "clickThrough"
- - "start"
- - "complete"
- - "firstQuartile"
- - "midpoint"
- - "thirdQuartile"
- - "all"
- responses:
- 200:
- description: "OK"
- schema:
- $ref: "#/definitions/Goal"
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/ErrorDetail"
- 404:
- description: "Not Found"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/goals/{goalId}/vasturl/category/{id}:
- get:
- tags:
- - "VAST URLs"
- summary: "Get VAST URLs by Goal and Category."
- description: ""
- operationId: "getVastUrlsByGoalIdAndCategory"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "goalId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "id"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "rt"
- in: "query"
- description: "The format of the response ticket."
- required: false
- type: "string"
- default: "vast_3.0"
- enum:
- - "VAST_2_0"
- - "VAST_2_0_1"
- - "VAST_3_0"
- - "VMAP_1_0"
- responses:
- 200:
- description: "OK"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/VastUrl"
- 404:
- description: "Not Found"
- 412:
- description: "Precondition Failed"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- /v3/goals/{goalId}/vasturl/content-partner/{id}:
- get:
- tags:
- - "VAST URLs"
- summary: "Get VAST URLs by Goal and Content Partner"
- description: ""
- operationId: "getVastUrlsByGoalIdAndContentPartner"
- consumes:
- - "application/json"
- produces:
- - "application/json"
- parameters:
- - name: "goalId"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "id"
- in: "path"
- required: true
- type: "string"
- format: "uuid"
- - name: "rt"
- in: "query"
- description: "The format of the response ticket."
- required: false
- type: "string"
- default: "vast_3.0"
- enum:
- - "VAST_2_0"
- - "VAST_2_0_1"
- - "VAST_3_0"
- - "VMAP_1_0"
- responses:
- 200:
- description: "OK"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/VastUrl"
- 404:
- description: "Not Found"
- 412:
- description: "Precondition Failed"
- 500:
- description: "Internal Server Error"
- security:
- - OAuth 2.0: []
- - apiKey: []
- definitions:
- AbstractGoal:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- description: "AbstractGoal can be either GoalLink or Goal (with detail information\
- \ as queried)."
- Ad:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- example: "0a6dc27d-06d9-41aa-b360-ff279b7e316a"
- name:
- type: "string"
- example: "Ad name"
- minLength: 0
- maxLength: 250
- creative:
- $ref: "#/definitions/Creative"
- enabled:
- type: "boolean"
- campaign:
- description: "Id of the campaign this ad belongs to and a reference to the\
- \ campaign API."
- $ref: "#/definitions/Link"
- goal:
- description: "The id of the goal this ad belongs to and reference to the goal\
- \ API."
- $ref: "#/definitions/Link"
- metrics:
- $ref: "#/definitions/Metrics"
- description:
- type: "string"
- weight:
- $ref: "#/definitions/Weight"
- customId:
- type: "string"
- start:
- description: "The start date-time of this ad in ISO 8601 format (for instance\
- \ 2016-04-02T10:05:23+01:00). Value is fetched from goal if empty."
- $ref: "#/definitions/InheritedValueZonedDateTime"
- end:
- description: "The end date-time of this ad in ISO 8601 format (for instance\
- \ 2016-04-02T10:05:23+01:00). Value is fetched from goal, if empty, or omitted\
- \ if goal has no end date."
- $ref: "#/definitions/InheritedValueZonedDateTime"
- externalTrackers:
- type: "array"
- items:
- $ref: "#/definitions/ExternalTracker"
- deviceContainers:
- type: "array"
- description: "List of device groups targeted by the ad."
- items:
- $ref: "#/definitions/Link"
- created:
- type: "string"
- format: "date-time"
- example: "2016-04-01T10:05:23+01:00"
- description: "The created date-time of this ad in ISO 8601 format."
- modified:
- type: "string"
- format: "date-time"
- example: "2016-04-01T10:05:23+01:00"
- description: "The last modification date-time of this ad in ISO 8601 format."
- description: "The public representation of an Ad."
- Ads:
- type: "object"
- properties:
- ads:
- type: "array"
- readOnly: true
- items:
- $ref: "#/definitions/Ad"
- pagination:
- readOnly: true
- $ref: "#/definitions/Pagination"
- AdsWrapper:
- type: "object"
- description: "AdsWrapper can be either list of AdLinks or list of Ads according\
- \ to supplied 'expand' parameter value."
- BannerArea:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- description:
- type: "string"
- type:
- type: "string"
- enum:
- - "companionBannerJavascript"
- - "companionBannerFlash"
- name:
- type: "string"
- height:
- type: "integer"
- format: "int32"
- width:
- type: "integer"
- format: "int32"
- Campaign:
- type: "object"
- required:
- - "id"
- - "name"
- properties:
- name:
- type: "string"
- description: "The name of this campaign."
- priority:
- $ref: "#/definitions/InheritedValueInteger"
- id:
- type: "string"
- format: "uuid"
- description: "The unique id of this campaign."
- state:
- type: "string"
- description: "State can be [DISABLED, ENABLED, ARCHIVED, DELETED]."
- enum:
- - "DISABLED"
- - "ENABLED"
- - "ARCHIVED"
- goals:
- type: "array"
- items:
- $ref: "#/definitions/AbstractGoal"
- description:
- type: "string"
- description: "An optional String describing the campaign."
- end:
- type: "string"
- format: "date-time"
- description: "End date is equal to the end date of the last goal within this\
- \ campaign."
- metrics:
- $ref: "#/definitions/Metrics"
- agency:
- $ref: "#/definitions/Link"
- brand:
- $ref: "#/definitions/Link"
- advertiser:
- $ref: "#/definitions/Link"
- ignoreGlobalExternalTrackers:
- type: "boolean"
- description: "Whether this campaign should ignore global external trackers."
- includedInForecast:
- type: "boolean"
- description: "Indicate whether campaign is included in forecast."
- exclusive:
- type: "boolean"
- description: "Indicate whether campaign is exclusive."
- deleted:
- type: "boolean"
- frontLoad:
- $ref: "#/definitions/InheritedValueInteger"
- sequenceScope:
- type: "string"
- enum:
- - "SESSION"
- - "LIFETIME"
- start:
- type: "string"
- format: "date-time"
- description: "Start date is equal to the start date of the earliest goal within\
- \ this campaign."
- customId:
- type: "string"
- description: "An optional custom id for this campaign."
- Campaigns:
- type: "object"
- properties:
- campaigns:
- type: "array"
- readOnly: true
- items:
- $ref: "#/definitions/Campaign"
- pagination:
- readOnly: true
- $ref: "#/definitions/Pagination"
- Cap:
- type: "object"
- properties:
- capType:
- type: "string"
- enum:
- - "dailycap"
- - "totalcap"
- capValue:
- type: "integer"
- format: "int64"
- Category:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- readOnly: true
- description:
- type: "string"
- readOnly: true
- name:
- type: "string"
- readOnly: true
- parent:
- type: "string"
- format: "uuid"
- readOnly: true
- visible:
- type: "boolean"
- readOnly: true
- shareGroup:
- type: "string"
- format: "uuid"
- readOnly: true
- parentTrail:
- type: "array"
- readOnly: true
- items:
- $ref: "#/definitions/PairUUIDString"
- enabled:
- type: "boolean"
- readOnly: true
- Client:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- readOnly: true
- type:
- type: "string"
- readOnly: true
- enum:
- - "ADVERTISER"
- - "AGENCY"
- - "BRAND"
- created:
- type: "string"
- format: "date-time"
- readOnly: true
- modified:
- type: "string"
- format: "date-time"
- readOnly: true
- name:
- type: "string"
- readOnly: true
- CompanionBanner:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "asset"
- properties:
- bannerArea:
- $ref: "#/definitions/Link"
- asset:
- $ref: "#/definitions/Link"
- clickDestinationUri:
- type: "string"
- example: "http://click-destination-uri.com"
- template:
- type: "string"
- example: "<a href='{clickurl}{urlenc(ad.linkurl)}'><img src='{ad.banner}'\
- \ width='{zone.width}' height='{zone.height}' border='0' /></a>"
- type:
- type: "string"
- example: "companionBanner"
- readOnly: true
- enum:
- - "companionBanner"
- CompanionBannerThirdparty:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- properties:
- bannerArea:
- $ref: "#/definitions/Link"
- template:
- type: "string"
- example: "<a href='{clickurl}{urlenc(ad.linkurl)}'><img src='{ad.banner}'\
- \ width='{zone.width}' height='{zone.height}' border='0' /></a>"
- type:
- type: "string"
- example: "companionBannerThirdparty"
- readOnly: true
- enum:
- - "companionBannerThirdparty"
- Creative:
- type: "object"
- discriminator: "type"
- properties:
- type:
- type: "string"
- example: "standardPlaceholder"
- readOnly: true
- enum:
- - "standard"
- - "standardThirdparty"
- - "iptv"
- - "iptvPlaceholder"
- - "pause"
- - "overlay"
- - "companionBanner"
- - "companionBannerThirdparty"
- - "standardPlaceholder"
- - "overlayPlaceholder"
- - "pausePlaceholder"
- - "takeover"
- - "takeoverPlaceholder"
- - "takeoverThirdparty"
- - "pixeltracker"
- - "rtb"
- - "rtbPlaceholder"
- - "placeholder1"
- - "placeholder1Thirdparty"
- - "placeholder1Placeholder"
- - "unknown"
- DeviceContainer:
- type: "object"
- properties:
- name:
- type: "string"
- id:
- type: "string"
- format: "uuid"
- position:
- type: "integer"
- format: "int32"
- siteId:
- type: "string"
- format: "uuid"
- shortName:
- type: "string"
- visible:
- type: "boolean"
- ErrorDetail:
- type: "object"
- properties:
- message:
- type: "string"
- invalidValue:
- type: "object"
- propertyPath:
- type: "string"
- ExpandFlags:
- type: "object"
- properties:
- expand:
- type: "array"
- items:
- type: "string"
- ExternalTracker:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- readOnly: true
- url:
- type: "string"
- readOnly: true
- event:
- type: "string"
- example: "IMPRESSION"
- readOnly: true
- enum:
- - "IMPRESSION"
- - "CLICK_THROUGH"
- - "AD_START"
- - "AD_FIRST_QUARTILE"
- - "AD_MIDPOINT"
- - "AD_THIRD_QUARTILE"
- - "AD_COMPLETE"
- - "MUTE"
- - "UNMUTE"
- - "PAUSE"
- - "REWIND"
- - "RESUME"
- - "FULLSCREEN"
- - "EXPAND"
- - "CLOSE"
- Goal:
- allOf:
- - $ref: "#/definitions/AbstractGoal"
- - type: "object"
- properties:
- name:
- type: "string"
- priority:
- $ref: "#/definitions/InheritedValueInteger"
- type:
- type: "string"
- target:
- $ref: "#/definitions/Target"
- variant:
- type: "string"
- enum:
- - "normal"
- - "sponsor"
- description:
- type: "string"
- campaign:
- $ref: "#/definitions/Link"
- end:
- type: "string"
- format: "date-time"
- description: "An ISO-8601 formatted date-time string."
- metrics:
- $ref: "#/definitions/Metrics"
- ads:
- $ref: "#/definitions/AdsWrapper"
- cap:
- $ref: "#/definitions/Cap"
- pricing:
- $ref: "#/definitions/Pricing"
- deleted:
- type: "boolean"
- adPosition:
- type: "string"
- enum:
- - "any"
- - "first"
- - "last"
- - "firstOrLast"
- - "breakExclusive"
- goalSequence:
- $ref: "#/definitions/GoalSequence"
- projectedDelivery:
- type: "integer"
- format: "int32"
- skipSettings:
- $ref: "#/definitions/InheritedValueSkipSettings"
- frontLoad:
- example: "50"
- $ref: "#/definitions/InheritedValueInteger"
- start:
- type: "string"
- format: "date-time"
- description: "An ISO-8601 formatted date-time string."
- customId:
- type: "string"
- description: "Representation of a Goal."
- GoalFlags:
- type: "object"
- properties:
- expandFlags:
- $ref: "#/definitions/ExpandFlags"
- GoalLink:
- allOf:
- - $ref: "#/definitions/AbstractGoal"
- - type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- example: "5c4de482-b71a-4014-bfed-81df1ccfe4bd"
- description: "The id of the entity."
- href:
- type: "string"
- format: "uri"
- example: "/v1/goal/{goalId}"
- description: "The link to the API containing the entity's details."
- description: "Representation of a GoalLink, used when listing goals in a non\
- \ expanded mode."
- GoalList:
- type: "object"
- properties:
- goals:
- type: "array"
- readOnly: true
- items:
- $ref: "#/definitions/Goal"
- pagination:
- readOnly: true
- $ref: "#/definitions/Pagination"
- GoalSequence:
- type: "object"
- properties:
- sequence:
- type: "integer"
- format: "int32"
- totalAmountOfGoals:
- type: "integer"
- format: "int32"
- sequenceScope:
- type: "string"
- enum:
- - "session"
- - "lifetime"
- InheritedValue:
- type: "object"
- properties:
- value:
- type: "object"
- origin:
- description: "Indicates that a value is inherited from another entity. If\
- \ the value is not inherited this object is omitted."
- $ref: "#/definitions/Origin"
- description: "Indication of origin of value."
- InheritedValueInteger:
- type: "object"
- properties:
- value:
- type: "integer"
- format: "int32"
- origin:
- description: "Indicates that a value is inherited from another entity. If\
- \ the value is not inherited this object is omitted."
- $ref: "#/definitions/Origin"
- description: "Indication of origin of value."
- InheritedValueSkipSettings:
- type: "object"
- properties:
- value:
- $ref: "#/definitions/SkipSettings"
- origin:
- description: "Indicates that a value is inherited from another entity. If\
- \ the value is not inherited this object is omitted."
- $ref: "#/definitions/Origin"
- description: "Indication of origin of value."
- InheritedValueZonedDateTime:
- type: "object"
- properties:
- value:
- type: "string"
- format: "date-time"
- origin:
- description: "Indicates that a value is inherited from another entity. If\
- \ the value is not inherited this object is omitted."
- $ref: "#/definitions/Origin"
- description: "Indication of origin of value."
- Iptv:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "insertionPoint"
- - "videoCreativeId"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- readOnly: true
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- videoCreativeId:
- type: "string"
- readOnly: true
- clickDestinationUri:
- type: "string"
- example: "http://click-destination-uri.com"
- readOnly: true
- estimatedAdDuration:
- type: "integer"
- format: "int64"
- example: 42
- readOnly: true
- type:
- type: "string"
- example: "iptv"
- readOnly: true
- enum:
- - "iptv"
- IptvPlaceholder:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "insertionPoint"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- type:
- type: "string"
- example: "iptvPlaceholder"
- readOnly: true
- enum:
- - "iptvPlaceholder"
- Link:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- example: "5c4de482-b71a-4014-bfed-81df1ccfe4bd"
- description: "The id of the entity."
- href:
- type: "string"
- format: "uri"
- example: "/v1/goal/{goalId}"
- description: "The link to the API containing the entity's details."
- description: "A structure containing the id of a certain entity and a link to\
- \ the API where its details can be found."
- Metrics:
- type: "object"
- properties:
- impression:
- type: "integer"
- format: "int32"
- readOnly: true
- error:
- type: "string"
- example: "Could not connect to metrics service."
- description: "If an error occurs while embedding metrics, the reason will\
- \ be displayed here."
- readOnly: true
- clickThrough:
- type: "integer"
- format: "int32"
- readOnly: true
- start:
- type: "integer"
- format: "int32"
- readOnly: true
- firstQuartile:
- type: "integer"
- format: "int32"
- readOnly: true
- midpoint:
- type: "integer"
- format: "int32"
- readOnly: true
- thirdQuartile:
- type: "integer"
- format: "int32"
- readOnly: true
- complete:
- type: "integer"
- format: "int32"
- readOnly: true
- delivered:
- type: "integer"
- format: "int32"
- readOnly: true
- ctr:
- type: "number"
- format: "double"
- readOnly: true
- completionRate:
- type: "number"
- format: "double"
- readOnly: true
- ecpm:
- type: "number"
- format: "double"
- readOnly: true
- description: "Representation of Metrics."
- Origin:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- example: "5c4de482-b71a-4014-bfed-81df1ccfe4bd"
- description: "The id of the entity."
- href:
- type: "string"
- format: "uri"
- example: "/v1/goal/{goalId}"
- description: "The link to the API containing the entity's details."
- entity:
- type: "string"
- example: "/v1/resource/{resourceId}"
- description: "The entity type containing the inherited value."
- enum:
- - "SITE"
- - "CAMPAIGN"
- - "GOAL"
- - "AD"
- description: "Representation of where a certain value is resolved from."
- Overlay:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "asset"
- properties:
- asset:
- $ref: "#/definitions/Link"
- clickDestinationUri:
- type: "string"
- example: "http://click-destination-uri.com"
- linkText:
- type: "string"
- example: "Click here"
- type:
- type: "string"
- example: "overlay"
- readOnly: true
- enum:
- - "overlay"
- OverlayPlaceholder:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- properties:
- type:
- type: "string"
- example: "overlayPlaceholder"
- readOnly: true
- enum:
- - "overlayPlaceholder"
- Pagination:
- type: "object"
- properties:
- totalCount:
- type: "integer"
- format: "int32"
- readOnly: true
- pageSize:
- type: "integer"
- format: "int32"
- readOnly: true
- pageNumber:
- type: "integer"
- format: "int32"
- readOnly: true
- Pair:
- type: "object"
- properties:
- value:
- type: "object"
- key:
- type: "object"
- right:
- type: "object"
- left:
- type: "object"
- PairUUIDString:
- type: "object"
- properties:
- value:
- type: "string"
- key:
- type: "string"
- format: "uuid"
- right:
- type: "string"
- left:
- type: "string"
- format: "uuid"
- Pause:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "asset"
- properties:
- asset:
- $ref: "#/definitions/Link"
- clickDestinationUri:
- type: "string"
- example: "http://some-url"
- type:
- type: "string"
- example: "pause"
- readOnly: true
- enum:
- - "pause"
- PausePlaceholder:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- properties:
- type:
- type: "string"
- example: "pausePlaceholder"
- readOnly: true
- enum:
- - "pausePlaceholder"
- Pixeltracker:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "insertionPoint"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- readOnly: true
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- clickDestinationUri:
- type: "string"
- example: "http://click-destination-uri.com"
- readOnly: true
- type:
- type: "string"
- example: "pixeltracker"
- readOnly: true
- enum:
- - "pixeltracker"
- Placeholder1:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "asset"
- properties:
- asset:
- $ref: "#/definitions/Link"
- clickDestinationUri:
- type: "string"
- example: "http://click-destination-uri.com"
- type:
- type: "string"
- example: "placeholder1"
- readOnly: true
- enum:
- - "placeholder1"
- Placeholder1Placeholder:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- properties:
- type:
- type: "string"
- example: "placeholder1Placeholder"
- readOnly: true
- enum:
- - "placeholder1Placeholder"
- Placeholder1Thirdparty:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "vastUri"
- properties:
- vastUri:
- type: "string"
- example: "http://vast-uri-example.com"
- vpaidStrict:
- type: "boolean"
- example: true
- vpaidCountdown:
- type: "boolean"
- example: false
- estimatedAdDuration:
- type: "integer"
- format: "int64"
- example: 42
- type:
- type: "string"
- example: "placeholder1Thirdparty"
- readOnly: true
- enum:
- - "placeholder1Thirdparty"
- Pricing:
- type: "object"
- properties:
- value:
- type: "number"
- pricingModel:
- type: "string"
- enum:
- - "BUDGET"
- - "CPM"
- - "CPMV_25"
- - "CPMV_50"
- - "CPMV_75"
- - "CPMV_100"
- - "CPC"
- - "NO_PRICING"
- Rtb:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "insertionPoint"
- - "marketplaceId"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- readOnly: true
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- marketplaceId:
- type: "integer"
- format: "int64"
- example: 42
- readOnly: true
- type:
- type: "string"
- example: "rtb"
- readOnly: true
- enum:
- - "rtb"
- RtbPlaceholder:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "insertionPoint"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- readOnly: true
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- type:
- type: "string"
- example: "rtbPlaceholder"
- readOnly: true
- enum:
- - "rtbPlaceholder"
- Share:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- readOnly: true
- description:
- type: "string"
- readOnly: true
- name:
- type: "string"
- readOnly: true
- parent:
- type: "string"
- format: "uuid"
- readOnly: true
- visible:
- type: "boolean"
- readOnly: true
- shareGroup:
- type: "string"
- format: "uuid"
- readOnly: true
- enabled:
- type: "boolean"
- readOnly: true
- Site:
- type: "object"
- properties:
- id:
- type: "string"
- format: "uuid"
- readOnly: true
- customerId:
- type: "string"
- format: "uuid"
- readOnly: true
- name:
- type: "string"
- readOnly: true
- description:
- type: "string"
- readOnly: true
- language:
- type: "string"
- readOnly: true
- timezone:
- type: "string"
- readOnly: true
- subdomain:
- type: "string"
- readOnly: true
- visible:
- type: "boolean"
- readOnly: true
- externalTrackers:
- type: "array"
- readOnly: true
- uniqueItems: true
- items:
- $ref: "#/definitions/ExternalTracker"
- options:
- type: "object"
- readOnly: true
- additionalProperties:
- type: "string"
- SkipOffset:
- type: "object"
- properties:
- value:
- type: "integer"
- format: "int32"
- description: "Skip setting offset."
- unit:
- type: "string"
- description: "Skip setting offset time unit."
- enum:
- - "seconds"
- - "percent"
- SkipSettings:
- type: "object"
- properties:
- resetAfter:
- type: "integer"
- format: "int32"
- description: "Skip setting reset interval, given in hours."
- enum:
- - 1
- - 2
- - 3
- - 6
- - 12
- - 24
- - 36
- - 48
- showWhen:
- type: "string"
- description: "Skip setting strategy."
- enum:
- - "never"
- - "always"
- - "afterFirstImpression"
- skipOffset:
- $ref: "#/definitions/SkipOffset"
- parentOverride:
- type: "boolean"
- description: "Skip setting override indicator. When set to false, no override\
- \ exists in the campaign>goal>ad hierarchy, or the skip policy is not set\
- \ on the current object. When set to true, the skip policy is overriden\
- \ somewhere in the hierarchy (campaign > goal > ad) of the current object.\
- \ A reference to the object where the skip policy comes from is available\
- \ in the origin object."
- Standard:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "asset"
- - "insertionPoint"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- readOnly: true
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- asset:
- readOnly: true
- $ref: "#/definitions/Link"
- clickDestinationUri:
- type: "string"
- example: "http://click-destination-uri.com"
- readOnly: true
- type:
- type: "string"
- example: "standard"
- readOnly: true
- enum:
- - "standard"
- StandardPlaceholder:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "insertionPoint"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- type:
- type: "string"
- example: "standardPlaceholder"
- readOnly: true
- enum:
- - "standardPlaceholder"
- StandardThirdparty:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "insertionPoint"
- - "vastUri"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- readOnly: true
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- vastUri:
- type: "string"
- example: "http://vast-uri-example.com"
- readOnly: true
- vpaidStrict:
- type: "boolean"
- example: true
- readOnly: true
- vpaidCountdown:
- type: "boolean"
- example: false
- readOnly: true
- estimatedAdDuration:
- type: "integer"
- format: "int64"
- example: 42
- readOnly: true
- type:
- type: "string"
- example: "standardThirdparty"
- readOnly: true
- enum:
- - "standardThirdparty"
- Takeover:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "asset"
- - "insertionPoint"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- readOnly: true
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- asset:
- readOnly: true
- $ref: "#/definitions/Link"
- clickDestinationUri:
- type: "string"
- example: "http://click-destination-uri.com"
- readOnly: true
- type:
- type: "string"
- example: "takeover"
- readOnly: true
- enum:
- - "takeover"
- TakeoverPlaceholder:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "insertionPoint"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- type:
- type: "string"
- example: "takeoverPlaceholder"
- readOnly: true
- enum:
- - "takeoverPlaceholder"
- TakeoverThirdparty:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- required:
- - "insertionPoint"
- - "vastUri"
- properties:
- insertionPoint:
- type: "string"
- example: "preroll"
- readOnly: true
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- vastUri:
- type: "string"
- example: "http://vast-uri-example.com"
- readOnly: true
- vpaidStrict:
- type: "boolean"
- example: true
- readOnly: true
- vpaidCountdown:
- type: "boolean"
- example: false
- readOnly: true
- estimatedAdDuration:
- type: "integer"
- format: "int64"
- example: 42
- readOnly: true
- type:
- type: "string"
- example: "takeoverThirdparty"
- readOnly: true
- enum:
- - "takeoverThirdparty"
- Target:
- type: "object"
- Unknown:
- allOf:
- - $ref: "#/definitions/Creative"
- - type: "object"
- properties:
- unknownType:
- type: "string"
- type:
- type: "string"
- example: "unknown"
- readOnly: true
- enum:
- - "unknown"
- description: "Representation of invalid parameters."
- VastUrl:
- type: "object"
- properties:
- formatType:
- type: "string"
- example: "preroll"
- description: "Type of ad."
- enum:
- - "preroll"
- - "midroll"
- - "postroll"
- - "overlay"
- - "companionBanner"
- - "inskin"
- - "splash"
- - "seekroll"
- - "pauseAd"
- vastUrl:
- type: "string"
- format: "url"
- example: "http://domain.videoplaza.test/proxy/distributor/v2?s=5c4de482-b71a-4014-bfed-81df1ccfe4bc&tt=p&rt=vast_3.0&rnd=12341341234&xgid=5c4de482-b71a-4014-bfed-81df1ccfe4bd"
- description: "Representation of a Vast URL."
- description: "Representation of VastUrl for a specific ad-type."
- Weight:
- type: "object"
- required:
- - "proportional"
- - "totalOverridden"
- - "value"
- properties:
- proportional:
- type: "boolean"
- description: "Indicates if this ad's weight is proportionally split between\
- \ ads of the same format or ads of the same insertion point, or it is manually\
- \ overridden."
- totalOverridden:
- type: "number"
- format: "double"
- description: "Sum of all overridden weights for ads of the same format and\
- \ insertion point."
- minimum: 0
- maximum: 1
- value:
- type: "number"
- format: "double"
- description: "Specify how often a specific ad should be picked out of multiple\
- \ ads of the same ad format or insertion point, possible values are 0.0\
- \ to 1.0."
- minimum: 0
- maximum: 1
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement