Skip to main content

Update AOD

PUT 

/bv/cms/v1/aods/:id

Modifies the details of an existing AOD.


Required field(s):

  • id
  • name

  • Returns a 400/BadRequest error if the request body is invalid.
  • Returns a 404/NotFound error if the requested resource is not found.

Request

Path Parameters

    id stringrequired

    Required. The unique id of the AOD resource.

Header Parameters

    x-bv-org-id stringrequired

    To invoke this API using api_token, you need to set the x-bv-org-id header to specify the organization for which you want to perform the action.

Body

required
    name stringrequired

    Required. The name of the AOD resource.

    metadata objectrequired

    Required. The metadata of the AOD resource.

    short_description string

    The short description of the resource.

    long_description string

    The long description of the resource.

    labels object[]

    The labels of the resource.

  • Array [
  • name The label name (string)
  • ]
  • schedule object

    Optional. The schedule setting of the AOD resource.

    enable booleanrequired

    Enable VOD viewing schedule or not.

    start_time date-timerequired

    VOD viewing start time. Users can only watch the VOD within the specified start time and end time.

    end_time date-timerequired

    VOD viewing end time. Users can only watch the VOD within the specified start time and end time.

    cover_image object

    Optional. The setting of cover image.

    type stringrequired

    Possible values: [COVER_IMAGE_TYPE_AUTO, COVER_IMAGE_TYPE_CUSTOMIZE]

    Required. Indicates the cover image type.

    customize object

    Optional. Required if type is COVER_IMAGE_TYPE_CUSTOMIZE.

    library_id stringrequired

    Required. The library id of the cover image.

    security object

    Optional. The setting of security. Only valid when AOD is succeeded.

    privacy objectrequired

    Required. Specify the content visibility.

    type stringrequired

    Possible values: [SECURITY_PRIVACY_TYPE_PUBLIC, SECURITY_PRIVACY_TYPE_TOKEN]

    • SECURITY_PRIVACY_TYPE_PUBLIC: The viewers can access the content without any restriction.
    • SECURITY_PRIVACY_TYPE_TOKEN: The viewers can access the content with tokens or redeem codes.
    token object

    Optional. Required if type is SECURITY_PRIVACY_TYPE_TOKEN.

    device_limit int32

    Optional. The limit of the concurrent devices for a token or a redeem code. Default: 0 (Unlimited). Maximum: 1000.

    watermark object

    Optional. Add watermarks to the player when playing the content, it's not supported for AOD.

    enabled booleanrequired

    Required. Enable watermark.

    type stringrequired

    Possible values: [WATERMARK_TYPE_IMAGE, WATERMARK_TYPE_USER_ID]

    Required. Indicates the type of watermark.

    position stringrequired

    Possible values: [WATERMARK_POSITION_BOTTOM_RIGHT, WATERMARK_POSITION_BOTTOM_MIDDLE, WATERMARK_POSITION_BOTTOM_LEFT, WATERMARK_POSITION_CENTER_RIGHT, WATERMARK_POSITION_CENTER_LEFT, WATERMARK_POSITION_TOP_RIGHT, WATERMARK_POSITION_TOP_MIDDLE, WATERMARK_POSITION_TOP_LEFT, WATERMARK_POSITION_RANDOM, WATERMARK_POSITION_CUSTOM]

    Required. The position of the watermark.

    image object

    Optional. Required if type is WATERMARK_TYPE_IMAGE.

    library_id stringrequired

    Required. The library id of the image.

    size floatrequired

    Required. The size of the watermark. The range of values that can be set is from 1 to 50.

    offset object

    Optional. Required if type is WATERMARK_POSITION_CUSTOM.

    x int32required

    Required. The x-axis position of the watermark. Represented as a percentage of the image width. The range of values that can be set is from 1 to 100.

    y int32required

    Required. The y-axis position of the watermark. Represented as a percentage of the image height. The range of values that can be set is from 1 to 100.

    domain_control object

    Optional. Specify the domains that will be allowed to embed the iframe.

    enabled boolean

    Optional. Enable domain control.

    domains string[]

    Optional. The list of domains that will be allowed to embed the iframe.

    protection object

    Optional. Immutable. The content encryption.

    type Optional. Indicates the type of protection (string)

    Possible values: [PROTECTION_TYPE_DRM]

    • PROTECTION_TYPE_DRM: The content will protected by DRM.
    geo_control string[]

    Immutable. Specify the alpha-2 codes (See: https://www.iban.com/country-codes) to restrict access to the content by geo locations. Allow all regions when empty.

    showroom object

    Optional. The showroom setting of the AOD resource.

    model object

    Optional. The model of showroom preferences.

    libraries object[]

    Optional. The library assets that is used by the model.

  • Array [
  • id stringrequired

    Required. The library id of the asset.

  • ]
  • player object

    Optional. The setting of player.

    player_setting_id string

Responses

A successful response.

Schema

    object

Loading...