Accessing Video Descriptors
To make full use of the Video Descriptors feature, integrate your application with these two endpoints:
To access hierarchically-organized Video Descriptors, use the Video Descriptors Taxonomy endpoint.
To access the Video Descriptors specifically tagged in the Programs endpoint, use the Program Context endpoint.
Video Descriptor Updates
Video descriptor updates are expected to be less frequent than other endpoints. It is anticipated that updates will happen quarterly, but may occur monthly if needed. You will be provided with advanced notice of any upcoming taxonomy change.
Each Video Descriptor Taxonomy element is comprised of a single Type and its underlying keywords to simplify the referential integrity between versions. For example, if a Video Mood keyword 'Serious' is updated, you will receive all Video Mood keywords in the next update. Most updates are rolled into a single quarterly update for ease of processing. This means that the update could contain simple label changes and/or changes to the hierarchy.
Types of Changes
Types of changes that can be expected in the Video Descriptor Taxonomy include:
- New keyword added
- Keyword label change
- Keyword Delete
- Keyword parent change (Hierarchy change)
- New type addition with child keywords
When requesting updates, the most recent version of a video descriptor taxonomy is returned. Updates are not 'replayed' as a log of changes. For example, if a keyword label is modified once, and then modified again, the next call for updates includes the keywords from that type only once in the response, with latest updateId. For this reason, updateIds in a response are not consecutive, although video descriptor taxonomy output is sorted by updateId.