NormalizedVideo

Station-normalized data for a video.

The Local Streaming data model has three types repsenting a video:

PbsVideo: Base type, read-only and synced from PBS Media Manager,
Video: Global video metadata overriding PbsVideo metadata for all stations, and
StationVideo: Station video metadata overriding Video and PbsVideo metadata for individual stations.

The NormalizedVideo is a combination of all three types for a specific station and country.

type NormalizedVideo {
  availabilities: NormalizedVideoAvailabilities
  contentAdvisory: String
  contentDescriptors: [ContentDescriptor]
  contentRating: ContentRating
  createdAt: DateTime
  descriptionLong: String
  descriptionShort: String
  duration: Int
  embedCodeVideoId: String
  episodeNumber: Int
  exclude: Boolean
  for: NormalizedVideoFor
  funderMessage(
    stripHtml: Boolean
  ): String
  googleAdManagerVastAdTagUrl: URL
  id: String
  image(
    profile: String!
  ): ImageWithProfile
  images: [ImageWithProfile]
  isAvailable: Boolean
  isNotAvailableReason: String
  isPublicAvailable: Boolean
  normalizedShow(
    country: CountryCode
    stationId: UUID
  ): NormalizedShow
  pbsVideoPlaybackFiles(
    forPassport: Boolean!
  ): NormalizedPbsVideoPlaybackFiles
  premiereDate: DateTime
  season: Int
  showId: String
  skipSponsorship: Boolean
  slug: String
  title: String
  titleShort: String
  tvScheduleIds: [String]
  upNextDuration: Int
  upNextStart: Int
  updatedAt: DateTime
  videoType: VideoType
  watchPosition(
    viewerId: String!
  ): NormalizedVideoWatchPosition
}

Fields

`NormalizedVideo.availabilities` ● `NormalizedVideoAvailabilities` object references

Detailed video availability information by availability window.

`NormalizedVideo.contentAdvisory` ● `String` scalar references

`NormalizedVideo.contentDescriptors` ● `[ContentDescriptor]` list enum references

`NormalizedVideo.contentRating` ● `ContentRating` enum references

`NormalizedVideo.createdAt` ● `DateTime` scalar references

`NormalizedVideo.descriptionLong` ● `String` scalar references

`NormalizedVideo.descriptionShort` ● `String` scalar references

`NormalizedVideo.duration` ● `Int` scalar references

Total video duration in seconds.

`NormalizedVideo.embedCodeVideoId` ● `String` scalar references

ID for PBS Media Manager content embeds with PBS Partner Player.

`NormalizedVideo.episodeNumber` ● `Int` scalar references

`NormalizedVideo.exclude` ● `Boolean` scalar references

Whether this video should be excluded from presentation.

This is for reference only. See NormalizedVideo.isAvailable for true availability.

`NormalizedVideo.for` ● `NormalizedVideoFor` object references

Provides context of what station, country, and source this video is normalized for.

`NormalizedVideo.funderMessage` ● `String` scalar references

Funder message from source content (if set).

Cannot be modified.

`NormalizedVideo.funderMessage.stripHtml` ● `Boolean` scalar references

`NormalizedVideo.googleAdManagerVastAdTagUrl` ● `URL` scalar references

Base Google Ads VAST URL for PBS video preroll.

Consumers must still add the following search parameters to the URL:

correlator: random interger (IAM SDK handle this automatically where available)
ppid: client ID alphanumeric characters only (use Viewer ID (without dashes) if available, otherwise an anonymous client ID).
cust_params: URL encoded search string of additional parameters.
- apptype: StationApp
- station: Station call sign, uppercase
- deviceID: Device model name (not ID) (e.g., "Roku Premiere")
- OTTDevice: Device type (e.g., ROKU, IOS, TVOS, etc.)
- PBSuser: "yes" or "no" for whether the viewer of the video is logged in to a PBS account.
- passport: "yes" or "no" for whether the viewer of the video has Passport.

Comlete example URL:

https://pubads.g.doubleclick.net/gampad/ads
  ?ad_rule=1
  &ciu_szs=728x90
  &cmsid=2588203
  &env=vp
  &gdfp_req=1
  &impl=s
  &output=vmap
  &sz=400x300
  &unviewed_position_start=1
  &iu=/22540141786/n6735.pbs/PBS_Video_National
  &vid=3092213789
  &correlator=1246120129220136
  &ppid=53e2d614896d4c9083d53da7bf7050be
  &cust_params=apptype%3DStationApp%26station%3DKCTS%26deviceID%3D04490af1-ccf1-5edb-b4f2-b7c4a8150c3c%26OTTDevice%3DRoku%26PBSuser%3Dyes%26passport%3Dno