Package google.ads.drx.video.v1

Dizin

VideoContentIngestionService

İçerik besleme için bir API hizmeti. Bu hizmet, Google Ad Manager'da video içeriği ve ilişkili meta verilerin oluşturulmasına veya güncellenmesine olanak tanır.

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

İçerik zaten Ad Manager'da varsa yeni içerik oluşturmak veya meta verilerini güncellemek için kullanılan API. Başarılı olursa içeriği, başarısız olursa google.rpc.Code değerini döndürür.

Örnek bir istek şu şekilde görünür:

{
   "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"],
       }
   }
}
Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

ClosedCaptionFormat

Altyazı dosyalarının biçimleri.

Sıralamalar
CLOSED_CAPTION_FORMAT_UNSPECIFIED Altyazı biçimi belirtilmedi.
TTML application/ttaf+xml
WEB_VTT text/vtt

ClosedCaptionUrlInfo

Bir altyazı dosyasının meta verileri.

Alanlar
language_code

string

Altyazı dosyasının dilini temsil eden IETF BCP-47 dil kodu.
closed_caption_format

ClosedCaptionFormat

Altyazı dosyasının biçimi.
url

string

Altyazı dosyasının URL'si.

DynamicAdInsertionInfo

Dinamik Reklam Ekleme ile ilgili bilgiler.

Alanlar
video_ingest_url_info

VideoIngestUrlInfo

Koşullandırma ve oynatma listesi oluşturma için kullanılan ana m3u8 dosyasının bağlantısı.
media_update_time

Timestamp

video_ingest_url_info içinde başvurulan video dosyasının en son değiştirildiği zaman.
closed_caption_url_info[]

ClosedCaptionUrlInfo

Altyazı dosyasının URL'si.
fw_caid

string

Reklam hedefleme için kullanılan Freewheel özel öğe kimliği.

GracenoteMetadata

İçerik için Gracenote meta verileri.

Alanlar
gracenote_id

string

Zorunlu. İçeriğin Gracenote kimliğini ifade eder. Şu geçerli öneklerden birine sahip olmalıdır: 1. "EP" - 2. serinin bölümü. "MV" - movie 3. "SP": Spor etkinliği
gracenote_series_id

string

İsteğe bağlı. Bu alan, Gracenote dizi kimliğini ifade eder. "SH" ön ekini almalıdır.

Meta veri

İçeriğin özel meta verileri.

Alanlar
key_values

map<string, Value>

İçeriğin özel meta verilerini anahtar/değer çifti olarak tanımlar. Değerler için yalnızca dizeler veya dizelerin listesi kabul edilir.

SyndicatedVideoContentNames

Tüm ortak kullanılan içeriklerin adlarının listesi.

Alanlar
syndicated_video_content[]

string

Yinelenen alan, ortak kullanılan içeriğin adı. "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" biçiminde olmalı ve bu alanı içeren içerikle aynı ağa ait olmalıdır.

UpdateVideoContentRequest

[VideoContentIngestionService.UpdateVideoContentRequest][] için istek.

Alanlar
video_content

VideoContent

Zorunlu. İçeriğin meta verileri.

Video İçeriği

İçeriğin meta verileri.

Alanlar
name

string

Yalnızca çıkış. Video içeriğinin kaynak adı. Bu alan şu biçimdedir: "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"

network_code, bu içeriğin ait olduğu Google Ad Manager'daki ağ kodudur.

content_source_id, bu içeriğin ait olması gereken Google Ad Manager'daki içerik kaynağı kimliğidir.

cms_content_id, Google Ad Manager'daki CMS içerik kimliğidir. Ad Manager'ın ilgili videoya göre hangi reklamları yayınlayabileceğini belirlemek için reklam isteğinin bir parçası olarak biçimlendirilir. Bu değer sayısal veya alfasayısal olabilir.
status

VideoContentStatus

İçeriğin durumu. Bu değer atlanırsa varsayılan değer etkin olur.
title

string

Zorunlu. İçeriğin başlığı.
update_time

Timestamp

Zorunlu. İçeriğin son değiştirilme zamanı.
publish_time

Timestamp

İçeriğin yayınlanma zamanı. Video, başlangıç ve bitiş zamanı belirten reklam kurallarına dahil edilecek şekilde tasarlanmışsa bu alan zorunludur.
duration

Duration

İçeriğin süresi. Süre, milisaniye düzeyine kadar desteklenir.
cue_points[]

Duration

İşaret noktalarını tanımlar. İşaret noktaları, videoda bir reklamın eklenebileceği zamanlardır. İşaret noktaları milisaniye düzeyine kadar desteklenir. Video, videonun ortasında gösterilen reklam araları içeriyorsa bu alan zorunludur.
thumbnail_url

string

İçeriğin küçük resim URL'si.
metadata

Metadata

İçeriğin özel meta verilerini tanımlar.
gracenote_metadata

GracenoteMetadata

İçeriğin Gracenote ile ilgili meta verileri.
syndication_metadata

VideoContentSyndicationInfo

İçeriğin sendikasyonla ilgili meta verileri.
dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

İçeriğin Dinamik Reklam Ekleme ile ilgili meta verileri.

VideoContentStatus

Bir içerik için hedeflenmiş reklamların yayınlanıp yayınlanmayacağını belirlemeye yönelik durum seçenekleri.

Sıralamalar
ACTIVE İçerik hedefli reklamlar yayınlanır.
BLOCKED Durum BLOCKED (ENGELENDİ) ise bu içerikte reklam yayınlanmaz.
DELETED İçerik, Ad Manager'da arşivlenir. Ad Manager, SİLİNDİ olarak işaretlenmiş bir içerik için reklam isteği alırsa kurum reklamları veya envanter birimlerini ya da diğer hedefleme ölçütlerini hedefleyen reklamlar bu içerikte yayınlanmaya devam edebilir. Reklamları engellemek için durumu ENGELLEDİ olarak ayarlayın.

VideoContentSyndicationInfo

Standart içerik ile ortak kullanılan içerik arasındaki ilişkileri belirtmek için kullanılan meta veriler.

Alanlar
syndication birleşik alanı. VideoContentSyndicationMetadata yalnızca aşağıdakilerden birini içerebilir. syndication aşağıdakilerden yalnızca biri olabilir:
canonical_video_content

string

Standart içeriğin adı. "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" biçiminde olmalı ve bu alanı içeren içerikle aynı ağa ait olmalıdır.
syndicated_video_content_names

SyndicatedVideoContentNames

Ortak kullanılan içerik koleksiyonu

VideoFormat

Video içeriğinin kodlanabileceği biçimler.

Sıralamalar
VIDEO_FORMAT_UNSPECIFIED Video biçimi belirtilmedi.
HLS application/x-mpegURL
DASH application/dash+xml

VideoIngestUrlInfo

Koşullandırma ve oynatma listesi oluşturma için kullanılan m3u8 dosyasına bağlantıyı belirten meta veriler.

Alanlar
video_format

VideoFormat

Videonun biçimi.
video_preconditioned

VideoPreconditioned

İçeriğin videonun ortasında gösterilen reklamlar için koşullandırılıp koşullandırılmadığını belirtmek için kullanılır. Bu, segmentlerinizin reklam araları sırasında zaten bölündüğünü gösterir.
url

string

M3U8 dosyasının bağlantısı.

VideoPreconditioned

Video içeriğinin koşullandırılmış durumu.

Sıralamalar
NO Henüz koşullandırılmadı.
YES Video koşullandırılmış/bölünmüş olmalıdır.