Update video player

Body Params
string
required

Key of the player which should be updated.

string
string

Text displayed in right-click select menu when one right clicks the player.

string

Message that displayed in the controlbar during ad playback.

string

Advertising client

Possible values:

  • none: No ads serving

  • vast: Ads served by a VAST-compliant video ad server

  • googima: In-video ads served by Google DFP

integer

Height of ads that are placed in companion.

string

DOM id to put companion ads in.

integer

Width of ads that are placed in companion.

string

Ad cue text.

string

Player behavior after all ads within the ad break have played

Possible values:

  • suspended: A gray background without controls remains.

  • close: The player gradually closes.

string

Property enabling outstream functionality

  • True: Outstream enabled

  • False: Outstream disabled

boolean
enum
  • True: Ads will be preloaded

  • False: Ads will NOT be preloaded

Default is False.

Allowed:
string

URL to a VMAP ad schedule.

WARNING: It is strongly recommended to configure players with JW Platform hosted ad schedules using the advertising_schedule_key parameter instead of the advertising_schedule parameter(s). JW Platform hosted ad schedules have the benefit of tracking IDs that will power advertising analytics in the future.

string

Key of the advertising schedule.

WARNING: If set, the schedule specified by advertising_schedule_key will be used instead of advertising_schedule advertising_client advertising_tag(_1|_2) settings. It is strongly recommended to configure players with JW Platform hosted ad schedules using the advertising_schedule_key parameter. JW Platform hosted ad schedules have the benefit of tracking IDs that will power advertising analytics in the future.

string

Message for skip-at button. Used to provide a customized ad skipping countdown message. xx in the message will be replaced with seconds until the ad is skippable. For example: Skip ad in xx seconds.

integer

Offset in seconds to show skip-at button at

string

Text for the ad skip button after the countdown is over

string

URL of the advertising tag

string

Second URL of the advertising tag to support ad waterfalling

string

Third URL of the advertising tag to support ad waterfalling

string
  • True: Vpaidcontrols will render

  • False: Vpaidcontrols will not render

Default is False.

string

The ability to set VPAID 2 mode for Google IMA

Possible values:

  • none: VPAID 2 mode disabled.

  • enabled: VPAID 2 mode enabled.

  • insecure: Insecure VPAID 2 mode.

Default is insecure.

string

Defines player aspect ratio. Only applicable when player responsive parameter is True.

boolean
enum

Automatically pauses the player based on certain rules.

  • True: When the player is no longer viewable, video
    playback pauses. Playback resumes when the player becomes
    viewable again. If the player is no longer viewable after an
    ad break begins, the ad break will continue to play to
    completion before pausing.

  • False: The autopause functionality is disabled.

Allowed:
string

Defines whether video playback should start on player load

Possible values:

  • True: Start video playback on player load.

  • False: Do not start video playback on player load.

  • viewable: Start video playback on player load and when player is more then 50% visible in a desktop environment.

string
enum

Defines whether player should show video captions

Possible values:

  • none: Do not show captions.

  • outline: Show captions and render them with a thin black outline.

  • block: Show captions and draw a black box around them.

Allowed:
string

Google Cast receiver Application ID

If set, enables Google Cast functionality.

string

Key of the image that should be displayed on the TV once all videos have completely played

If no image is specified, JW Player provides a default end screen image

string

Key of the image that should be displayed on the TV once the connection between the sending application and a receiver application is made

If no image is specified, JW Player provides a default screen.

string

Key of the image that should be placed as a logo in the top right corner of the receiver application

string

Hexadecimal color value. Used to match the Chromecast controls to a custom branding

string
enum

Controlbar position

Possible values:

  • none: No controlbar.

  • bottom: Controlbar is below the video.

  • over: Controlbar is over the video.

Allowed:
string

Defines whether JavaScript cookies should be turned on

Possible values:

  • True: Turn on JavaScript cookies

  • False: Turn off JavaScript cookies

  • None: Same as True

string

Override for the "Watching" text in the recommendations channel overlay

string

