Update a player
IMPORTANT CHANGE TO ENDPOINT: The following parameters in this endpoint can now only be used if player_type = playlist - “playlist_always_open”, “on_complete”, “redirect_url”, “redirect_whole_page”, “up_next”
| Code | Description |
|---|---|
| 400 | Bad Request: body has wrong syntax or unable to handle request |
| 401 | Unauthorized: auth_token omitted or authentication failed |
| 403 | Forbidden: This action cannot be performed |
| 404 | Not Found: The requested resource could not be found |
| 406 | Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| 422 | Unprocessable Entity: body has wrong attributes |
REQUEST
Content-Type: application/json
{
"play_button": false,
"autoplay": true,
"mute_onload": true,
"embed_button": false,
"whitelisted_embed_domain": "*.example.com"
}
RESPONSE
200 (OK)
{
"id": 1111,
"uuid": "eQSsPVXinqGoesujP2Vteg",
"name": "My Player",
"description": "The besterest videos",
"play_button": false,
"autoplay": true,
"embed_button": false,
"viral_sharing": true,
"viral_sharing_message": "Check out this awesome video!",
"custom_sharing_link": null,
"height": 360,
"width": 640,
"color": "A7A7A7",
"playlist_color": "222222",
"splash_screen_fade": true,
"mute_onload": true,
"up_next": false,
"disable_playlist": false,
"playlist_always_open": false,
"audio_player_visuals": "visualization",
"on_complete": "loop",
"redirect_url": null,
"redirect_whole_page": false,
"sharing_page": true,
"sharing_page_comments": true,
"release_date": 0,
"expiry_date": null,
"whitelisted_embed_domain": "*.example.com",
"chapters_attributes":[{
"position":0,
"player_id":50,
"video_id":63,
"video_attributes":{
"name":"Falcon Punch",
"upload_url":null,
"description":"A description",
"sync":true,
"audio_gain":0,
"webhook_url":null,
"tags_attributes":[],
"hosting_provider":"youtube",
"id":63,
"status":null,
"error_message":null,
"created_at":1374178204,
"updated_at":1374178204
},
"id":37,
"created_at":1374178204,
"updated_at":1374178204
}],
"created_at": 1390585689,
"updated_at": 1390585689,
"length_in_seconds": 0,
"show_playback_speed": false,
"access_setting": "public",
"show_time": true
}
| Param name | Description |
|---|---|
|
auth_token optional |
API token needed to authorize requests Validations:
|
|
id required |
Validations:
|
|
name optional |
Name of the player Validations:
|
|
description optional |
Description of the player Validations:
|
|
play_button optional |
Display the play button on the thumbnail Validations:
|
|
autoplay optional |
Force the player to start playing when the page loads Validations:
|
|
first_frame optional |
Causes the player to begin playing as soon as it has loaded and then immediately pause Validations:
|
|
embed_button optional |
Display embed button on player Validations:
|
|
viral_sharing optional |
Adds a share button to your player allowing your viewers to share your videos on social networks and email Validations:
|
|
viral_sharing_message optional |
The message used when viral sharing button is clicked Validations:
|
|
custom_sharing_link optional |
The link that will be shared when viral sharing button is clicked Validations:
|
|
height optional |
Height of the player Validations:
|
|
width optional |
Width of the player Validations:
|
|
color optional |
Color of the player (Hex) Validations:
|
|
playlist_color optional |
Color of the playlist (Hex) Validations:
|
|
splash_screen_fade optional |
The player gets highlighted when a viewer’s mouse hovers over it Validations:
|
|
mute_onload optional |
The videos will default to mute with a text overlay prompting the viewer to click for sound Validations:
|
|
disable_playlist optional |
The playlist is not shown on the side of the player Validations:
|
|
playlist_always_open optional |
The playlist is always shown on the side of the player Validations:
|
|
on_complete optional , nil allowed |
What would you like to happen when all videos have finished playing? Validations:
|
|
redirect_url optional |
URL to redirect the player iframe to when videos have finished playing Validations:
|
|
redirect_whole_page optional |
Redirects the entire page if “on_complete” is set to “redirect_url” Validations:
|
|
sharing_page optional |
Enable the sharing page for the player Validations:
|
|
sharing_page_comments optional |
Allow viewers to comment on the sharing page Validations:
|
|
release_date optional , nil allowed |
Timestamp (Unix Time) Validations:
|
|
expiry_date optional , nil allowed |
Timestamp (Unix Time) Validations:
|
|
whitelisted_embed_domain optional |
Restrict this player to be embedded only on specific domains Validations:
|
|
authorized_by optional |
Restrict this player to a specific platform such as Hubs or Salesforce Chatter Validations:
|
|
hidden_controls optional |
Disable playback controls Validations:
|
|
up_next optional |
Enable Up Next feature Validations:
|
|
disable_legacy optional |
Disable legacy mode Validations:
|
|
audio_player_visuals optional |
Change what is displayed during playback of an audio chapter Validations:
|