Related Programs

TvSportsData/RelatedPrograms

Sports entities are mapped to programs with TMS IDs for related content such as the airings of games, pregame shows, postgame shows, etc.

Response schema: http://gns-schemas.sports.gracenote.com/gns.xsd

Request Parameters

Parameter Mandatory Description
updateId Yes

Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records.

limit Yes

Maximum number of objects to retrieve for processing predictiable batch sizes. Each iteration would retain limit number for same batch size.

Response Body

Response

Description

id

Unique Gracenote id for the relation.

update_id The update id for the relation.
update_action The update action for the relation.
update_date The update date and time for the relation.
relation The sports entity related to a program. 
id The supplier's (Gracenote) id for the related entity.
type
The description of the supplier's (Gracenote) id keyspace.
supplier Name of the supplier (e.g. gns) of the xid.
programs The program that is related to the sports entity.
id The supplier's (tms) id for the related entity.
type The description of the supplier's (tms) id keyspace.
supplier Name of the supplier (e.g. tms) of the xid.

 

Sample Response(s)

 

RELATED PROGRAM (SPORTS EVENT <-> PROGRAM):

  <gns:gns xmlns:gns="http://xml.gracenote.com/gns/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="gns.xsd">
        <related_programs>
            <related_program>
                <id>GN8HW811CQ9RQ00</id>
                <meta>
                    <update_id>93579</update_id>
                    <update_action>INSERT</update_action>
                    <update_date>2017-05-25T15:16:51Z</update_date>
                </meta>
                <relation>
                    <id>GNEZV21BS0KBHSQ</id>
                    <type>sports_event</type>
                    <supplier>gns</supplier>
                </relation>
                <program>
                    <id>14080890</id>
                    <type>root</type>
                    <supplier>tms</supplier>
                </program>
            </related_program>
        </related_programs>
    </gns:gns>