Player custom parameters. param part of the request
parameters (after the ‘.’ separator) specifies name of the
parameter. Note that these parameters are not served with
the player from the Delivery API, but can be used to
organize your players in the API. The parameter name should
adhere to the following naming rules:

  • name can contain letters, numbers and punctuation
    characters ‘.’, ‘_’, ‘-‘

  • name cannot start with a number or punctuation character

  • name cannot contain spaces

Custom parameter values can be specified multiple times, as
long as parameter name is unique.

If parameter already exist in the system, it will be updated
with the new value. If parameter name starts with ‘-‘, the
parameter with the same name (but without leading ‘-‘) will
be deleted from the system.

integer

Sets an initial bandwidth estimate, in bits per second, for all viewers. All values, including negative ones, below the minimum of 1 will be rounded up. To set the highest quality as an initial estimate, reference the highest bitrate from your manifest.

Supported by JW Player: 8.3+

string

Defines whether video description should be displayed inside
the play icon:

  • True: Display video description.

  • False: Do not display video description.

string

Controls if heading above the outstream player is displayed

Possible values:

  • True: Heading is shown with default text: Advertisement.

  • False: No heading is shown.

string

Turns recommendations channel overlay on or off:

  • True: Display recommendations channel overlay

  • False: Do not display recommendations channel playlist overlay

string

Defines whether video title should be display inside the
play icon:

  • True: Display video title.

  • False: Do not display video title.

Default is True.

string

Specifies div id on the page for the player to set up the playlist outside of the player

string

Title of the playlist tooltip and menu override like "Episodes" or "Playlist"

boolean
enum

Keeps the player visible when the original player location
is scrolled out of view by minimizing it to a corner of the
screen. On devices in portrait orientation, the player
becomes fixed to the top of the page using its original
dimensions.

When floating, the viewer can drag the player to reposition
it. This functionality is disabled during ad playback.
This floating feature cannot be used with a player that is
embedded in an iframe.

  • True: The floating player is enabled and can be closed
    by a viewer.

  • False: The floating player functionality is disabled.

Allowed:
string

Google Analytics Web Property ID in the form UA-XXXXX-YY.

integer

Video player height.

string

Determines whether to serve compatibility script with
player.

  • True: Serves compatibility script with player.

  • False: Does NOT serve compatibility script with player

If not set, JW Player will not include the script.

string

ID of a LongTail AdSolution channel

string

Defines whether sound should be muted on startup:

  • True: Mute sound on startup.

  • False: Do not mute sound on startup.

string

Name of the video player.

integer

Time in seconds before the end of the video when recommendations channel overlay should appear

If None, player default setting is used.

string

Override for the "Next Up" text in the recommendations channel overlay

string

Defines whether to display a button in the controlbar to
adjust playback rate:

  • True: Display playback rate button.

  • False: Do not display playback rate button.

string

Playback rates in the form of JSON formated array of float numbers. Array can have up to 10 elements with the lowest value 0.25 and highest 4.

Example:

[0.25,1,1.75,2]
string

Playlist position

Possible values:

  • none: No playlist.

  • bottom: Playlist is below the video.

  • right: Playlist is right of the video.

  • over: Playlist is over the video.

string

Defines layout of the items in the playlist

Possible values:

  • extended: Playlist layout includes image, title and description.

  • basic: Playlist layout only includes title.

string

Playlist size. Only set if current or new playlist position is not none.

string
enum

Defines video preload behavior of the player in the browser

Possible values:

  • auto: The browser should load the entire video when the page loads.

  • metadata: The browser should load metadata and possibly some early part of the media when the page loads.

  • none: The browser should NOT load the video or its metadata when the page loads.

Although the precise behavior of the preload setting will
vary slightly based on browser and device, W3C provides this
recommendation for the parameter:
http://www.w3.org/TR/html5/embedded-content-0.html#attr-media-preload

Current JW Player behavior and browser support is documented
at: https://support.jwplayer.com/articles/video-preload-reference

Allowed:
string

Specifies which rendering mode to use for rendering the player if both are available

Possible values:

  • html5: Use HTML5 mode

  • flash: Use Flash mode

string

Recommendations channel key to associate with the player.

string
integer
string
enum
Allowed:
string
string
string
string

Player release channel

