Skip to main content
Skip table of contents

VOD Product data model

NameTypeDescriptionLocalisedAlways available
_idStringInternal identifier for the object.NoYes
businessProductTypeStringA numeric value provided by the CAS to classify the type of product.NoNo
casIdStringThe identifier of this product within the CAS. This is the technical ID for all conditional-access-related operations.

For the NAGRA CAS, this ID is a numeric value with up to 12 digits.

NoNo
casInstanceNameStringThe name that uniquely identifies the CAS server that manages access to this channel or event.NoNo
casMopIdStringThe MOP ID assigned by the NAGRA CAS to this product, if applicable. The presence of this value depends upon the CAS features that have been activated for the customer project.NoNo
endPurchaseString: a date and time in ISO 8601 formatThe end date and time of the period when the end user may purchase this product.NoNo
endValidityString: a date and time in ISO 8601 formatThe end date and time of the period when this product is valid. Access to the content/event sold by this product is not allowed after this time.NoNo
idStringThe CMS's identifier for the object.NoYes
impulsiveBooleanWhether the product can be acquired by the end-user “impulsively”, that is, without requiring a right to be delivered explicitly from the head-end.

CMS 4 always sets this field to true.

NoNo
isSOCUBoolean

Whether start-up and catch-up can be used with this content.

For PPV and subscription products, the default is configured in the CMS. For other products, the default value is false.

NoNo
orderingBooleanWhether the product can be acquired by the end-user in “ordering” mode, that is, via a right delivered from the head-end.

CMS 4 always sets this field to false.

NoNo
payModeString

Indicates how the product can be paid for when acquired in "ordering" mode.

Must be one of: payableLocally, voucher, orother.

This field should not be present if ordering is false.

NoNo
payPerTimeBooleanWhether this a pay-per-time product.NoNo
priceSub-objectThe prices this product can be purchased for. (See following rows.)

MDS only currently supports one price in one currency per product.

NoNo
price.currencyStringThe currency the price is in.NoYes
price.endPurchaseString: a date and time in ISO 8601 formatThe end date and time of the period when the end user may purchase the product at this price.NoNo
price.providerIdStringThe identifier of the metadata provider, from the id of the export's CMSVodData element.NoYes
price.startPurchaseString: a date and time in ISO 8601 formatThe start date and time of the period when the end user may purchase the product at this price.NoNo
price.valueNumberThe value of the price in the specified currency.NoYes
PrivateMetadataString

Used to pass data directly from the customer to the end-user device without any processing.

One possible use is to pass a list of keyword/value pairs, separated by semi-colons.

No validation is done by the Metadata Server on the value of this field.

NoNo
ProfileNameStringAllows a product to be associated to an externally-managed profile.NoNo
promotionsArray of stringsA list of IDs of promotions that apply to this product.

Since MDS 1.2.

NoNo
providerStringThe identifier of the metadata provider, from the id of the export's CMSVodData element.NoYes
rentalDurationIntegerNumber of seconds from the first viewing during which a VOD asset can still be watched (for example, 86400).NoNo
startPurchaseString: a date and time in ISO 8601 formatThe start date and time of the period when the end user may purchase this product.NoNo
startValidityString: a date and time in ISO 8601 formatThe start date and time of the period when this product is valid. Access to the content/event sold by this product is not allowed before this time.NoNo
titleStringThe name of the product.

This field is not localised. Multi-language clients should use the TitleForProduct field instead

NoYes
TitleForProductStringThe name of the product.YesNo
typeString

The type of product.

Must be one of: subscriptionsinglemultiple, or bundle.

  • single products reference only one content item.
  • multiple products reference an immutable selection of content items, payable in a single transaction.
  • subscription products reference a mutable selection of content items, payable as a recurring subscription.
NoYes
xmlStringThe type of object. Always Product.NoYes
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.