Package google.ads.drx.video.v1

Dizin

AdBreakNotificationService

Yayıncıların canlı yayın içinde reklam araları oluşturmasına olanak tanıyan bir API hizmeti.

CreateAdBreak

rpc CreateAdBreak(CreateAdBreakRequest) returns (AdBreak)

API'yi kullanarak canlı yayın içinde reklam arası oluşturun.

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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
ListAdBreaks

rpc ListAdBreaks(ListAdBreaksRequest) returns (ListAdBreaksResponse)

Canlı yayın sırasında reklam aralarını listeleme API'si.

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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

VideoContentIngestionService

Google Ad Manager'da video içeriği ve ilişkili meta verileri oluşturmaya veya güncellemeye olanak tanıyan, içerik besleme için bir API hizmeti.

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API'yi kullanabilirsiniz. Başarı veya başarısızlıkla ilgili google.rpc.Code içeriğini döndürür.

Örnek istek:

{
   "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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

AdBreak

Canlı video etkinliğindeki bir reklam arası için reklamları belirlemek amacıyla kullanılan reklam arası meta verileri.

Alanlar
name

string

Yalnızca çıkış. Reklam arasının kaynak adı. Bu alan "networks//assets//adBreaks/" biçiminde olacaktır.

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

asset_key, Google Reklam Yönetimi'nde Reklam Arasının oluşturulduğu Canlı Yayın Etkinliği'nin anahtarıdır.

ad_break_id, Reklam Arasının anahtarıdır. YALNIZCA ÇIKIŞ.
expected_duration

Duration

Zorunlu. Beklenen ara süresi.
custom_params

string

Ad Manager'da özel ölçüt hedefleme için bu ara için reklam isteklerine dahil edilecek anahtar/değer çiftleri. Örnek: 'key1=value&key2=value2,value22'
scte_35_cue_out

string

scte35 işaret çıkışından Base 64 olarak kodlanmış veriler. splice_insert() veya time_signal() komutunu içerebilir. Örnekler: time_signal() ile: "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - with splice_insert(): "/DAvAAAAAAAAAA///wFAVIAACPf+/+cAAzUVJAAA
pod_template_name

string

Google Ad Manager kapsül şablonu adı.
break_state

BreakState

Reklam arasının mevcut durumu.

BreakState

Reklam arasının durumu.

Sıralamalar
BREAK_STATE_UNSPECIFIED Reklam arası durumu bilinmiyor.
BREAK_STATE_DECISIONED Reklam Arası kararı başladı ancak henüz kullanıcılara yayınlanmadı.
BREAK_STATE_COMPLETE Reklam arası kullanıcılara yayınlandı.

ClosedCaptionFormat

Altyazı dosyalarının bulunabileceği biçimler.

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 bulunduğu dili 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.

CreateAdBreakRequest

AdBreakNotificationService.CreateAdBreak için istek.

Alanlar
parent

string

Bu alan, bu reklam arasının canlı yayın öğe anahtarını kullanarak ilişkilendirilmesi gereken LiveStreamEvent'i tanımlar. Kimlik, "networks/{ağ_kodu}/assets/{öğe_kodu}" biçiminde olmalıdır.
custom_parent

string

Bu alan, bu reklam arasının özel öğe anahtarı kullanarak ilişkilendirilmesi gereken LiveStreamEvent'i tanımlar. "networks/{ağ_kodu}/customAssets/{öğe_kodu}" biçiminde olmalıdır.
content

string

Bu, GAM içindeki bir içerikle ilişkili olan LiveStreamEvent'i tanımlamanın alternatif bir yoludur. "networks/{ağ_kodu}/kaynaklar/{içerik_kaynak_kimliği}/içerik/{cms_içerik_kimliği}" biçiminde olmalıdır.
ad_break

AdBreak

Zorunlu. Gerçek reklam arası.
ad_break_id

string

Bu, kullanıcıların istek ile sağlayabileceği ad_break_id değeridir.

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 referans verilen 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

İçeriğin Gracenote meta verileri.

Alanlar
gracenote_id

string

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

string

İsteğe bağlı. Bu alan, Gracenote serisi kimliğini belirtir. 'SH' ön ekini almalıdır.

ListAdBreaksRequest

AdBreakNotificationService.ListAdBreaks için istek.

Alanlar
parent

string

İsteğe bağlı. Bu alan, bu reklam arasının canlı yayın öğe anahtarını kullanarak ilişkilendirilmesi gereken LiveStreamEvent'i tanımlar. Kimlik, "networks/{ağ_kodu}/assets/{öğe_kodu}" biçiminde olmalıdır.
custom_parent

string

İsteğe bağlı. Bu alan, bu reklam arasının özel öğe anahtarı kullanarak ilişkilendirilmesi gereken LiveStreamEvent'i tanımlar. "networks/{ağ_kodu}/customAssets/{öğe_kodu}" biçiminde olmalıdır.
content

string

İsteğe bağlı. Bu, GAM içindeki bir içerikle ilişkili olan LiveStreamEvent'i tanımlamanın alternatif bir yoludur. "networks/{ağ_kodu}/kaynaklar/{içerik_kaynak_kimliği}/içerik/{cms_içerik_kimliği}" biçiminde olmalıdır.
page_size

int32

İsteğe bağlı. Döndürülecek maksimum reklam arası sayısı. Hizmet bu değerden daha az bir değer döndürebilir. Belirtilmezse en fazla 10 reklam arası döndürülür. Maksimum değer 100'dür; 100'ün üzerindeki değerler 100'e zorlanır.
page_token

string

İsteğe bağlı. Önceki ListAdBreaks çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi sırasında ListAdBreaks öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListAdBreaksResponse

AdBreakNotificationService.ListAdBreaks için yanıt.

Alanlar
ad_breaks[]

AdBreak

Yalnızca çıkış. İstenen Canlı Yayın Etkinliği ile eşleşen reklam aralarının listesi.
next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa olmaz.

Meta veri

İçeriğin özel meta verileri.

Alanlar
key_values

map<string, Value>

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

SyndicatedVideoContentNames

Ortak kullanıma sunulan tüm içeriğin adlarının listesi.

Alanlar
syndicated_video_content[]

string

Ortak kullanıma sunulan içeriğin adının yinelenen alanı. Bunlar "networks/{ağ_kodu}/kaynaklar/{içerik_kaynak_kimliği}/içerik/{cms_içerik_kimliği}" biçiminde olmalıdır. 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 , Google Ad Manager'da bu içeriğin ait olduğu ağ kodudur.

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

cms_content_id, Google Ad Manager'daki İYS 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 oluşturulur. Bu değer sayısal veya alfasayısal olabilir.
status

VideoContentStatus

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

string

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

Timestamp

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

Timestamp

İçeriğin yayınlanma zamanı. Video, bir başlangıç ve bitiş zamanı belirten Reklam Kurallarına dahil edilmek üzere tasarlandıysa bu alanın doldurulması 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. Videoda videonun ortasında gösterilen reklam araları varsa bu alanın doldurulması 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 sendikasyon ile 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 sunma veya sunmama durum seçenekleri.

Sıralamalar
ACTIVE İçerik hedefli Reklamlar sunulacak.
BLOCKED Durum ENGELLENDİ ise, bu içerikte reklam sunulmaz.
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ı ya da envanter birimlerini veya diğer hedefleme ölçütlerini hedefleyen reklamlar buna karşı yayınlanmaya devam edebilir. Reklamları engellemek için durumu ENGELLENDİ olarak ayarlayın.

VideoContentSyndicationInfo

Standart içerik ve ortak kullanılan içerik arasındaki ilişkileri belirlemeye yönelik meta veriler.

Alanlar
Birleştirme alanı syndication. VideoContentSyndiationMetadata, aşağıdakilerden yalnızca birini içerebilir. syndication şunlardan yalnızca biri olabilir:
canonical_video_content

string

Standart içeriğin adı. "networks/{ağ_kodu}/kaynaklar/{içerik_kaynak_kimliği}/içerik/{cms_içerik_kimliği}" biçiminde olmalıdır. 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ının bağlantısını belirten meta veriler.

Alanlar
video_format

VideoFormat

Videonun biçimi.
video_preconditioned

VideoPreconditioned

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

string

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

VideoPreconditioned

Video içeriğinin koşullu durumudur.

Sıralamalar
NO Henüz koşullandırılmadı.
YES Video koşullandırıldı/bölündü.