REST Resource: networks.sources.content

Resource: VideoContent

The metadata for the content to be ingested.

JSON representation
{
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "description": string,
  "metadata": {
    object (Metadata)
  },
  "tmsMetadata": {
    object (TmsMetadata)
  }
}
Fields
status

enum (VideoContentStatus)

The status of the content. If this is omitted the default value will be active.

title

string

Required. The title of the content.

updateTime

string (Timestamp format)

Required. The last modified time of the content.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

publishTime

string (Timestamp format)

The publish time of the content. This is a required field, if the video is designed to be included in Ad Rules that specifies start and end time using number of days before and after the publish time of content.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

Duration of the content. Duration is supported down to the millisecond level.

A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".

cuePoints[]

string (Duration format)

Identifies the cue points. Cue points are places in time where an ad can be inserted in the video. Cue points are supported down to the millisecond level. This is a required field, if the video contains mid-roll ad breaks.

A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".

thumbnailUrl

string

Thumbnail url of the content.

description
(deprecated)

string

Description of the content.

metadata

object (Metadata)

Identifies the custom metadata of the content.

tmsMetadata

object (TmsMetadata)

The TMS info of the content.

VideoContentStatus

Status options to serve or not to serve targeted ads for a content.

Enums
ACTIVE Active.
BLOCKED No ads will be served against this content if the status is BLOCKED.
DELETED The content will be archived in Ad Manager. If Ad Manager receives an ad request for a content marked as DELETED, then house ads, or ads targeted to inventory units or other targeting criteria can still serve against it. To block ads, set the status to BLOCKED.

Metadata

Custom metadata of the content.

JSON representation
{
  "keyValues": {
    string: value,
    ...
  }
}
Fields
keyValues

map (key: string, value: value (Value format))

Identifies the custom metadata of the content as a key-value pair.

"keyValues": {
   "category": "sports",
   "tag": ["soccer", "messi"],
   "views": 700000,
   "rating": 5.5,
}

TmsMetadata

The TMS (Gracenote) metadata for the content.

JSON representation
{
  "tmsId": string,
  "seriesTmsId": string
}
Fields
tmsId

string

Refers to the TMS ID for the content. Required. Should have one of these valid prefixes: 1. 'EP' - episode of a series 2. 'MV' - movie 3. 'SP' - sporting event

seriesTmsId

string

If the content is an episode of a series, this field refers to the series TMS ID. Should be prefixed with 'SH'. Optional.

Methods

update

API to create new content or update its metadata if the content already exists in Ad Manager.