New field available in "contentRating": "country"

New field available in "contentRating": "country"

Postby rkulagow » Wed Jul 06, 2016 2:11 pm

If present, the country field will allow your grabber to ignore ratings bodies that your users may not care about.

Code: Select all
{
    "programID": "EP012692730168",
    "resourceID": "184149",
    "titles": [
        {
            "title120": "Murder, She Wrote"
        }
    ],
    "descriptions": {
        "description100": [
            {
                "descriptionLanguage": "en-GB",
                "description": "Jessica helps a couple run off together, but then one of them turns up dead."
            }
        ],
        "description1000": [
            {
                "descriptionLanguage": "en-GB",
                "description": "While Jessica is on holiday in Martinique, old friend Charlie Garrett, a private investigator, is accused of murdering the woman he was tracking down for a client."
            }
        ]
    },
    "originalAirDate": "1994-11-13",
    "genres": [
        "Drama",
        "Mystery"
    ],
    "episodeTitle150": "Fatal Paradise",
    "metadata": [
        {
            "Gracenote": {
                "season": 11,
                "episode": 7,
                "totalEpisodes": 21
            }
        }
    ],
    "contentRating": [
        {
            "body": "Canadian Parental Rating",
            "code": "G",
            "country": "CAN"
        },
        {
            "body": "The Régie du cinéma",
            "code": "G",
            "country": "CAN"
        },
        {
            "body": "USA Parental Rating",
            "code": "TVG",
            "country": "USA"
        }
    ],
    "duration": 2760,
    "cast": [
        {
            "billingOrder": "01",
            "role": "Actor",
            "nameId": "979",
            "personId": "979",
            "name": "Angela Lansbury"
        },
        {
            "billingOrder": "02",
            "role": "Guest Star",
            "nameId": "65639",
            "personId": "65639",
            "name": "Wayne Rogers"
        },
        {
            "billingOrder": "03",
            "role": "Guest Star",
            "nameId": "10977",
            "personId": "10977",
            "name": "Cassie Yates"
        }
    ],
    "crew": [
        {
            "billingOrder": "01",
            "role": "Executive Producer",
            "nameId": "979",
            "personId": "979",
            "name": "Angela Lansbury"
        }
    ],
    "entityType": "Episode",
    "showType": "Series",
    "hasImageArtwork": true,
    "episodeImage": {
        "width": "240",
        "height": "360",
        "uri": "assets/p1157089_e_v5_ab.jpg",
        "category": "Iconic",
        "primary": "true",
        "tier": "Episode"
    },
    "md5": "/InLJ3R2aaJAV2D+lgGO0g"
}
rkulagow
SD Staff
 
Posts: 847
Joined: Tue Aug 14, 2007 3:15 pm

Re: New field available in "contentRating": "country"

Postby rkulagow » Wed Jul 06, 2016 5:36 pm

The new field will be added to the programs starting 2016-07-07 and will filter in over the next 24 hours or so.
rkulagow
SD Staff
 
Posts: 847
Joined: Tue Aug 14, 2007 3:15 pm

Re: New field available in "contentRating": "country"

Postby gtb » Wed Jul 06, 2016 5:55 pm

rkulagow wrote:The new field will be added to the programs starting 2016-07-07 and will filter in over the next 24 hours or so.

What is the API call to obtain a list of countries and their descriptions for an application to provide for their users?
gtb
 
Posts: 50
Joined: Thu Oct 02, 2014 2:07 pm

Re: New field available in "contentRating": "country"

Postby rkulagow » Wed Jul 06, 2016 6:59 pm

Are you asking about a "rating body" / "country" map?
rkulagow
SD Staff
 
Posts: 847
Joined: Tue Aug 14, 2007 3:15 pm

Re: New field available in "contentRating": "country"

Postby rkulagow » Wed Jul 06, 2016 9:10 pm

I have one more rating that I need clarification for from Gracenote before I re-spin the JSON for programs. At that time I will be able to create a call for the mapping.
rkulagow
SD Staff
 
Posts: 847
Joined: Tue Aug 14, 2007 3:15 pm

Re: New field available in "contentRating": "country"

Postby rkulagow » Thu Jul 07, 2016 1:40 pm

Does this suit your requirement?

https://json.schedulesdirect.org/201412 ... a/ratings/

returns:

{"Motion Picture Association of America":"USA","USA Parental Rating":"USA"}
rkulagow
SD Staff
 
Posts: 847
Joined: Tue Aug 14, 2007 3:15 pm

Re: New field available in "contentRating": "country"

Postby gtb » Tue Jul 12, 2016 4:49 am

rkulagow wrote:Does this suit your requirement?

More than I was looking for, actually. I was primarily looking for the valid countries for selection purposes(*). Having the rating agencies in additional to the countries is more complete. Thanks.


(*) And while someone might only be interested in only a single rating agencies ratings, most of the time (if one is selecting by country, which is what this new capability more easily allows for), I would expect one wants all of the ratings from the countries rating body (so, for the USA, MPAA and VCHIP).
gtb
 
Posts: 50
Joined: Thu Oct 02, 2014 2:07 pm

Re: New field available in "contentRating": "country"

Postby rkulagow » Tue Jul 12, 2016 1:19 pm

The response has been updated:

[{"body":"Motion Picture Association of America","country":"USA"},{"body":"USA Parental Rating","country":"USA"}]
rkulagow
SD Staff
 
Posts: 847
Joined: Tue Aug 14, 2007 3:15 pm

Re: New field available in "contentRating": "country"

Postby kyl416 » Tue Jul 12, 2016 1:56 pm

Is there an example for what the results would be like for Canada when it comes to movies? They're kind of unique where movies are rated on the Provincial level and not nationally.
kyl416
 
Posts: 12
Joined: Tue Feb 05, 2013 12:59 pm

Re: New field available in "contentRating": "country"

Postby rkulagow » Tue Jul 12, 2016 8:43 pm

The list of known ratings bodies has been updated and is available through the API call described above.
rkulagow
SD Staff
 
Posts: 847
Joined: Tue Aug 14, 2007 3:15 pm


Return to Developer

Who is online

Users browsing this forum: No registered users and 1 guest

cron