Use Case 3: Building an OTT/VOD Program Guide

Note:
For instructional purposes, the use cases described below use GVD API queries to retrieve and navigate data. For real-world applications, you should populate your databases using the instructions in Getting Seed Data and Updates and map primary database keys to IDs based on instructions in Mapping GNIDs to Primary Database Keys. Then use standard database queries to retrieve and navigate GVD data.
Also, the GNIDs used in this use case are for explanation only. They may change if the element becomes inactive or is deleted.

Process

Below are the recommended steps to create a VOD grid specific to a source of interest.

  1. The VOD/ OTT sources are available in Source XML.

    Example: Netflix U.S. GN1Y0WGNPMP1CG0

    http://gvd-api.gracenote.com/v1/sources?id=GN1Y0WGNPMP1CG0&api_key=<customer_key>

  2. Catalog Items are programs specific to a source. In other words, if a program available is available in VOD sources, it is treated as a separate entity in Catalog Item XML. A list of such catalog items for a Source constitutes a Catalog Manifest (CM)

    Example: “Friends, The One with the Baby on the Bus”

    Catalog Item for HD+ 1080p:

    http:// http://gvd-api.gracenote.com/v1/catalog/item?id=GNAJ2TEYS6X5NEX&api_key=<customer_key>

    Catalog Item for HD 720p:

    http://gvd-api.gracenote.com/v1/catalog/item?id=GN005WF5RFDF8Q6&api_key=<customer_key>

  3. Every Catalog item points to a single program context that is relevant to a Source. The programs metadata is available in Program XML.

    Example:

    Program GNID: GN8F1KAK7F908V0

    Program Context GNID: GN0BZGX7QJB44C7

    http://gvd-api.gracenote.com/v1/programs?id=GN8F1KAK7F908V0&api_key=<customer_key>

  4. All program images, cast and crew for the above programs are available in Media and Contributor XML endpoints respectively. Similarly, Cast/Crew imagery can be located in Media endpoint.

    Example: http://gvd-api.gracenote.com/v1/contributor?id=GN1F46559168PKP&api_key=<customer_key>

    Images are of multiple types (vocabulary) and renditions (size/ aspect ratio). All relevant images that are tagged to Program and Contributors are available in Media Endpoint.

    http://gvd-api.gracenote.com/v1/media?id=GNB6S9RYANEQXCC&api_key=<customer_key>