The data dictionary (DD) is a textual view of the data model used by GN IDS. It describes data objects and their properties, including types/formats, requirements, dependencies, and examples.
The Gracenote-controlled vocabulary (CV) is for the set of metadata objects that have pre-defined inlist/enum values in terms managed by GN IDS. The vocabulary helps simplify data indexing and searching and ensures consistency of results across different datasets. Refer to the sections below for additional details about key data types, properties, and values.
Click here to download the Data Dictionary and Controlled Vocabulary spreadsheet.
Program Types and Subtypes
GN IDS uses Program Types for two purposes:
- Present and validate the appropriate set of properties for registration.
- Classify and contextualize registered programs.
Program Subtypes provide additional context for registered programs. Subtype does not affect available properties for registered programs (as Program Type does).
Note: You cannot change a Program Type after a program has been successfully registered.
ID Types
GN IDS requests and responses support several kinds of Gracenote IDs. These IDs are summarized in the table below.
Gracenote IDs
| ID Type | Description | Example |
|---|---|---|
| Source ID | Identifies the registering source. Generated and assigned by Gracenote during onboarding. Attached to all registered programs. | GNLZZZ4XXXXX |
| gnID | Identifies a registered program. This ID is generated during registration for each level of the program hierarchy (as needed). | GNLZZZ4XXXXX |
| TMS ID | A program ID assigned by Gracenote. Successful publishing associates TMS IDs to GnIDs. Used by data licensees to identify certified programs in both On Programs and Source Programs datasets. | MV000191730000 |
External IDs
External IDs are 3rd-party identifiers registered with a program. At least one External ID must be registered and/or assigned as "primary". These IDs associate the program with your source dataset. You can register multiple External IDs with a program record. There are also two special types of External ID that can be specified:
- You must designate one External ID as the "Primary external ID". The primary external ID is your internal identifier for the content and must be unique.
- You can label one External ID as the "Original Provider ID". Original Provider ID indicates the External ID is from the source (producer) of the content.
Each External ID consists of two fields:
- Label: Describes the External ID (for example, hbo.com, IMDB, EIDR, etc.)
- Value: The value of the External ID (for example, 1234-567890-ABCDE)
The Primary External ID and Original Provider ID can have the same values.
Code
Ratings
Ratings are critical values for Publishing, as they are essential for matching and editorial validation of the submitted content. GN IDS allows you to register multiple ratings with a program record. Each rating consists of:
- Rating Body
- Rating (Classification), Not Yet Rated, Rating Exempt
- Advisories
Ratings should be consistent with the presentations they are registered under. When Presentations are used to register market-specific metadata for programs, the ratings under each presentation should be similarly market-specific. For example, a presentation for the US market would contain ratings for US rating bodies, while a presentation spanning multiple regions might contain ratings for multiple regions.