v1

latestOpenAPI 3.0.12026-07-2210997354.2 KB
Player settings

Update

Updates the player settings for a project

put/projects/{project_id}/player_settings

Request body

enabledboolean

Whether the player distribution is on or off

player_version'0' | '1'

The player version to use. Possible values are 0 for legacy and 1 for the current

player_style'small' | 'standard' | 'large' | 'video'

he style of user interface to show for the player. Possible values are small, standard, large, or video

player_titlestring nullable

The title to show in the large player when there isn't a playlist

call_to_actionstring

The text prompt to show on the player

image_urlstring nullable

An image to show in the player instead of the content's image

persistent_ad_imageboolean nullable

Whether to show clickable ad images in the player when the ad isn't playing

theme'auto' | 'dark' | 'light'

The color theme to use for the player. The color theme to use for the player. Possible values are auto, dark, or light

title_enabledboolean

Whether to always show the content's title (e.g. instead of the call_to_action)

image_enabledboolean

Whether to show or hide the image in the player

widget_style'none' | 'small' | 'standard' | 'large' | 'video'

The style of user interface to show for the widget at the bottom of the screen. Possible values are none, small, standard, large, video The widget appears once you scroll past the player in the page.

widget_position'auto' | 'left' | 'center' | 'right'

The side of the screen on which to show the widget. Possible values are auto, left, center, right The 'auto' position places the standard player in the center, otherwise to the right.

segment_playback_enabledboolean

Whether to allow playback by clicking on a segment (i.e. a paragraph) on the page

segment_highlights_enabledboolean

Whether segments should be highlighted in time with content playback

skip_button_stylestring

The style of skip buttons to show in the player. Possible values are segments or seconds You can specify the number of seconds to skip, e.g. seconds-15 or seconds-15-30

intro_urlstring nullable

The URL of an intro audio file to play before all content in the player

outro_urlstring nullable

The URL of an outro audio file to play after all content in the player.

intro_outro_enabledboolean

Whether or not the intro and outro should be played. The default is false

download_button_enabledboolean

Whether to show a download button next to each playlist item in the player

analytics_custom_urlstring nullable

Custom analytics server URL

analytics_tag_enabledstring nullable

Google Analytics tag enabled

analytics_tagstring nullable

Google Analytics tag

logo_icon_enabledboolean

Whether to show the BeyondWords logo in the player

word_highlights_enabledboolean
continuous_playback_mode'none' | 'recent'

The continuous playback mode. Possible values are none or recent

outro_playback_mode'after-all' | 'after-each'

The outro playback mode. Possible values are after-all or after-each

Response

OK

enabledboolean

Whether the player distribution is on or off

player_version'0' | '1'

The player version to use. Possible values are 0 for legacy and 1 for the current

player_style'small' | 'standard' | 'large' | 'video'

The style of user interface to show for the player. Possible values are small, standard, large, or video

player_titlestring nullable

The title to show in the large player when there isn't a playlist

call_to_actionstring

The text prompt to show on the player

image_urlstring nullable

An image to show in the player instead of the content's image

theme'auto' | 'dark' | 'light'

The color theme to use for the player. Possible values are auto, dark, or light The 'auto' theme is based on the user's light/dark mode system preference.

title_enabledboolean

Whether to always show the content's title (e.g. instead of the call_to_action)

image_enabledboolean

Whether to show or hide the image in the player

persistent_ad_imageboolean

Whether to show clickable ad images in the player when the ad isn't playing

widget_style'none' | 'small' | 'standard' | 'large' | 'video'

The style of user interface to show for the widget at the bottom of the screen. Possible values are none, small, standard, large, video The widget appears once you scroll past the player in the page.

widget_position'auto' | 'left' | 'center' | 'right'

The side of the screen on which to show the widget. Possible values are auto, left, center, right The 'auto' position places the standard player in the center, otherwise to the right.

segment_playback_enabledboolean

Whether to allow playback by clicking on a segment (i.e. a paragraph) on the page

segment_highlights_enabledboolean

Whether segments should be highlighted in time with content playback

skip_button_stylestring

The style of skip buttons to show in the player. Possible values are segments or seconds You can specify the number of seconds to skip, e.g. seconds-15 or seconds-15-30

intro_urlstring nullable

The URL of an intro audio file to play before all content in the player

outro_urlstring nullable

The URL of an outro audio file to play after all content in the player

intro_outro_enabledboolean

Whether or not the intro and outro should be played. The default is false

download_button_enabledboolean

Whether to show a download button next to each playlist item in the player.

logo_icon_enabledboolean

Whether to show the BeyondWords logo in the player.

analytics_enabledboolean

Analytics enabled.

analytics_uuid_enabledboolean

Analytics uuid enabled.

analytics_urlstring

Analytics server URL

analytics_custom_urlstring nullable

Custom analytics server URL

analytics_idinteger

Analytics ID

analytics_tag_enabledboolean

Analytics tag enabled

analytics_tagstring nullable

Google Analytics tag

updatedstring

Time at which the object was updated (ISO 8601)

word_highlights_enabledboolean
continuous_playback_mode'none' | 'recent'

The continuous playback mode. Possible values are none or recent

outro_playback_mode'after-all' | 'after-each'

The outro playback mode. Possible values are after-all or after-each