GetExtCatchUpURL

Description

This functionality in GVP provides the means to integrate in a seamless way a set of external catch-up providers (such as Globosat or MovieCity), which contents, although accessible by GVP user (if they have rights over identified Live channels) are not ingested in GVP but offered by third-party website.

A user will be able to browse the external catchup contents integrated with the rest of contents of the service. This requires that the metadata and all the related information is ingested in GVP. In this scenario, external providers will upload metadata (through the ADI.xml), in order to describe the contents, but the video media is not be uploaded to GVP and it is not be processed by Content Workflow. Instead, a URL or link will allow redirecting the user to the external location of these assets.

Once the user decides to enjoy an external catchup content will be redirected to the site where the content is available (the site of the external catchup provider). In order to the site to know what user is and if has access to the content or not, GVP implements and provides Web services to provide authentication and authorization mechanisms for these external catch-up services.

The user is also able to go directly to the external catchup provider site and login with his GVP-service credentials. In this case, GVP also provides the authentication and authorization mechanisms so the external catchup site can validate the user.

This method only can be used by logged users. The parameter UrlType is optional and has the type UrlType.Normal as default.

Parameters

• token (String, required)

A valid token for identifying the API session context. The token can be anonymous or logged.

• movieId (int, required)

ID of the movie requested.

• urlType (UrlType, optional)

Enum that represent the type of the content.

    0 Normal
    1 Preview 

Returns

Returns a JSON object containing String.

Example:

{

}

Exceptions

None

Caching

This method is cached.

Known issues

None

Version history

API Version Number	Change description	Changes author
2.4	Initial method design	Ricardo Calvo