REST Resource: videoContent.networks.sources.content

Recurso: VideoContent

Son los metadatos del contenido.

Representación 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)
  }
}
Campos
name

string

Solo salida. Es el nombre del recurso del contenido de video. Este campo tiene el siguiente formato: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'

network_code es el código de red en Google Ad Manager al que pertenece este contenido.

content_source_id es el ID de la fuente del contenido en Google Ad Manager al que debe pertenecer este contenido.

cms_content_id es el ID de contenido de CMS en Google Ad Manager y se forma como parte de la solicitud de anuncio para identificar qué anuncios puede publicar Ad Manager en el video correspondiente. Este valor puede ser numérico o alfanumérico.

status

enum (VideoContentStatus)

Es el estado del contenido. Si se omite, el valor predeterminado estará activo.

title

string

Obligatorio. Es el título del contenido.

updateTime

string (Timestamp format)

Obligatorio. Hora de la última modificación del contenido.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

publishTime

string (Timestamp format)

Indica la hora de publicación del contenido. Este campo es obligatorio si el video está diseñado para incluirse en las reglas de anuncios que especifican una hora de inicio y finalización.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

Es la duración del contenido. La duración se admite hasta el nivel de milisegundos.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

cuePoints[]

string (Duration format)

Identifica los puntos de inserción. Los puntos de inserción son momentos específicos en los que se puede insertar un anuncio en el video. Los puntos de inserción se admiten en milisegundos. Este campo es obligatorio si el video contiene pausas publicitarias para anuncios durante el video.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

thumbnailUrl

string

Es la URL en miniatura del contenido.

metadata

object (Metadata)

Identifica los metadatos personalizados del contenido.

gracenoteMetadata

object (GracenoteMetadata)

Metadatos del contenido relacionados con Gracenote.

syndicationMetadata

object (VideoContentSyndicationInfo)

Metadatos del contenido relacionados con la distribución.

dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

Metadatos del contenido relacionados con la inserción de anuncios dinámicos.

VideoContentStatus

Son las opciones de estado para publicar o no anuncios segmentados para un contenido.

Enumeraciones
ACTIVE Se publicarán anuncios orientados por contenido.
BLOCKED No se publicarán anuncios en este contenido si el estado es BLOQUEADO.
DELETED El contenido se archivará en Ad Manager. Si Ad Manager recibe una solicitud de anuncio para un contenido marcado como BORRADO, se pueden seguir publicando anuncios propios o orientados a unidades de inventario, o bien otros criterios de segmentación. Para bloquear anuncios, establece el estado como BLOQUEADA.

Metadatos

Metadatos personalizados del contenido

Representación JSON
{
  "keyValues": {
    string: value,
    ...
  }
}
Campos
keyValues

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

Identifica los metadatos personalizados del contenido como un par clave-valor. Solo se aceptan cadenas o listas de cadenas para los valores.

GracenoteMetadata

Los metadatos de Gracenote para el contenido.

Representación JSON
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
Campos
gracenoteId

string

Obligatorio. Se refiere al ID de Gracenote para el contenido. Debe tener uno de estos prefijos válidos: 1. EP - episodio de una serie 2. “MV” - película 3. 'SP' - evento deportivo

gracenoteSeriesId

string

Opcional. Este campo hace referencia al ID de serie de Gracenote. Debe tener el prefijo “SH”.

VideoContentSyndicationInfo

Los metadatos para especificar las relaciones entre el contenido canónico y el contenido distribuible.

Representación 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.
}
Campos
Campo de unión syndication. VideoContentSyndiationMetadata solo puede contener uno de los siguientes elementos. Las direcciones (syndication) solo pueden ser una de las siguientes opciones:
canonicalVideoContent

string

Es el nombre del contenido canónico. Debe tener el siguiente formato: “networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}” y debe pertenecer a la misma red que el contenido que incluye este campo.

syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

Es un conjunto de contenido distribuido.

SyndicatedVideoContentNames

Es la lista de nombres de todo el contenido distribuido.

Representación JSON
{
  "syndicatedVideoContent": [
    string
  ]
}
Campos
syndicatedVideoContent[]

string

Campo repetido para el nombre del contenido distribuible Deben tener el formato “networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}” y debe pertenecer a la misma red que el contenido que incluye este campo.

DynamicAdInsertionInfo

Información relacionada con la inserción de anuncios dinámicos.

Representación JSON
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
Campos
videoIngestUrlInfo

object (VideoIngestUrlInfo)

Un vínculo al archivo m3u8 principal que se usa para acondicionar y generar la playlist.

mediaUpdateTime

string (Timestamp format)

La hora en la que se modificó por última vez el archivo de video al que se hace referencia en videoIngestUrlInfo.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

La URL al archivo de subtítulos.

fwCaid

string

ID del activo personalizado de FreeWheel que se usa para segmentar anuncios

VideoIngestUrlInfo

Metadatos que especifican el vínculo al archivo m3u8 que se usa para el acondicionamiento y la generación de la playlist.

Representación JSON
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
Campos
videoFormat

enum (VideoFormat)

Corresponde al formato del video.

videoPreconditioned

enum (VideoPreconditioned)

Indicar si el contenido ya está condicionado para los anuncios durante el video, lo que significa que tus segmentos ya están divididos en el momento de las pausas publicitarias.

url

string

El vínculo al archivo m3u8.

Formato del video

Son los formatos en los que se puede codificar el contenido de un video.

Enumeraciones
VIDEO_FORMAT_UNSPECIFIED No se especificó el formato del video.
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

Es el estado ingerido del contenido de video.

Enumeraciones
NO Aún sin acondicionar.
YES Se acondicionó o cortó el video.

ClosedCaptionUrlInfo

Metadatos de un archivo de subtítulos

Representación JSON
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
Campos
languageCode

string

Es el código de idioma IETF BCP-47 que representa el idioma en el que se encuentra el archivo de subtítulos.

closedCaptionFormat

enum (ClosedCaptionFormat)

El formato del archivo de subtítulos.

url

string

Es la URL al archivo de subtítulos.

ClosedCaptionFormat

Los formatos en los que pueden estar los archivos de subtítulos.

Enumeraciones
CLOSED_CAPTION_FORMAT_UNSPECIFIED No se especificó el formato de los subtítulos.
TTML application/ttaf+xml
WEB_VTT text/vtt

Métodos

update

API para crear contenido nuevo o actualizar sus metadatos si el contenido ya existe en Ad Manager.