Possible values:

  • beta: JW Player beta release channel.

  • staging: JW Player staging release channel.

  • production: JW Player production release channel.

  • previous: JW Player previous release channel.

  • preview: JW Player preview release channel.

Default is production.

string

Defines playback repeating behavior of the player

Possible values:

  • none: Stop playback after every video.

  • single: Continuously repeat only the current video.

  • list: Play all entries in the channel once.

  • always: Continuously repeat all videos in channel.

string

Defines whether the player should using Responsive Design
settings:

  • True: Use Responsive Design settings.

  • False: Do not use Responsive Design settings.

string

Feature that enables our analytics plugin to fire a ping back when a viewer has watched past a threshold of time

string

Defines options for the sharing plugin

Possible values:

  • none: No sharing.

  • dock: Only display sharing shortcuts buttons in the dock.

  • screen: Display on screen sharing dialog with the video link field and sharing shortcuts buttons.

  • screen-embed: Display on screen sharing dialog with the video link field, embed code field and sharing shortcuts buttons.

string

Short text to display at the top of the sharing screen.

string

Key of the player that should be used for sharing.

string

JSON-formatted array to customize social
sharing sites settings

By default, icons for Facebook, Twitter, and email are
displayed. Sites can be added, removed, or re-ordered.

Built-in social networks include:

  • email: Email

  • facebook: Facebook

  • linkedin: LinkedIn

  • pinterest: Pinterest

  • reddit: Reddit

  • tumblr: Tumblr

  • twitter: Twitter

Example:
["reddit","facebook","twitter"]

In the event that there are additional sites or actions that
you would like to perform with sharing plugin, these can be
added by inserting the following into your sites array:

  • icon: A URL to the social media icon that you wish to
    use. Can be in SVG or PNG format.

  • src: The JavaScript that will be executed by selecting
    the particular button.

  • label: The label that you wish to associate with this
    sharing method. This will be returned via our API when
    selected.

Example:
["reddit", {"src": "javascript:sharetoCustom();", "label": "mysite", "icon": "customicon.png"}, "linkedin"]

Default is ["facebook", "twitter", "email"]

string

Defines whether integration with the Adobe SiteCatalyst should be enabled

Possible values:

  • True: Enable integration

  • False: Do not enable integration

  • None: Same as False

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the controlbar text.

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the controlbar icons.

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the active controlbar icons.

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the controlbar background.

string

Key of the skin that should be used by the player.

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the menus background.

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the menus text.

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the active menus text.

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the timeslider progress.

string

Hexadecimal color value using the full #AABBCC or short#ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the timeslider rail.

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the tooltips background.

string

Hexadecimal color value using the full #AABBCC or short #ABC format; or RGB color value with an alpha channel using rgba(170, 187, 204, 0.5) format. Used to change the default style for the tooltips text.

string

Defines how videos or thumbnails should be stretched

Possible values:

  • none: Maintain original dimensions.

  • exactfit: Stretch disproportionally to exactly match the display dimensions.

  • fill: Stretch proportionally to fill the display (parts are cut off).

  • uniform: Stretch proportionally to fit the display (black borders).

string

Key of the video conversion template used by this player. If empty, player will use bitrate switching.

string

Player version

string

Defines whether to display the visual playlist indicator in
the controlbar:

  • True: Turn on visual playlist indicator.

  • False: Turn off visual playlist indicator.

string
string

Defines whether watermark should hidden during video
playback:

  • True: Hide watermark during video playback.

  • False: Show watermark during video playback.

string

Key of the watermark that should be used with this video player. Player will not use any watermark image if the watermark_key value is empty.

integer

Watermark margin from the both sides of the video player corner set by the watermark_position parameter.

string

Watermark position

Possible values:

  • top-left: Position watermark in the top left corner of the video player.

  • top-right: Position watermark in the top right corner of the video player.

  • bottom-right: Position watermark in the bottom right corner of the video player.

  • bottom-left: Position watermark in the bottom left corner of the video player.

  • control-bar: Position watermark in the control bar of the video player.

integer

Video player width.

Headers
string
enum
Defaults to application/xml

Generated from available response content types

Allowed:
Responses

Language
URL
Response
Choose an example:
Response
© 2007- Longtail Ad Solutions, Inc.