Package google.ads.drx.video.v1

Índice

VideoContentIngestionService

Um serviço de API para ingestão de conteúdo que permite criar ou atualizar conteúdo de vídeo e os metadados associados no Google Ad Manager.

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API para criar conteúdo ou atualizar os metadados dele se ele já existir no Ad Manager. Retorna o conteúdo em caso de sucesso ou um google.rpc.Code em caso de falha.

Exemplo de solicitação:

{
   "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"],
       }
   }
}
Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a visão geral do OAuth 2.0.

ClosedCaptionFormat

Os formatos em que os arquivos de legenda podem estar.

Tipos enumerados
CLOSED_CAPTION_FORMAT_UNSPECIFIED O formato das legendas descritivas não foi especificado.
TTML application/ttaf+xml
WEB_VTT text/vtt

ClosedCaptionUrlInfo

Metadados de um arquivo de legenda descritiva.

Campos
language_code

string

O código de idioma IETF BCP-47 que representa o idioma do arquivo de legenda descritiva.
closed_caption_format

ClosedCaptionFormat

O formato do arquivo de legenda descritiva.
url

string

O URL do arquivo de closed caption.

DynamicAdInsertionInfo

Informações relacionadas à Inserção de anúncios dinâmicos.

Campos
video_ingest_url_info

VideoIngestUrlInfo

Um link para o arquivo m3u8 principal usado para o condicionamento e a geração de playlists.
media_update_time

Timestamp

A hora em que o arquivo de vídeo referenciado em video_ingest_url_info foi modificado pela última vez.
closed_caption_url_info[]

ClosedCaptionUrlInfo

O URL do arquivo de closed captions/legenda.
fw_caid

string

Código do recurso personalizado do FreeWheel usado para segmentação de anúncios.

GracenoteMetadata

Os metadados da Gracenote para o conteúdo.

Campos
gracenote_id

string

Obrigatório. Refere-se ao ID da Gracenote do conteúdo. Precisa ter um destes prefixos válidos: 1. "EP": episódio de uma série 2. "MV": filme 3. "SP": evento esportivo
gracenote_series_id

string

Opcional. Esse campo se refere ao ID da série do Gracenote. Precisa ter o prefixo "SH".

Metadados

Metadados personalizados do conteúdo.

Campos
key_values

map<string, Value>

Identifica os metadados personalizados do conteúdo como um par de chave-valor. Apenas strings ou listas de strings são aceitas para valores.

SyndicatedVideoContentNames

A lista de nomes de todo o conteúdo distribuído.

Campos
syndicated_video_content[]

string

Campo repetido do nome do conteúdo distribuído. Eles precisam ter o formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" e pertencer à mesma rede do conteúdo que contém esse campo.

UpdateVideoContentRequest

Solicitação para [VideoContentIngestionService.UpdateVideoContentRequest][].

Campos
video_content

VideoContent

Obrigatório. Os metadados do conteúdo.

VideoContent

Os metadados do conteúdo.

Campos
name

string

Apenas saída. O nome do recurso do conteúdo de vídeo. Esse campo tem o formato: "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"

network_code é o código da rede no Google Ad Manager a que o conteúdo pertence.

content_source_id é o ID da origem de conteúdo no Google Ad Manager a que este conteúdo deve pertencer.

cms_content_id é o ID do conteúdo do CMS no Google Ad Manager, formado como parte da solicitação de anúncio para identificar os anúncios que o Ad Manager pode veicular em relação ao vídeo correspondente. Esse valor pode ser numérico ou alfanumérico.
status

VideoContentStatus

O status do conteúdo. Se for omitido, o valor padrão será "active".
title

string

Obrigatório. O título do conteúdo.
update_time

Timestamp

Obrigatório. A hora da última modificação do conteúdo.
publish_time

Timestamp

A hora de publicação do conteúdo. Esse campo é obrigatório se o vídeo for criado para ser incluído em regras de anúncio que especificam um horário de início e de término.
duration

Duration

Duração do conteúdo. A duração é compatível até o nível de milissegundos.
cue_points[]

Duration

Identifica os pontos de inserção. Os pontos de inserção são marcas de tempo em que é possível inserir um anúncio no vídeo. Os pontos de sinalização são compatíveis até o nível de milissegundos. Esse campo é obrigatório se o vídeo tiver intervalos de anúncio intermediário.
thumbnail_url

string

URL da miniatura do conteúdo.
metadata

Metadata

Identifica os metadados personalizados do conteúdo.
gracenote_metadata

GracenoteMetadata

Metadados relacionados ao Gracenote do conteúdo.
syndication_metadata

VideoContentSyndicationInfo

Metadados relacionados à distribuição do conteúdo.
dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

Metadados relacionados à inserção de anúncios dinâmicos do conteúdo.

VideoContentStatus

Opções de status para veicular ou não anúncios segmentados para um conteúdo.

Tipos enumerados
ACTIVE Anúncios segmentados por conteúdo serão veiculados.
BLOCKED Nenhum anúncio será veiculado nesse conteúdo se o status for "BLOQUEADO".
DELETED O conteúdo será arquivado no Ad Manager. Se o Ad Manager receber uma solicitação de anúncio para um conteúdo marcado como "EXCLUÍDO", os anúncios internos ou direcionados a unidades de inventário ou outros critérios de segmentação ainda poderão ser veiculados. Para bloquear anúncios, defina o status como BLOQUEADO.

VideoContentSyndicationInfo

Os metadados para especificar relações entre conteúdo canônico e conteúdo distribuído.

Campos
Campo de união syndication. VideoContentSyndicationMetadata só pode conter um dos seguintes elementos. syndication pode ser apenas de um dos tipos a seguir:
canonical_video_content

string

O nome do conteúdo canônico. Ele precisa estar no formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" e pertencer à mesma rede do conteúdo que contém esse campo.
syndicated_video_content_names

SyndicatedVideoContentNames

Uma coleção de conteúdo distribuído

VideoFormat

Os formatos em que um conteúdo de vídeo pode ser codificado.

Tipos enumerados
VIDEO_FORMAT_UNSPECIFIED O formato do vídeo não foi especificado.
HLS application/x-mpegURL
DASH application/dash+xml

VideoIngestUrlInfo

Metadados que especificam o link para o arquivo m3u8 usado para condicionamento e geração de playlists.

Campos
video_format

VideoFormat

O formato do vídeo.
video_preconditioned

VideoPreconditioned

Para indicar se o conteúdo já está condicionado para anúncios intermediários, o que significa que os segmentos já estão divididos no momento dos intervalos comerciais.
url

string

O link para o arquivo m3u8.

VideoPreconditioned

O estado condicionado do conteúdo de vídeo.

Tipos enumerados
NO Ainda não foi condicionado.
YES O vídeo foi condicionado/dividido.