Package google.ads.dai.v1

Dizin

PartnerDiscoveryService

DAI beslemesini ve reklam öğelerinin YouTube'a yüklenmesini yönetir.

CreateCreative

rpc CreateCreative(CreateCreativeRequest) returns (Operation)

Reklam öğesi oluşturur. Başarılı bir şekilde tamamlandığında response alanında bir reklam öğesi, başarısız olduğunda ise google.rpc.Code döndürür. metadata alanındaki beslemenin durumunu içeren CreateCreativeOperationMetadata döndürür.
DeleteCreative

rpc DeleteCreative(DeleteCreativeRequest) returns (Empty)

Reklam öğesini siler.
GetCreative

rpc GetCreative(GetCreativeRequest) returns (Creative)

Reklam öğesi alır.

CreateCreativeOperationMetadata

CreateCreative tarafından döndürülen uzun süreli işlem meta verileri. metadata olarak sunum yapın.

Alanlar
creative_url

string

Besleme için kullanılan reklam öğesinin URL'si. Bu, istekte sağlanan özelliklere göre seçilen mezzanine URL'si veya medya oluşturma URL'sidir.
gv_registry_id

string

Besleme başarılıysa video reklam öğesi için benzersiz bir tanımlayıcı. Reklam öğesi kaynağının adı creatives/gv_registry_id.
create_time

Timestamp

Besleme isteğinin oluşturulduğu zaman.
youtube_status

IngestionStatus

Mevcut YouTube besleme durumu.

CreateCreativeRequest

PartnerDiscoveryService.CreateCreative için istek.

Alanlar
creative

Creative

Beslenecek reklam öğesi.
dynamic_creative_info

DynamicCreativeInfo

Dinamik reklam öğesi hakkında bilgi. Beslenecek reklam öğesi dinamikse gereklidir.

Reklam öğesi

Reklam öğesi kaynağı. PartnerDiscoveryService.CreateCreative tamamlandıktan sonra response olarak sunun.

Alanlar
name

string

Yalnızca çıkış. Reklam öğesi kaynağının benzersiz adı (Google video kimliği), creatives/id biçiminde.
advertiser

string

Bu reklam öğesinde yer alan reklamverenin adı.
ad_system

string

Zorunlu. Besleme isteğini oluşturan reklam sisteminin adı.
ad_title

string

Reklamın başlığı.
ad_description

string

Reklamın açıklaması.
mezzanines[]

MediaFile

Reklamın ara katman dosya URL'leri ve özellikleri. mezannines veya media_files özelliklerinden en az biri gereklidir.
media_files[]

MediaFile

Reklamın medya dosyası URL'leri ve bunların özellikleri. mezannines veya media_files özelliklerinden en az biri gereklidir.
network_code

string

İsteğe bağlı. Reklam öğesinin hedeflendiği yayıncının Google Ad Manager ağ kodu. Reklam öğesi dinamikse ve CreateCreativeRequest'te DynamicCreativeInfo doldurulmuşsa gereklidir.

DeleteCreativeRequest

PartnerDiscoveryService.DeleteCreative için istek.

Alanlar
name

string

Sililecek reklam öğesi Google video kimliği.

DynamicCreativeInfo

Dinamik reklam öğesinin VCL işleme gerçekleştirmesi için gerekli bilgiler.

Alanlar
dynamic_group_id

string

Reklam öğesinin temel video reklamını temsil eden bir kimlik. Aynı dinamik grup kimliği altındaki tüm dinamik reklam öğelerinin aynı içeriğe sahip olduğu ancak reklam öğesinin farklı dinamik yönleri olduğu kabul edilebilir.
active_duration

Duration

Bu reklam öğesinin etkin ve kullanımda olduğu süre. Bu sürenin ardından reklam öğesi, video reklam öğesi deposunda silinmek üzere planlanır. Süre 180 günle sınırlıdır. Bu alan belirtilmezse varsayılan süre 30 gündür.

FailureReason

Reklam öğesi besleme hatasının nedeni.

Alanlar
reason

Reason

Reklam öğesi besleme hatasının açıklaması.
code

int32

Neden DOWNLOAD_ERROR ise başarısızlığın HTTP durum kodu.

Neden

Reklam öğesi beslemesinin başarısız olmasının olası nedenleri.

Sıralamalar
REASON_UNSPECIFIED Varsayılan değer.
DOWNLOAD_ERROR HTTP indirme işlemi başarısız oldu.
INTERNAL_ERROR Dahili hata.
INVALID_MEDIA Geçersiz medya.

GetCreativeRequest

PartnerDiscoveryService.GetCreative için istek.

Alanlar
name

string

Reklam öğesinin Google video kimliği.

IngestionStatus

Reklam öğesi oluşturma isteğinin besleme durumu.

Alanlar
state

State

Bir video reklam öğesinin mevcut besleme durumu.
failure_reason

FailureReason

Besleme başarısız olursa reklam öğesinin beslenememesinin nedeni.
update_time

Timestamp

Besleme işinin son güncellenme zamanı.

Eyalet

Besleme durumu.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer.
PROCESSING Video reklam öğesi hâlâ işleniyor.
SUCCESS Video reklam öğesi başarıyla işlendi.
FAILURE Video reklam öğesi beslenemedi. FailureReason'e bakın.

MediaFile

Belirli bir medya dosyasıyla ilgili özellikler.

Alanlar
uri

string

Zorunlu. Reklam öğesinin medya dosyasının benzersiz URL'si.
delivery

Delivery

Zorunlu. Reklam öğesinin yayın türü.
height

int32

Video dosyasının doğal yüksekliği (piksel cinsinden).
width

int32

Video dosyasının doğal genişliği (piksel cinsinden).
mime_type

string

Zorunlu. Dosya kapsayıcının MIME türü. Popüler MIME türleri arasında Flash Video için "video/x-flv" ve MP4 için "video/mp4" yer alır.
min_bitrate

int32

Medya dosyasının minimum bit hızı. Artımlı yükleme videoları için bu değer ortalama bit hızı olmalıdır.
max_bitrate

int32

Medya dosyasının maksimum bit hızı. Artımlı yükleme videoları için bu değer ortalama bit hızı olmalıdır.

Adrese teslim

Yayınlama türleri.

Sıralamalar
DELIVERY_UNSPECIFIED Varsayılan yayınlama değeri.
DELIVERY_PROGRESSIVE Progresif video yayını.
DELIVERY_STREAMING Akışlı video yayınlama