Package google.ads.drx.video.v1

Índice

VideoContentIngestionService

Es un servicio de API para la transferencia de contenido que permite crear o actualizar contenido de video y sus metadatos asociados en Google Ad Manager.

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API para crear contenido nuevo o actualizar sus metadatos si el contenido ya existe en Ad Manager. Devuelve el contenido si la operación se realiza correctamente o un google.rpc.Code si falla.

El siguiente es un ejemplo de solicitud:

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}
Alcances de la autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

Para obtener más información, consulta la Descripción general de OAuth 2.0.

ClosedCaptionFormat

Formatos en los que pueden estar los archivos de subtítulos.

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

ClosedCaptionUrlInfo

Son los metadatos de un archivo de subtítulos.

Campos
language_code

string

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

ClosedCaptionFormat

Es el formato del archivo de subtítulos.
url

string

Es la URL del archivo de subtítulos.

DynamicAdInsertionInfo

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

Campos
video_ingest_url_info

VideoIngestUrlInfo

Es un vínculo al archivo m3u8 principal que se usa para el acondicionamiento y la generación de la playlist.
media_update_time

Timestamp

Es la fecha y hora en que se modificó por última vez el archivo de video al que se hace referencia en video_ingest_url_info.
closed_caption_url_info[]

ClosedCaptionUrlInfo

Es la URL del archivo de subtítulos.
fw_caid

string

Es el ID del activo personalizado de FreeWheel que se usa para la segmentación de anuncios.

GracenoteMetadata

Son los metadatos de Gracenote para el contenido.

Campos
gracenote_id

string

Obligatorio. Se refiere al ID de Gracenote del contenido. Debe tener uno de los siguientes prefijos válidos: 1. "EP": Episodio de una serie 2. "MV" (película 3) "SP" (evento deportivo)
gracenote_series_id

string

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

Metadatos

Son los metadatos personalizados del contenido.

Campos
key_values

map<string, Value>

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

SyndicatedVideoContentNames

Es la lista de nombres de todo el contenido sindicado.

Campos
syndicated_video_content[]

string

Es un campo repetido del nombre del contenido sindicado. Deben tener el formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" y pertenecer a la misma red que el contenido que incluye este campo.

UpdateVideoContentRequest

Es la solicitud de [VideoContentIngestionService.UpdateVideoContentRequest][].

Campos
video_content

VideoContent

Obligatorio. Son los metadatos del contenido.

Contenido del video

Son los metadatos del contenido.

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 de contenido en Google Ad Manager a la que debe pertenecer este contenido.

cms_content_id es el ID de contenido del CMS en Google Ad Manager, que 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

VideoContentStatus

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

string

Obligatorio. Es el título del contenido.
update_time

Timestamp

Obligatorio. Es la hora de la última modificación del contenido.
publish_time

Timestamp

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

Duration

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

Duration

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

string

Es la URL de la miniatura del contenido.
metadata

Metadata

Identifica los metadatos personalizados del contenido.
gracenote_metadata

GracenoteMetadata

Son los metadatos relacionados con Gracenote del contenido.
syndication_metadata

VideoContentSyndicationInfo

Son los metadatos relacionados con la distribución del contenido.
dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

Son los metadatos relacionados con la inserción de anuncios dinámicos del contenido.

VideoContentStatus

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

Enums
ACTIVE Se publicarán anuncios segmentados por contenido.
BLOCKED No se publicarán anuncios en este contenido si el estado es BLOCKED.
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 anuncios segmentados para unidades de inventario o para otros criterios de segmentación. Para bloquear anuncios, establece el estado como BLOCKED.

VideoContentSyndicationInfo

Son los metadatos para especificar las relaciones entre el contenido canónico y el contenido sindicado.

Campos
Campo de unión syndication. VideoContentSyndicationMetadata solo puede contener uno de los siguientes elementos. syndication puede ser solo uno de los parámetros siguientes:
canonical_video_content

string

Es el nombre del contenido canónico. Debe tener el formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" y pertenecer a la misma red que el contenido que contiene este campo.
syndicated_video_content_names

SyndicatedVideoContentNames

Colección de contenido distribuible

Formato del video

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

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

VideoIngestUrlInfo

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

Campos
video_format

VideoFormat

Es el formato del video.
video_preconditioned

VideoPreconditioned

Indica si el contenido ya está acondicionado para anuncios durante el video, lo que significa que ya se dividieron sus segmentos en función de las pausas publicitarias.
url

string

Vínculo al archivo m3u8.

VideoPreconditioned

Es el estado acondicionado del contenido de video.

Enums
NO Aún no se acondicionó.
YES El video se acondicionó o dividió.