PUT Player
Overview
The following table contains important information about the PUT method in regards to updating a player.
| PUT Player | |
|---|---|
| Method | PUT |
| URL or Endpoint | /api/projects/projectId/players |
| Headers | Authorization |
| Parameters | id, projectId, api-version |
| Body | Not applicable. |
The description of the URL parameter is as follows:
| URL Parameter Name | Mandatory | Type | Description |
|---|---|---|---|
| id | Yes | string | Unique Id. |
| projectId | No | string | Unique Id of the project. |
| api-version | No | string | The correct api version to use. |
Request Body
{
"name": "string",
"loopContent": true,
"muteOnStart": true,
"floatOnScroll": true,
"autoPauseWhenNotViewable": true,
"enablePlayBackRateControls": true,
"sharing": true,
"casting": true,
"googleAnalytics": true,
"includeCompatibilityScript": true,
"showContentTitle": true,
"showContentDescription": true,
"showControls": true,
"recommendation": true,
"playlistId": 0,
"advertising": true,
"showControlsOnVPAID": true,
"outstreamPlayer": true,
"dispAdverisementAbove": true,
"autoCollapseAfterAds": true,
"preloadAds": true,
"companionAds": true,
"playAdsMuted": true,
"keepVisibleWhenControlsHidden": true,
"debug": true,
"theaterButton": true,
"chromeCastButton": true,
"nextButton": true,
"fullScreenButton": true,
"pictureInPictureButton": true,
"volumeButton": true,
"shareButton": true,
"airplayButton": true,
"bigPlayButton": true,
"settingsButton": true,
"autoPlay": true,
"floatDismissible": true,
"logoOn": true,
"adsRequireInteraction": true,
"focusOnAutoStart": true,
"floatOnMobile": true,
"floatRequiresInteraction": true,
"floatWidth": "string",
"floatBorder": "string",
"logoUrl": "string",
"logoOnClickUrl": "string",
"logoDefaultOpacity": 0,
"logoInactiveOpacity": 0,
"channelUrl": "string",
"width": 0,
"height": 0,
"adScheduleId": 0,
"playerSizeTypeId": 0,
"preloadOptionId": 0,
"defaultBandwidthEstimateOptionId": 0,
"sharingTypeId": 0,
"logoPositionOptionId": 0,
"floatPositionOptionId": 0,
"releaseChannelId": 0,
"sharingTooltip": "string",
"rightClickText": "string",
"rightClickUrl": "string",
"responsiveSizeOptionId": 0,
"countDownMessage": "string",
"cueText": "string",
"skipCountDown": "string",
"companionAdsDivID": "string",
"companionAdsWidth": 0,
"companionAdsHeight": 0,
"volume": 0,
"skipAmount": 0,
"highlightCurrentVideo": true,
"onHoverPlay": true,
"lightStreamingMode": true,
"showHelperButton": true,
"helperButtonImageUrl": "string",
"showLiveIcon": true,
"delayLiveVideosTime": 0,
"delayLiveVideos": true,
"showAutoPlay": true,
"showQualities": true,
"showSubtitles": true,
"controlsBackgroundAlpha": 0,
"Play": "string",
"Pause": "string",
"Next": "string",
"UpNext": "string",
"Replay": "string",
"Volume": "string",
"Mute": "string",
"UnMute": "string",
"Settings": "string",
"FullScreen": "string",
"Chromecast": "string",
"Airplay": "string",
"PictureInPicture": "string",
"SkipIntro": "string",
"ContinueWatching": "string",
"Quality": "string",
"Subtitles": "string",
"Autoplay": "string",
"PlaybackRate": "string",
"Auto": "string",
"Off": "string",
"Normal": "string",
"Share": "string",
"Theater": "string",
"Skip": "string",
"SkipIn": "string",
"Visit": "string",
"Info": "string",
"SimultaneousAds": "string",
"AutoplayOff": "string",
"AutoplayOn": "string",
"ZoomIn": "string",
"ZoomOut": "string",
"OriginalZoom": "string",
"ContinueAfterPause": "string",
"ApiErrorOverlay": "string",
"SourceErrorOverlay": "string",
"PlayerErrorOverlay": "string",
"CaptionsOff": "string",
"Live": "string",
"ChromeCastPlayingOn": "string",
"Dismiss": "string",
"PlayNow": "string",
"NextVideoCancel": "string",
"AdAnnouncement": "string",
"pauseOtherVideos": true,
"autoStartOnLoad": true,
"autoStartOnLoadMobile": true,
"autoStartOnLoadOnData": true,
"autoStartOnViewableOn": true,
"autoStartOnViewableMobile": true,
"autoStartOnViewableOnData": true,
"autoStartOnViewablePercentage": 0,
"autoPauseOnViewableOn": true,
"autoPauseOnViewablePercentage": 0,
"autoPauseOnCuePointState": true,
"autoPauseOnCuePointTimeToPause": 0,
"autoPauseOnCuePointContinueUnMuted": true,
"autoPauseOnCuePointOnDesktop": true,
"autoPauseOnCuePointOnMobile": true,
"autoPauseOnCuePointPlayButtonUrl": "string",
"pauseWhenRelatedIsShown": true,
"readQualities": true,
"enableGravityChange": true,
"forceSound": true,
"showPlayerControlsDuringVideoAdvertisement": true,
"enableHapticFeedbackOnButtonClick": true,
"enableHapticFeedbackOnPinchToZoom": true,
"usePortraitMode": true,
"adAnnouncementState": true,
"adAnnouncementTimeBeforeAd": 0,
"afterMidrollBacktrackState": true,
"afterMidrollBacktrackTime": 0,
"socialNetworkIds": [
0
],
"controlBarTextColor": "string",
"controlBarIconsDefaultColor": "string",
"controlBarIconsHoverColor": "string",
"controlBarTimesliderProgressColor": "string",
"controlBarTimesliderRailColor": "string",
"controlBarTimesliderDraggerColor": "string",
"controlBarBackgroundColor": "string",
"controlBarTimesliderBufferColor": "string",
"controlBarVolumeDraggerColor": "string",
"controlBarVolumeProgressColor": "string",
"controlBarVolumeRailColor": "string",
"controlBarVolumeNotifierColor": "string",
"controlBarTimeSliderOnAdDraggerColor": "string",
"controlBarTimeSliderOnAdProgressColor": "string",
"controlBarTimeSliderOnAdRailColor": "string",
"controlBarLoaderColor": "string",
"menuLinksDefaultColor": "string",
"menuLinksHoverColor": "string",
"menuBackroundDefaultColor": "string",
"menuBackroundHoverColor": "string",
"menuAutoplayOnColor": "string",
"menuAutoplayOffColor": "string",
"nextVideoBackgroundColor": "string",
"nextVideoTextColor": "string",
"nextVideoTsRailColor": "string",
"nextVideoTsProgressColor": "string",
"nextVideoTsIconsCloseColor": "string",
"nextVideoIconsPlayDefaultColor": "string",
"nextVideoIconsPlayHoverColor": "string",
"nextVideoCancelTextColor": "string",
"nextVideoCancelBackgroundColor": "string",
"nextVideoPlayNowTextColor": "string",
"nextVideoPlayNowBackgroundColor": "string",
"playlistBackgroundColor": "string",
"playlistTextColor": "string",
"playlistCardBackgroundColor": "string",
"playlistCardTitleColor": "string",
"playlistCardDurationTextColor": "string",
"playlistCardDurationBackgroundColor": "string",
"playlistCardIconPlayDefaulColor": "string",
"playlistCardIconPlayHoverColor": "string",
"playlistIconsArrActiveColor": "string",
"playlistIconsArrInactiveColor": "string",
"playlistIconsCloseColor": "string",
"tooltipsTextColor": "string",
"tooltipsBackroundColor": "string"
}
Information about the fields that appear when you type in the request body are displayed in the table below.
| Field Name | Type | Description |
|---|---|---|
| name | string | The name of the player. |
| loopContent | bool | Indicates whether the content should be looped. |
| muteOnStart | bool | Indicates whether the player is muted on start. |
| floatOnScroll | bool | Indicates whether the player should be in a float state when scrolling. |
| autoPauseWhenNotViewable | bool | Indicates whether the player should pause when it becomes unviewbale. |
| enablePlaybackRateControls | bool | Indicates whther the playback rate controls are enabled. |
| sharing | bool | Indicates whether the sharing option is available. |
| casting | bool | Indicates whether the casting option is available. |
| googleAnalytics | bool | Indicates whether Google Analytics are enabled. |
| includeCompatibilityScript | bool | Indicates wether the compatibility script is included. |
| showContentTitle | bool | Indicates whether the player should show the content title. |
| showContentDescription | bool | Indicates whether the playr should show the content description. |
| showControls | bool | Indicates whether the player should show the controls. |
| recommendation | bool | Indicates whether the recommendation section is enabled. |
| playlistId | integer | The Id of the playlist. |
| advertising | bool | Indicates whether advertising is enabled. |
| showControlsOnVPAID | bool | Indicates whether the player should show the controls on VPAID. |
| oustreamPlayer | bool | Indicates whether the player is outstreamed. |
| dispAdvertisementAbove | bool | Indicates whether the advertisement above the player should be displayed. |
| autoCollapseAfterAds | bool | Indicates whether the player should auto collapse after ads. |
| preloadAds | bool | Indicates whether ads should be preloaded. |
| companionAds | bool | Indicates whether companion ads are enabled. |
| playAdsMuted | bool | Indicates whether ads should be played on mute |
| keepVisibleWhenControlsHidden | bool | Indicates whether the player is visible when the controls are hidden. |
| debug | bool | Indicates wether debugging is enabled. |
| chromeCastButton | bool | Indicates whether the chromecast button is enabled. |
| nextButton | bool | Indicates whether the next button is enabled. |
| nextButton | bool | Indicates whether the next button is enabled. |
| fullScreenButton | bool | Indicates whether the fullscreen button is enabled. |
| pictureInPictureButton | bool | Indicates whether the picture in picture button is enabled. |
| volumeButton | bool | Indicates whether the volume button is enabled. |
| shareButton | bool | Indicates whether the share button is enabled. |
| airplayButton | bool | Indicates whether the airplay button is enabled. |
| bigPlayButton | bool | Indicates whether the play button is enabled. |
| settingsButton | bool | Indicates whether the settings button is enabled. |
| autoPlay | bool | Indicates whether auto play is enabled. |
| floatDismissible | bool | Indicates whether the float option is dismissible. |
| logoOn | bool | Indicates whether the logo is on the player. |
| adsRequireInteraction | bool | Indicates whether the ads require interaction. |
| focusOnAutoStart | bool | Indicates whether the player is in a focus state on auto start. |
| floatOnMobile | bool | Indicates whether the player should have a float state on mobile versions. |
| floatRequiresInteraction | bool | Indicates whether the float option requires interaction. |
| floatWidth | string | Indicates the width of the float |
| floatBorder | string | Indicates the border of the float |
| logoUrl | string | The URL of the logo. |
| logoOnClickUrl | string | The URL of the "on click" state of the logo. |
| logoDefaultOpacity | integer($int32) | The default opacity of the logo. |
| logoInactiveOpacity | integer($int32) | The opacity of the logo when it is inactive. |
| channelUrl | string | The URL of the channel. |
| width | integer($int32) | The width of the player. |
| height | integer($int32) | The height of the player |
| adScheduleId | integer($int32) | The Id of the ad schedule. |
| playerSizeTypeId | integer($int32) | The Id of the player size type. |
| sharingTypeId | integer($int32) | The id of the sharing type. |
| logoPositionOptionId | integer($int32) | The id of the logo position option. |
| floatPositionOption | integer($int32) | The id of the float position option. |
| releaseChannelId | integer($int32) | The id of the release channel. |
| responsiveOptionId | integer($int32) | The id of the responsive option. |
| sharingTooltip | string | The sharing tooltip. Appears when the cursor is positioned over the sharing icon. |
| rightClickText | string | The text that appears when you right-click. |
| rightClickUrl | string | The URL of the right-click. |
| countDownMessage | string | Indicates the time until the video starts. |
| cueText | string | The cue text of the ad. |
| skipCountDown | string | Indicates whether the countdown should be skipped. |
| companionAdsDivId | string | The div id of the companion ads. |
| companionAdsWidth | integer($int32) | The height of the companion ad. |
| companionAdsHeight | integer($int32) | The height of the companion ad. |
| volume | integer($int32) | The volume of the player. |
| skipAmount | integer($int32) | The amount of seconds a skip makes. |
| highlightCurrentVideo | bool | Indicates whether the current video has been highlighted. |
| onHoverPlay | bool | Indicates whether the hoverplay is on. |
| lightStreamingMode | bool | Indicates whether video quality and streaming are automatically adjusted to optimize performance and data usage. |
| lightStreamingMode | bool | Indicates whether video quality and streaming are automatically adjusted to optimize performance and data usage. |
| showHelperButton | bool | Indicates whether the helper button is shown. |
| helperButtonImageUrl | string | The url of the helper button image. |
| showLiveIcon | bool | Indicates whether the live icon is shown. |
| delayLiveVideosTime | integer($int32) | The time delay of the live videos. |
| delayLiveVideos | bool | Indicates whether the live videos are delayed. |
| showAutoPlay | bool | Indicates whether the auto play is shown. |
| showQualities | bool | Indicates whether qualities are shown. |
| showSubtitles | bool | Indicates whether subtitles are shown. |
| controlsBackgroundAlpha | integer($int32) | The controls of the background alpha. |
| play | string | The word "play" in a specific language. |
| Pause | string | The word "pause" in a specific language. |
| Next | string | The word "next" in a specific language. |
| Replay | string | The word "replay" in a specific language. |
| Volume | string | The word "volume" in a specific language. |
| Mute | string | The word "mute" in a specific language. |
| Unmute | string | The word "unmute" in a specific language. |
| Settings | string | The word "settings" in a specific language. |
| Fullscreen | string | The word "fullscreen" in a specific language. |
| Chromecast | string | The word "chromecast" in a specific language. |
| Airplay | string | The word "airplay" in a specific language. |
| PictureInPicture | string | The word "picture in picture" in a specific language. |
| SkipIntro | string | The word "skip intro" in a specific language. |
| Airplay | string | The word "airplay" in a specific language. |
| ContinueWatching | string | The word "continue watching" in a specific language. |
| Quality | string | The word "quality" in a specific language. |
| Subtitles | string | The word "subtitles" in a specific language. |
| Autoplay | string | The word "autoplay" in a specific language. |
| PlaybackRate | string | The word "playback rate" in a specific language. |
| Auto | string | The word "auto" in a specific language. |
| Off | string | The word "off" in a specific language. |
| Normal | string | The word "normal" in a specific language. |
| Share | string | The word "share" in a specific language. |
| Theater | string | The word "theater" in a specific language. |
| Skip | string | The word "skip" in a specific language. |
| SkipIn | string | The word "skip in" in a specific language. |
| Visit | string | The word "visit" in a specific language. |
| Info | string | The word "info" in a specific language. |
| StimultaneousAds | string | The word "stimultaneous ads" in a specific language. |
| AutoPlayOff | string | The word "autoplay off" in a specific language. |
| AutoPlayOn | string | The word "autoplay on" in a specific language. |
| ZoomIn | string | The word "zoom in" in a specific language. |
| ZoomOut | string | The word "zoom out" in a specific language. |
| OriginalZoom | string | The word "original zoom" in a specific language. |
| ContinueAfterPause | string | The word "continue after pause" in a specific language. |
| ApiErrorOverlay | string | The word "api error overlay" in a specific language. |
| SourceErrorOverlay | string | The word "source error overlay" in a specific language. |
| PlayerErrorOverlay | string | The word "player error overlay" in a specific language. |
| CaptionsOff | string | The word "captions off" in a specific language. |
| Live | string | The word "live" in a specific language. |
| ChromeCastPlayingOn | string | The word "chromecast playing on" in a specific language. |
| Dimiss | string | The word "dismiss" in a specific language. |
| PlayNow | string | The word "play now" in a specific language. |
| NextVideoCancel | string | The word "next video cancel" in a specific language. |
| AdAnnouncement | string | The word "ad announcement" in a specific language. |
| pauseOtherVideos | bool | Indicates whether the other videos should be paused. |
| autoStartOnLoad | bool | An object with the autostart properties of the player when the page loads. |
| autoStartOnLoadMobile | bool | Specifies if playback should start on load when the user is on mobile. |
| autoStartOnLoadOnData | bool | Specifies if playback should start on load when the user is on mobile data. |
| autoStartOnViewable | Object | An object with the autostart properties of the player dependin on its viewability. |
| autoStartOnViewableMobile | bool | Specifies if this property should be on when the user is on mobile data. |
| autoStartOnViewableOnData | bool | Specifies if this property should be on when the user is on mobile data. |
| autoStartOnViewablePercentage | integer($int32) | Value range: 1-0, specifies what percentage of the video should be visible for video to start. |
| autoPauseOnViewableOn | bool | An object with the auto pause properties. |
| autoPauseOnViewablePercentage | integer($int32) | Value range: 1-0, specifies what percentage of the video should be visible for video to start. |
| autoPauseOnCuePointState | bool | Specifies if this property should be on when the user is on cue point state. |
| autoPauseOnCuePointTimeToPause | integer($int32) | The time it takes to pause when auto pause on cue point. |
| autoPauseOnCuePointContinueUnMuted | bool | Specifies if this property should be on when there is an autopause on cue point. |
| autoPauseOnCuePointOnDesktop | bool | Specifies if this property should be on when there is an autopause on cue point on desktop. |
| autoPauseOnCuePointOnMobile | bool | Specifies if this property should be on when there is an autopause on cue point on mobile. |
| autoPauseOnCuePointPlayerButtonUrl | string | The url of the auto pause button on cue point player. |
| pauseWhenRelatedIsShown | bool | Specifies if this property should be shown when paused when related. |
| readQualities | bool | Specifies if the qualities are read. |
| enableGravityChange | bool | Specifies if th gravity change is enabled. |
| forceSound | bool | Specifies if the sound is forced. |
| showPlayerControlsDuringVideoAdvertisement | bool | Specifies if the player control is shown during video advertisement. |
| enableHapticFeedbackOnButtonClick | bool | Specifies if the feedback on button click is enabled. |
| enableHapticFeedbackOnPinchClick | bool | Specifies if the feedback on pinch click is enabled. |
| usePortraitMode | bool | Specifies if the portrait mode is being used. |
| adAnnouncementState | bool | Specifies if the ad ammpumcement is enabled. |
| adAnnouncementState | bool | Specifies if the ad ammpumcement is enabled. |
| adAnnouncementTimeBeforeAd | integer($int32) | The time before ad for the ad announcement. |
| afterMidrollBacktrackState | bool | Specifies if the backtrack state will be on after midroll. |
| afterMidrollBacktrackTime | integer($int32) | The time for the midroll backtrack. |
| socialNetworksIds | object | Returns the social network ids. |
| controlbartextcolor | string | Indicates the color of the control bar. |
| controlbariconsdefaultcolor | string | Indicates the color of the control bar icon. |
| controlbariconshovercolor | string | Indicates the color of the control bar when hovering. |
| controlbartimesliderprogresscolor | string | Indicates the color of the control bar slider. |
| controlbartimesliderrailcolor | string | Indicates the color of the control bar timeslider. |
| controlbartimesliderdraggercolor | string | Indicates the color of the dragger of the control bar timeslider. |
| controlbartimesliderbuffercolor | string | Indicates the color of the buffer of the control bar timeslider. |
| controlbarvolumedraggercolor | string | Indicates the color of the control bar volume dragger. |
| controlbarvolumeprogresscolor | string | Indicates the color of the control bar volume progress. |
| controlbarvolumerailcolor | string | Indicates the color of the control bar volume rail. |
| controlbarvolumenotifiercolor | string | Indicates the color of the control bar volume notifier. |
| menulinksdefaultcolor | string | Indicates the color of the links menu. |
| menulinkshovercolor | string | Indicates the color of the links menu when hovering. |
| menubackrounddefaultcolor | string | Indicates the color of the menu background. |
| menubackroundhovercolor | string | Indicates the color of the menu background when hovering. |
| menuautoplayoncolor | string | Indicates the color of the menu auto-play when on. |
| menuautoplayoffcolor | string | Indicates the color of the menu auto-play when off. |
| controlbarbackgroundcolor | string | Indicates the color of the control bar background. |
| controlBarLoaderColor | string | Indicates the color of the control bar loader. |
| tooltipstextcolor | string | Indicates the color of the tooltips text. |
| tooltipsbackroundcolor | string | Indicates the color of the tooltips background. |
| nextVideoBackgroundColor | string | Indicates the color of the background of the next video. |
| nextVideoTextColor | string | Indicates the color of the text of the next video. |
| nextVideoTsRailColor | string | Indicates the color of the TS rail of the next video. |
| nextVideoTsProgressColor | string | Indicates the color of the TS progress of the next video. |
| nextVideoTsIconsCloseColor | string | Indicates the color of the TS icons of the next video. |
| nextVideoIconsPlayDefaultColor | string | Indicates the default color of the icons of the next video. |
| nextVideoIconsPlayHoverColor | string | Indicates the default color of the icons play hover of the next video. |
| nextVideoCancelTextColor | string | Indicates the text color of the next video cancel. |
| nextVideoCancelBackgroundColor | string | Indicates the background color of the next video cancel. |
| nextVideoPlayNowTextColor | string | Indicates the text color of the play now next video. |
| nextVideoPlayNowBackgroundColor | string | Indicates the background color of the play now next video. |
| playlistBackgroundColor | string | Indicates the background color of the playlist. |
| playlistTextColor | string | Indicates the text color of the playlist. |
| playlistCardBackgroundColor | string | Indicates the color of the playlist card background. |
| playlistCardTitleColor | string | Indicates the title color of the playlist card. |
| playlistCardDurationTextColor | string | Indicates the text color of the playlist card duration. |
| playlistCardDurationBackgroundColor | string | Indicates the background color of the playlist card. |
| playlistCardIconPlayDefaultColor | string | Indicates the default color of the playlist card icon. |
| playlistCardIconPlayHoverColor | string | Indicates the hover color of the playlist card icon. |
| playlistIconsArrActiveColor | string | Indicates the active color of the playlist icon. |
| playlistIconsArrInactiveColor | string | Indicates the inactive color of the playlist icon. |
| playlistIconsCloseColor | string | Indicates the close color of the playlist icon. |
| controlbartimeslideronaddraggercolor | string | Indicates the color of the dragger of the control bar timeslider. |
| controlbartimeslideronadprogresscolor | string | Indicates the color of the ad progress of the control bar timeslider. |
| controlbartimeslideronadrailcolor | string | Indicates the color of the ad rail of the control bar timeslider. |
Response
{
"publicId": "string",
"name": "string",
"loopContent": true,
"muteOnStart": true,
"floatOnScroll": true,
"autoPauseWhenNotViewable": true,
"enablePlayBackRateControls": true,
"sharing": true,
"casting": true,
"googleAnalytics": true,
"includeCompatibilityScript": true,
"showContentTitle": true,
"showContentDescription": true,
"showControls": true,
"recommendation": true,
"playlistId": 0,
"advertising": true,
"showControlsOnVPAID": true,
"outstreamPlayer": true,
"dispAdverisementAbove": true,
"autoCollapseAfterAds": true,
"preloadAds": true,
"companionAds": true,
"playAdsMuted": true,
"keepVisibleWhenControlsHidden": true,
"debug": true,
"theaterButton": true,
"chromeCastButton": true,
"nextButton": true,
"fullScreenButton": true,
"pictureInPictureButton": true,
"volumeButton": true,
"shareButton": true,
"airplayButton": true,
"settingsButton": true,
"bigPlayButton": true,
"autoPlay": true,
"floatDismissible": true,
"logoOn": true,
"adsRequireInteraction": true,
"focusOnAutoStart": true,
"floatOnMobile": true,
"floatRequiresInteraction": true,
"floatWidth": "string",
"floatBorder": "string",
"logoUrl": "string",
"logoOnClickUrl": "string",
"logoDefaultOpacity": 0,
"logoInactiveOpacity": 0,
"channelUrl": "string",
"cloudHostedPlayerLibrary": "string",
"width": 0,
"height": 0,
"adScheduleId": 0,
"playerSizeTypeId": 0,
"preloadOptionId": 0,
"defaultBandwidthEstimateOptionId": 0,
"sharingTypeId": 0,
"logoPositionOptionId": 0,
"floatPositionOptionId": 0,
"responsiveSizeOptionId": 0,
"releaseChannelId": 0,
"sharingTooltip": "string",
"rightClickText": "string",
"rightClickUrl": "string",
"countDownMessage": "string",
"cueText": "string",
"skipCountDown": "string",
"companionAdsDivID": "string",
"companionAdsWidth": 0,
"companionAdsHeight": 0,
"volume": 0,
"skipAmount": 0,
"highlightCurrentVideo": true,
"onHoverPlay": true,
"lightStreamingMode": true,
"showHelperButton": true,
"helperButtonImageUrl": "string",
"showLiveIcon": true,
"delayLiveVideosTime": 0,
"delayLiveVideos": true,
"showAutoPlay": true,
"showQualities": true,
"showSubtitles": true,
"controlsBackgroundAlpha": 0,
"Play": "string",
"Pause": "string",
"Next": "string",
"UpNext": "string",
"Replay": "string",
"Volume": "string",
"Mute": "string",
"UnMute": "string",
"Settings": "string",
"FullScreen": "string",
"Chromecast": "string",
"Airplay": "string",
"PictureInPicture": "string",
"SkipIntro": "string",
"ContinueWatching": "string",
"Quality": "string",
"Subtitles": "string",
"Autoplay": "string",
"PlaybackRate": "string",
"Auto": "string",
"Off": "string",
"Normal": "string",
"Share": "string",
"Theater": "string",
"Skip": "string",
"SkipIn": "string",
"Visit": "string",
"Info": "string",
"SimultaneousAds": "string",
"AutoplayOff": "string",
"AutoplayOn": "string",
"ZoomIn": "string",
"ZoomOut": "string",
"OriginalZoom": "string",
"ContinueAfterPause": "string",
"ApiErrorOverlay": "string",
"SourceErrorOverlay": "string",
"PlayerErrorOverlay": "string",
"CaptionsOff": "string",
"Live": "string",
"ChromeCastPlayingOn": "string",
"Dismiss": "string",
"PlayNow": "string",
"NextVideoCancel": "string",
"AdAnnouncement": "string",
"pauseOtherVideos": true,
"autoStartOnLoad": true,
"autoStartOnLoadMobile": true,
"autoStartOnLoadOnData": true,
"autoStartOnViewableOn": true,
"autoStartOnViewableMobile": true,
"autoStartOnViewableOnData": true,
"autoStartOnViewablePercentage": 0,
"autoPauseOnViewableOn": true,
"autoPauseOnViewablePercentage": 0,
"autoPauseOnCuePointState": true,
"autoPauseOnCuePointTimeToPause": 0,
"autoPauseOnCuePointContinueUnMuted": true,
"autoPauseOnCuePointOnDesktop": true,
"autoPauseOnCuePointOnMobile": true,
"autoPauseOnCuePointPlayButtonUrl": "string",
"pauseWhenRelatedIsShown": true,
"readQualities": true,
"enableGravityChange": true,
"forceSound": true,
"showPlayerControlsDuringVideoAdvertisement": true,
"enableHapticFeedbackOnButtonClick": true,
"enableHapticFeedbackOnPinchToZoom": true,
"usePortraitMode": true,
"adAnnouncementState": true,
"adAnnouncementTimeBeforeAd": 0,
"afterMidrollBacktrackState": true,
"afterMidrollBacktrackTime": 0,
"releaseChannel": {
"id": 0,
"name": "string",
"originalPath": "string",
"templateOriginalPath": "string"
},
"playerSizeType": {
"id": 0,
"name": "string"
},
"preloadOption": {
"id": 0,
"name": "string",
"value": "string",
"tooltipText": "string"
},
"defaultBandwidthEstimateOption": {
"id": 0,
"name": "string",
"value": "string"
},
"sharingType": {
"id": 0,
"name": "string",
"value": "string"
},
"responsiveSizeOption": {
"id": 0,
"name": "string",
"width": 0,
"height": 0
},
"logoPositionOption": {
"id": 0,
"name": "string",
"value": "string"
},
"floatPositionOption": {
"id": 0,
"name": "string",
"value": "string"
},
"adSchedule": {
"adManagerId": 0,
"vpaidModeOptionId": 0,
"publicId": "string",
"name": "string",
"adScheduleTypeId": 0,
"adSeenOnSubsequentVisitOptionId": 0,
"vmapAdTag": "string",
"timeBetweenAds": 0,
"startOnPlaylistItem": 0,
"repeatOnInterval": 0,
"enableBidding": true,
"enableProgrammability": true,
"biddingTemplatePublicId": "string",
"vpaidModeOption": {
"id": 0,
"name": "string"
},
"adSeenOnSubsequentVisitOption": {
"id": 0,
"name": "string"
},
"adManager": {
"id": 0,
"Value": "string"
},
"adScheduleType": {
"id": 0,
"name": "string",
"value": "string",
"description": "string"
},
"adWorkflows": [
{
"id": 0,
"adScheduleId": "string",
"adFunctionId": 0,
"adFunctionName": "string",
"order": 0
}
]
},
"socialNetworkIds": [
0
],
"controlBarTextColor": "string",
"controlBarIconsDefaultColor": "string",
"controlBarIconsHoverColor": "string",
"controlBarTimesliderProgressColor": "string",
"controlBarTimesliderRailColor": "string",
"controlBarTimesliderDraggerColor": "string",
"controlBarBackgroundColor": "string",
"controlBarTimesliderBufferColor": "string",
"controlBarVolumeDraggerColor": "string",
"controlBarVolumeProgressColor": "string",
"controlBarVolumeRailColor": "string",
"controlBarVolumeNotifierColor": "string",
"controlBarTimeSliderOnAdDraggerColor": "string",
"controlBarTimeSliderOnAdProgressColor": "string",
"controlBarTimeSliderOnAdRailColor": "string",
"controlBarLoaderColor": "string",
"menuLinksDefaultColor": "string",
"menuLinksHoverColor": "string",
"menuBackroundDefaultColor": "string",
"menuBackroundHoverColor": "string",
"menuAutoplayOnColor": "string",
"menuAutoplayOffColor": "string",
"nextVideoBackgroundColor": "string",
"nextVideoTextColor": "string",
"nextVideoTsRailColor": "string",
"nextVideoTsProgressColor": "string",
"nextVideoTsIconsCloseColor": "string",
"nextVideoIconsPlayDefaultColor": "string",
"nextVideoIconsPlayHoverColor": "string",
"nextVideoCancelTextColor": "string",
"nextVideoCancelBackgroundColor": "string",
"nextVideoPlayNowTextColor": "string",
"nextVideoPlayNowBackgroundColor": "string",
"playlistBackgroundColor": "string",
"playlistTextColor": "string",
"playlistCardBackgroundColor": "string",
"playlistCardTitleColor": "string",
"playlistCardDurationTextColor": "string",
"playlistCardDurationBackgroundColor": "string",
"playlistCardIconPlayDefaulColor": "string",
"playlistCardIconPlayHoverColor": "string",
"playlistIconsArrActiveColor": "string",
"playlistIconsArrInactiveColor": "string",
"playlistIconsCloseColor": "string",
"tooltipsTextColor": "string",
"tooltipsBackroundColor": "string"
}
Information about the fields that appear when you receive the response are displayed in the table below.
| Field Name | Type | Description |
|---|---|---|
| success | bool | If the response is successful it will return true. Otherwise will return false. |
| errors | array[] | Indicates if there was an error. |
| messages | array[] | Returns the response message from back-end. |
| result | array[Object] | Returns the response object. |
| publicId | string | The public ID of the player. |
| name | string | The name of the player. |
| loopContent | bool | Indicates whether the content should be looped. |
| muteOnStart | bool | Indicates whether the player is muted on start. |
| floatOnScroll | bool | Indicates whether the player should be in a float state when scrolling. |
| autoPauseWhenNotViewable | bool | Indicates whether the player should pause when it becomes unviewbale. |
| enablePlaybackRateControls | bool | Indicates whther the playback rate controls are enabled. |
| sharing | bool | Indicates whether the sharing option is available. |
| casting | bool | Indicates whether the casting option is available. |
| googleAnalytics | bool | Indicates whether Google Analytics are enabled. |
| includeCompatibilityScript | bool | Indicates wether the compatibility script is included. |
| showContentTitle | bool | Indicates whether the player should show the content title. |
| showContentDescription | bool | Indicates whether the playr should show the content description. |
| showControls | bool | Indicates whether the playr should show the controls. |
| recommendation | bool | Indicates whether the recommendation section is enabled. |
| advertising | bool | Indicates whether advertising is enabled. |
| showControlsOnVPAID | bool | Indicates whether the player should show the controls on VPAID. |
| oustreamPlayer | bool | Indicates whether the player is outstreamed. |
| dispAdvertisementAbove | bool | Indicates whether the advertisement above the player should be displayed. |
| autoCollapseAfterAds | bool | Indicates whether the player should auto collapse after ads. |
| preloadAds | bool | Indicates whether ads should be preloaded. |
| companionAds | bool | Indicates whether companion ads are enabled. |
| playAdsMuted | bool | Indicates whether ads should be played on mute |
| keepVisibleWhenControlsHidden | bool | Indicates whether the player is visible when the controls are hidden. |
| debug | bool | Indicates wether debugging is enabled. |
| chromeCastButton | bool | Indicates whether the chromecast button is enabled. |
| nextButton | bool | Indicates whether the next button is enabled. |
| airplayButton | bool | Indicates whether the airplay button is enabled. |
| settingsButton | bool | Indicates whether the settings button is enabled. |
| bigPlayButton | bool | Indicates whether the main play button is enabled. |
| autoPlay | bool | Indicates whether auto play is enabled. |
| muted | bool | Indicates whether the player is muted. |
| floatDismissible | bool | Indicates whether the float option is dismissible. |
| logoOn | bool | Indicates whether the logo is on the player. |
| adsRequireInteraction | bool | Indicates whether the ads require interaction. |
| focusOnAutoStart | bool | Indicates whether the player is in a focus state on auto start. |
| floatOnMobile | bool | Indicates whether the player should have a float state on mobile versions. |
| floatRequiresInteraction | bool | Indicates whether the float option requires interaction. |
| floatWidth | string | Indicates the width of the float |
| logoUrl | string | The URL of the logo. |
| logoOnClickUrl | string | The URL of the "on click" state of the logo. |
| logoDefaultOpacity | integer($int32) | The default opacity of the logo. |
| logoInactiveOpacity | integer($int32) | The opacity of the logo when it is inactive. |
| channelUrl | string | The URL of the channel. |
| width | integer($int32) | The width of the player. |
| height | integer($int32) | The height of the player |
| adScheduleId | integer($int32) | The Id of the ad schedule. |
| playerSizeTypeId | integer($int32) | The Id of the player size type. |
| sharingTypeId | integer($int32) | The id of the sharing type. |
| logoPositionOptionId | integer($int32) | The id of the logo position option. |
| floatPositionOption | integer($int32) | The id of the float position option. |
| responsiveOptionId | integer($int32) | The id of the responsive option. |
| releaseChannelId | integer($int32) | The id of the release channel |
| sharingTooltip | string | The sharing tooltip. Appears when the cursor is positioned over the sharing icon. |
| rightClickText | string | The text that appears when you right-click. |
| rightClickUrl | string | The URL of the right-click. |
| countDownMessage | string | Indicates the time until the video starts. |
| cueText | string | The cue text of the ad. |
| skipCountDown | string | Indicates whether the countdown should be skipped. |
| companionAdsDivId | string | The div id of the companion ads. |
| companionAdsWidth | integer($int32) | The height of the companion ad. |
| companionAdsHeight | integer($int32) | The height of the companion ad. |
| volume | integer($int32) | The volume of the player. |
| skipAmount | integer($int32) | The amount of seconds a skip makes. |
| highlightCurrentVideo | bool | Indicates whether the current video has been highlighted. |
| onHoverPlay | bool | Indicates whether the hoverplay is on. |
| lightStreamingMode | bool | Indicates whether video quality and streaming are automatically adjusted to optimize performance and data usage. |
| showHelperButton | bool | Indicates whether the helper button is shown. |
| helperButtonImageUrl | string | The url of the helper button image. |
| showLiveIcon | bool | Indicates whether the live icon is shown. |
| delayLiveVideosTime | integer($int32) | The time delay of the live videos. |
| delayLiveVideos | bool | Indicates whether the live videos are delayed. |
| showAutoPlay | bool | Indicates whether the auto play is shown. |
| showQualities | bool | Indicates whether qualities are shown. |
| showSubtitles | bool | Indicates whether subtitles are shown. |
| controlsBackgroundAlpha | integer($int32) | The controls of the background alpha. |
| play | string | The word "play" in a specific language. |
| Pause | string | The word "pause" in a specific language. |
| Next | string | The word "next" in a specific language. |
| Replay | string | The word "replay" in a specific language. |
| Volume | string | The word "volume" in a specific language. |
| Mute | string | The word "mute" in a specific language. |
| Unmute | string | The word "unmute" in a specific language. |
| Settings | string | The word "settings" in a specific language. |
| Fullscreen | string | The word "fullscreen" in a specific language. |
| Chromecast | string | The word "chromecast" in a specific language. |
| Airplay | string | The word "airplay" in a specific language. |
| Quality | string | The word "quality" in a specific language. |
| Subtitles | string | The word "subtitles" in a specific language. |
| Theater | string | The word "theater" in a specific language. |
| Skip | string | The word "skip" in a specific language. |
| SkipIn | string | The word "skip in" in a specific language. |
| Visit | string | The word "visit" in a specific language. |
| Info | string | The word "info" in a specific language. |
| autoStartOn | bool | Indicates whether the player has auto start enabled. |
| autoStartOnData | bool | Indicates whether the player has auto start enabled. |
| autoStartPlayPercentage | integer($int32) | Indicates on which percentage is auto start enabled. |
| autoPauseOn | bool | Indicates whether the player has auto pause enabled. |
| autoPauseOnPercentage | integer($int32) | Indicates on which percentage is auto pause enabled. |
| pauseOtherVideos | bool | Indicates whether the other videos should be paused. |
| autoStartOnLoad | Object | An object with the autostart properties of the player when the page loads. |
| autoStartOnLoadMobile | bool | Specifies if playback should start on load when the user is on mobile. |
| autoStartOnLoadOnData | bool | Specifies if playback should start on load when the user is on mobile data. |
| autoStartOnViewable | Object | An object with the autostart properties of the player dependin on its viewability. |
| autoStartOnViewableMobile | bool | Specifies if this property should be on when the user is on mobile data. |
| autoStartOnViewableOnData | bool | Specifies if this property should be on when the user is on mobile data. |
| autoStartOnViewablePercentage | integer($int32) | Value range: 1-0, specifies what percentage of the video should be visible for video to start. |
| autoPauseOnViewableOn | bool | An object with the auto pause properties. |
| autoPauseOnViewablePercentage | integer($int32) | Value range: 1-0, specifies what percentage of the video should be visible for video to start. |
| releaseChannel | Object | Returns the release channel. |
| id | integer($int32) | The id of the release channel. |
| name | string | The name of the release channel. |
| originalPath | string | The original path of the release channel. |
| templateOriginalPath | string | The original path of the template release channel. |
| playerSizeType | Object | Returns the player size type. |
| id | integer($int32) | The id of the player size type. |
| name | string | The name of the player size type. |
| preloadOption | Object | Returns the preload option. |
| id | integer($int32) | The id of the preload option. |
| name | string | The name of the preload option. |
| value | string | The value of the preload option. |
| tooltipText | string | Gives a description about the preload option. |
| defaultBandwidthEstimateOption | Object | Returns the default bandwidth estimate option. |
| id | integer($int32) | The id of the default bandwidth estimate option. |
| name | string | The name of the default bandwidth estimate option. |
| value | string | The value of the default bandwidth estimate option. |
| sharingType | Object | Returns the sharing type |
| responsiveSizeOption | Object | Returns the responsive size option. |
| id | integer($int32) | The id of the responsive size option. |
| name | string | The name of the responsive size option. |
| logoPositionOption | Object | Returns the logo position option. |
| id | integer($int32) | The id of the logo position option. |
| name | string | The name of the logo position option. |
| value | string | The value of the logo position option. |
| floatPositionOption | Object | Returns the float position option. |
| id | integer($int32) | The id of the float position option. |
| name | string | The name of the float position option. |
| value | string | The value of the float position option. |
| adScheduleId | string | The id of the ad schedule. |
| defaultConfig | Object | Object that contains all of the configurations. |
| playerSocialNetworks | array[Object] | Returns the social networks of the player. |
| controlbartextcolor | string | Indicates the color of the control bar. |
| controlbariconsdefaultcolor | string | Indicates the color of the control bar icon. |
| controlbariconshovercolor | string | Indicates the color of the control bar when hovering. |
| controlbartimesliderprogresscolor | string | Indicates the color of the control bar slider. |
| controlbartimesliderrailcolor | string | Indicates the color of the control bar timeslider. |
| controlbartimesliderdraggercolor | string | Indicates the color of the dragger of the control bar timeslider. |
| controlbartimesliderbuffercolor | string | Indicates the color of the buffer of the control bar timeslider. |
| controlbarvolumedraggercolor | string | Indicates the color of the control bar volume dragger. |
| controlbarvolumeprogresscolor | string | Indicates the color of the control bar volume progress. |
| controlbarvolumerailcolor | string | Indicates the color of the control bar volume rail. |
| controlbarvolumenotifiercolor | string | Indicates the color of the control bar volume notifier. |
| menulinksdefaultcolor | string | Indicates the color of the links menu. |
| menulinkshovercolor | string | Indicates the color of the links menu when hovering. |
| menubackrounddefaultcolor | string | Indicates the color of the menu background. |
| menubackroundhovercolor | string | Indicates the color of the menu background when hovering. |
| menuautoplayoncolor | string | Indicates the color of the menu auto-play when on. |
| menuautoplayoffcolor | string | Indicates the color of the menu auto-play when off. |
| controlbarbackgroundcolor | string | Indicates the color of the control bar background. |
| tooltipstextcolor | string | Indicates the color of the tooltips text. |
| tooltipsbackroundcolor | string | Indicates the color of the tooltips background. |
| controlbartimeslideronaddraggercolor | string | Indicates the color of the dragger of the control bar timeslider. |
| controlbartimeslideronadprogresscolor | string | Indicates the color of the ad progress of the control bar timeslider. |
| controlbartimeslideronadrailcolor | string | Indicates the color of the ad rail of the control bar timeslider. |
| resultInfo | string | Returns extra information about the result. |
| statusCode | integer($int32) | Returns the HTTP Status Code. |
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