OpenTV ENTera & OpenTV Platform Documentation

Ingesting content group links

Request

To create one or more content group links, send a PUT request to:

Bash
https://<host>:<port>/metadata/content/v1/contentGroupLinks/

This request creates one or more content group links. Each such link associates:

  • One resource (an editorial channel, an editorial content, or a content group) with

  • One or more content groups

You can use a link like this to associate a season content group with its series content group.

Headers

  • Content-Type: application/json

Mandatory arguments

All of the following arguments are part of the request body:

  • Within each block in a contentGroupRefSet, either:

    • id – the ID of the content group, or

    • Both providerId and providerResourceId

  • Within each resourceRef block:

    • Either:

      • id – the ID of the resource, or

      • Both providerId and providerResourceId

    • type – the resource type. Valid values are as follows (note that the value is case-sensitive):

      • editorialContent

      • editorialChannel

      • contentGroup

Example

A POST request with this payload associates one editorial content with one content group:

JSON
{
  "contentGroupLinkSet": [
    {
      "contentGroupRefSet": [
        {
          "id": "67435676"
        }
      ],
      "resourceRef": {
        "id": "9462470",
        "type": "editorialContent"
      }
    }
  ]
}

Response

A successful request returns an HTTP 201 status. The response body contains the URI of the newly-created content group.

A bad request returns an HTTP 400 status.

See also

For full details of this API, see Content and Product Manager (CPM) API documentation: content v1.