Building a Programs Database
Mapping GNIDs to Primary Database Keys
GVD uses several kinds of Gracenote IDs (GNIDs). The table below describes these IDs and how they map to primary database keys.
| ID | Description |
|---|---|
| Root ID | A general term used for the top-level GNID of an element. In general, this is the first ID listed in the endpoint output. For example:<gvd_object><id>GN05ZYT1KM87411</id><type>CatalogItem</type> |
| Country GNID | Primary key for a country. |
| Lineup GNID | Primary key for a single lineup / headend. Composite Key: `[Provider |
| Source GNID | Primary key for a Channel or VOD Source. For example, GN5KSEKRB68XJME for NBC. |
| Catalog Item GNID | GNID for a program specific to a Source. Composite Key: `[Source GNID |
| Catalog Manifest GNID | All the programs associated to a Source (Channel / VOD) will be encapsulated in a Catalog manifest. This manifest GNID is again specific to a source. Composite Key: `[Catalog Item GNID |
| Availability GNID | Schedule ID for a Channel's listings for the day. Not a timeslot ID. Composite Key: [Source GNID + Day] |
| Availability Manifest GNID | A GNID for the schedule manifest (up to 14 days) for a given source. Composite Key: `[Availability Day GNID |
| Program GNID | Root level ID for a program that has language/country/source variants. |
| Program Context GNID | Primary identifier of a program associated to a TV schedule grid or a VOD catalog. The ID is specific to [Language / Country & Language / Source]. |
| Contributor GNID | A Root level ID for a Cast or Crew member. |
| Contributor Name GNID | Name ID for candidates having multiple names. For example, Robert Downey Jr. Composite Key: [Contributor GNID + Name] |
| Media GNID | A GNID for image. Unique for an image type [Banner, Iconic, etc.], aspect ratio, dimensions. |
| Video Descriptor Taxonomy Item GNID | Primary Key for a Keyword Category associated to Programs. For example, Scenario, Setting (Time Period), etc. |
| Descriptor GNID | A Keyword ID that is tagged to a Program to support Search & Recommendations use case. For example, Relationships, Love Story, Early 2010s, and so on. |
Last modified on