Package google.ads.drx.video.v1

Dizin

Reklam Arası Hizmeti

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

ReklamArası Oluştur

rpc CreateAdBreak(CreateAdBreakRequest) returns (AdBreak)

API ile canlı yayın içinde bir 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'a Genel Bakış başlıklı makaleye bakın.
ListeReklam Araları

rpc ListAdBreaks(ListAdBreaksRequest) returns (ListAdBreaksResponse)

Canlı Yayın içindeki 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'a Genel Bakış başlıklı makaleye bakın.

Videoİçerik Besleme Hizmeti

Google Ad Manager'da video içeriği ve bu içerikle ilişkili meta verilerin oluşturulmasına veya güncellenmesine olanak tanıyan bir içerik besleme API'si.

Video İçeriği Güncelleme

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

Yeni içerik oluşturmak veya içerik Ad Manager'da zaten mevcutsa meta verilerini güncellemek için API. İçerik başarılı olduğunda veya başarısız olduğunda google.rpc.Code döndürür.

Örnek bir 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'a Genel Bakış başlıklı makaleye bakın.

Reklam Arası

Canlı video etkinliğinde bir reklam arası için reklamlara karar vermek üzere 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 Ad Manager'da 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 arayla ilgili reklam isteklerine dahil edilecek anahtar/değer çiftleri. Örnek: 'anahtar1=değer&anahtar2=değer2,değer22'
scte_35_cue_out

string

Ste35 ipucundan yola çıkarak Base 64 kodlamalı veriler. splice_insert() veya time_signal() komutunu içerebilir. Örnekler: - time_signal() ile: “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - splice_insert() ile: "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALVAAAAAAA="AU
pod_template_name

string

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

BreakState

Reklam arasının mevcut durumu.

Ara Durum

Reklam arasının durumu.

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

AltyazıAlt Biçimi

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

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

Kapalı Başlık URL'si Bilgisi

Bir altyazı dosyası için meta veri.

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.

Reklam Arası İsteği Oluştur

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. "networks/{network_code}/assets/{asset_code}" biçiminde olmalıdır
custom_parent

string

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

string

Bu, GAM içindeki bir içerikle ilişkiliyse LiveStreamEvent'i tanımlamanın alternatif bir yoludur. "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" biçiminde olmalıdır
ad_break

AdBreak

Zorunlu. Asıl reklam arası.
ad_break_id

string

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

DinamikReklam Ekleme Bilgisi

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ştirilme 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.

GracenoteMeta verileri

İçeriğin Gracenote meta verileri.

Alanlar
gracenote_id

string

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

string

İsteğe bağlı. Bu alan, Gracenote dizi kimliğini belirtir. Ön eki "SH" olmalıdır.

ListeAdBreaksİsteği

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. "networks/{network_code}/assets/{asset_code}" biçiminde olmalıdır
custom_parent

string

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

string

İsteğe bağlı. Bu, GAM içindeki bir içerikle ilişkiliyse LiveStreamEvent'i tanımlamanın alternatif bir yoludur. "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" 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 düşük değer döndürebilir. Belirtilmemesi halinde 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 bir ListAdBreaks çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu değeri girin.

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

ListeAdBreaksResponse

AdBreakNotificationService.ListAdBreaks yanıtı.

Alanlar
ad_breaks[]

AdBreak

Yalnızca çıkış. İstenen LiveStreamEvent ile eşleşen Reklam Aralarının listesi.
next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar bulunmaz.

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 dize listesi kabul edilir.

Sendikasyon Video İçeriği Adları

Tüm birleştirilmiş içeriğin adlarının listesi.

Alanlar
syndicated_video_content[]

string

Ortak kullanılan içerik adının tekrarlanan alanı. Bunların "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" biçiminde olması ve bu alanı içeren içerikle aynı ağa ait olması gerekir.

Video İçeriği Güncelleme

[VideoContentIngestionService.UpdateVideoContentRequest][] isteği.

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ın biçimi şu şekildedir: "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, Google Ad Manager'da bu içeriğin ait olması gereken içerik kaynağı kimliğidir.

cms_content_id, Ad Manager'da ilgili video için Ad Manager'ın hangi reklamları yayınlayabileceğini belirlemek amacıyla reklam isteğinin bir parçası olarak oluşturulan İYS içerik kimliğidir. Bu değer sayısal veya alfanümerik olabilir.
status

VideoContentStatus

İçeriğin durumu. 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 zorunlu bir alandır.
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. Videonun ortasında gösterilen reklam araları varsa bu zorunlu bir alandır.
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.

VideoİçerikDurumu

Bir içerik için hedeflenmiş reklamlar yayınlanıp yayınlanmayacağına ilişkin durum seçenekleri.

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

Videoİçerik Sendikasyonu Bilgisi

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

Alanlar
Birlik alanı syndication. VideoContentSyndiationMeta verileri 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

Video Biçimi

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

Sıralamalar
VIDEO_FORMAT_UNSPECIFIED Video biçimi belirtilmedi.
HLS uygulama/x-mpegURL
DASH uygulama/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 zaten koşullandırılıp koşullandırılmadığını belirtmek üzere reklam araları sırasında segmentlerinizin zaten bölündüğünü gösterir.
url

string

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

Video Önceden Koşullandırıldı

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

Sıralamalar
NO Henüz koşullandırılmamış.
YES Video koşullandırıldı/paylaşıldı.