REST Resource: videoContent.networks.sources.content

Ressource: VideoContent

Métadonnées du contenu.

Représentation JSON
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
Champs
name

string

Uniquement en sortie. Nom de ressource du contenu vidéo. Ce champ a le format suivant : "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"

network_code est le code de réseau Google Ad Manager auquel ce contenu appartient.

content_source_id est l'ID de la source de contenu dans Google Ad Manager à laquelle ce contenu doit appartenir.

cms_content_id est l'ID de contenu du CMS dans Google Ad Manager. Il est généré dans le cadre de la demande d'annonce et permet d'identifier les annonces Ad Manager pouvant être diffusées avec la vidéo correspondante. Cette valeur peut être numérique ou alphanumérique.

status

enum (VideoContentStatus)

État du contenu. Si cet attribut est omis, la valeur par défaut est active.

title

string

Obligatoire. Titre du contenu.

updateTime

string (Timestamp format)

Obligatoire. Heure de la dernière modification du contenu.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

publishTime

string (Timestamp format)

Heure de publication du contenu. Ce champ est obligatoire si la vidéo est conçue pour être incluse dans des règles relatives aux annonces qui spécifient une heure de début et de fin.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

Durée du contenu. La durée est prise en charge jusqu'à la milliseconde.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

cuePoints[]

string (Duration format)

Identifie les points de repère. Ces points de repère correspondent aux moments où une annonce peut être insérée dans la vidéo. Les points de repère sont pris en charge jusqu'à la milliseconde près. Ce champ est obligatoire si la vidéo contient des coupures publicitaires mid-roll.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

thumbnailUrl

string

URL de la vignette du contenu.

metadata

object (Metadata)

Identifie les métadonnées personnalisées du contenu.

gracenoteMetadata

object (GracenoteMetadata)

Métadonnées du contenu liées à Gracenote.

syndicationMetadata

object (VideoContentSyndicationInfo)

Métadonnées du contenu liées à la syndication.

dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

Métadonnées du contenu liées à l'insertion dynamique d'annonces.

VideoContentStatus

Options d'état permettant de diffuser ou non des annonces ciblées pour un contenu.

Enums
ACTIVE Les annonces ciblées sur le contenu seront diffusées.
BLOCKED Aucune annonce ne sera diffusée à côté de ce contenu si son état est BLOQUÉ.
DELETED Le contenu sera archivé dans Ad Manager. Si Ad Manager reçoit une demande d'annonce pour un contenu marqué comme SUPPRIMÉ, les auto-promotions, ou les annonces ciblant des blocs d'inventaire ou d'autres critères de ciblage peuvent tout de même être diffusées sur ce contenu. Pour bloquer les annonces, définissez l'état sur BLOQUÉE.

Métadonnées

Métadonnées personnalisées du contenu.

Représentation JSON
{
  "keyValues": {
    string: value,
    ...
  }
}
Champs
keyValues

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

Identifie les métadonnées personnalisées du contenu en tant que paire clé-valeur. Seules les chaînes ou les listes de chaînes sont acceptées comme valeurs.

GracenoteMetadata

Métadonnées Gracenote pour le contenu.

Représentation JSON
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
Champs
gracenoteId

string

Obligatoire. Fait référence à l'ID Gracenote du contenu. Doit comporter l'un des préfixes valides suivants: 1. "EP" - épisode d'une série 2. "MV" - film 3. "SP" - événement sportif

gracenoteSeriesId

string

Facultatif. Ce champ fait référence à l'ID de la série Gracenote. Doit être précédé du préfixe "SH".

VideoContentSyndicationInfo

Métadonnées permettant de spécifier les relations entre le contenu canonique et le contenu syndiqué.

Représentation JSON
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
Champs
Champ d'union syndication. VideoContentSyndiationMetadata ne peut contenir qu'un seul des éléments suivants. syndication ne peut être qu'un des éléments suivants :
canonicalVideoContent

string

Nom du contenu canonique. Il doit être au format suivant : "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" et doivent appartenir au même réseau que le contenu incluant ce champ.

syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

Ensemble de contenu syndiqué

SyndicatedVideoContentNames

Liste des noms de tous les contenus syndiqués.

Représentation JSON
{
  "syndicatedVideoContent": [
    string
  ]
}
Champs
syndicatedVideoContent[]

string

Champ répété contenant le nom du contenu syndiqué. Elles doivent être au format "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" et doivent appartenir au même réseau que le contenu incluant ce champ.

DynamicAdInsertionInfo

Informations relatives à l'insertion dynamique d'annonces.

Représentation JSON
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
Champs
videoIngestUrlInfo

object (VideoIngestUrlInfo)

Lien vers le fichier m3u8 principal utilisé pour le fractionnement et la génération de playlists.

mediaUpdateTime

string (Timestamp format)

Heure de la dernière modification du fichier vidéo référencé dans videoIngestUrlInfo.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

URL du fichier de sous-titres.

fwCaid

string

ID d'élément personnalisé Freewheel utilisé pour le ciblage des annonces.

VideoIngestUrlInfo

Métadonnées spécifiant le lien vers le fichier m3u8 utilisé pour le fractionnement et la génération de playlists.

Représentation JSON
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
Champs
videoFormat

enum (VideoFormat)

Format de la vidéo.

videoPreconditioned

enum (VideoPreconditioned)

Pour indiquer si le contenu est déjà fractionné pour les annonces mid-roll, ce qui signifie que vos segments sont déjà divisés au moment des coupures publicitaires.

url

string

Lien vers le fichier m3u8.

VideoFormat

Formats dans lesquels un contenu vidéo peut être encodé.

Enums
VIDEO_FORMAT_UNSPECIFIED Format vidéo non spécifié.
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

État fractionné du contenu vidéo.

Enums
NO Pas encore intégré.
YES La vidéo a été fractionnée/composée.

ClosedCaptionUrlInfo

Métadonnées pour un fichier de sous-titres.

Représentation JSON
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
Champs
languageCode

string

Code de langue IETF BCP-47 représentant la langue du fichier de sous-titres.

closedCaptionFormat

enum (ClosedCaptionFormat)

Format du fichier de sous-titres.

url

string

URL du fichier de sous-titres.

ClosedCaptionFormat

Formats de fichiers de sous-titres.

Enums
CLOSED_CAPTION_FORMAT_UNSPECIFIED Le format des sous-titres n'a pas été spécifié.
TTML application/ttaf+xml
WEB_VTT text/vtt

Méthodes

update

API pour créer un contenu ou mettre à jour ses métadonnées si le contenu existe déjà dans Ad Manager.