Welcome Gracenote Customers!


Welcome to IVA! Gracenote and IVA have partnered to make integrating video into your site as easy as 1,2,3,4.  This page will walk you through making a link to a video.

Step 1: Get your credentials

 

Your customer service representative at Gracenote should provide you with the following when you sign up:

  • Customer ID ( this is your comany's account number)
  • Security Token ( do not share this with anyone outside your organization)
  • Developer ID (used to access the Data from IVA's Web Service)

 Please keep this information in a safe place as you will need it to access content at IVA.



Step 2: Get the data

Gracenote provides their customers with IVA's database of Published IDs. Select the Published ID for the title you want video for.

Please Note:  Gracenote refers to IVA's Published ID's as "IVA Pinpoint ID".  Any documentation on their site will refer to it as that and any documentation on this site will refer to it as the PublishedID.


Step 3:  Get available encodes

Each title in our database is encoded in multiple formats designed to meet the wide variety of screens and operating systems used by consumers to watch content.  Not every encode is available for every title - HD was not around for older films, for example.  
Insert the Published ID for the title you want (244133 in the example below) plus your Developer ID into the URL shown below and IVA OData API will return back the XML with all of the available encodes. Decide the FileType and Rate you want.  Get the URL property for that FileType and Rate. You will need this to make a working link in Step 4. Here is the URL:

http://api.internetvideoarchive.com/1.0/DataService/Encodes()?$filter=PublishedId%20eq%20244133&developerid={yourdeveloperid}


The table below lists the properties that are returned in the XML from the query.  Use any of these properties to make your query more specific.  (Example: if you just want to know if a title is available in HD: Rate=2500.)

Encodes Entity 
Property Description 
PublishedId Unique ID for the VideoAsset.
StreamingFlavorId ID for the type of encode.
DateDigitized The date in which the video was last encoded. 
Rate  The Kbps target for the encode. Ex: 450 = 450 Kbps of the combined audio and video tracks bitrate.
FileType The video format of the encode. Ex: MP4 
URL  This will contain the base URL for the video.  You will use this along with other parameters to create a link to the content. (customers only)
RemoteURL True or False. Determines if the content is redirecting to another server for delivery.  The overwhelming majority of encodes are 'false', meaning they are not being served from a 3rd party. Note: Content not served from IVA is free of charge and not included in the GB billing reports. 
ProprietaryCustomerId Used only for Subscribers who use IVA to encode their own content.   The default value is -1 meaning not proprietary. 
Id Unique ID for the encode. 

For more information on the IVA OData API see: http://www.internetvideoarchive.com/IVA/Support/documentation/data/iva-odata-api 


Step 4: Make a link to the video

To make a link to a video you need your Customer ID, your Security Token, and the base URL you got from the Encodes Entity above.

  • Take the base URL (Encodes Entity)
  • Add your Customer ID
  • Add a time to live (e)
  • Take all 3 (base + CustomerID + time to live), run an MD5 hash using your Security Token and append to URL (h)

When finished your URL should look like this:

http://www.videodetective.net/player.aspx?cmd=6&fmt=4&customerid={CustomerID}&videokbrate={kbrateFromEncodes}&publishedid={PublishedIDoftheAsset}&e=1291562741&h=1e7096ca5689034f5804be881c3c8c2d  


For more information, including a full description of all the parameters and creating the hash code please see this page: http://www.internetvideoarchive.com/IVA/Support/documentation/video/Video-API 


We look forward to working with you!  Should you have any questions please feel free to check out our forums or email our Support Team.  Thanks for choosing Gracenote and IVA!

IVA Support Team              
   
The World's Largest Distributor 
of Online Trailers!