REST Resource: advertisers.youtubeAdGroupAds

Kaynak: YouTubeReklamGrubuReklamı

Bir YouTube reklam grubu ile ilişkilendirilmiş tek bir reklam.

JSON gösterimi 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
Alanlar
name

string

Reklamın kaynak adı.
advertiserId

string (int64 format)

Reklamın ait olduğu reklamverenin benzersiz kimliği.
adGroupAdId

string (int64 format)

Reklamın benzersiz kimliği. Sistem tarafından atanır.
adGroupId

string (int64 format)

Reklamın ait olduğu reklam grubunun benzersiz kimliği.
displayName

string

Reklamın görünen adı.

Maksimum 255 bayt boyutta UTF-8 olarak kodlanmış olmalıdır.
entityStatus

enum (EntityStatus)

Reklamın varlık durumu.
adUrls[]

object (AdUrl)

Reklamın kullandığı URL'lerin listesi.
Birleştirme alanı ad_details. Reklamın ayrıntıları. ad_details şunlardan yalnızca biri olabilir:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Görüntülü Reklam Ağı ve Video 360 reklam öğesi.
mastheadAd

object (MastheadAd)

YouTube Ana Sayfa özet akışında yayınlanan bir reklamla ilgili ayrıntılar.
inStreamAd

object (InStreamAd)

Marka bilinirliği veya erişim pazarlama hedefleri için kullanılan, 5 saniye sonra atlanabilir yayın içi reklamın ayrıntıları.
nonSkippableAd

object (NonSkippableAd)

Erişim pazarlama hedefleri için kullanılan, 6 ile 15 saniye arasında atlanamayan kısa video içi reklamın ayrıntıları.
bumperAd

object (BumperAd)

Erişim için kullanılan, 6 saniyeye eşit veya daha kısa olan atlanamayan kısa video reklamın ayrıntıları.
audioAd

object (AudioAd)

Erişim pazarlama hedefleri için kullanılan işitsel reklamın ayrıntıları.
videoDiscoverAd

object (VideoDiscoveryAd)

Keşif yerlerinde gösterilen videoyu tanıtan reklamla ilgili ayrıntılar.
videoPerformanceAd

object (VideoPerformanceAd)

İşletme, hizmet veya ürüne yönelik işlemleri artırmak için işleme yönelik video kampanyasında kullanılan bir reklamın ayrıntıları.

DisplayVideoSourceAd

DV360 reklam öğesinden alınan reklam.

JSON gösterimi 
{
  "creativeId": string
}
Alanlar
creativeId

string (int64 format)

Kaynak reklam öğesinin kimliği.

MastheadAd

Masthead reklamın ayrıntıları.

JSON gösterimi 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
Alanlar
video

object (YoutubeVideoDetails)

Reklam tarafından kullanılan YouTube videosu.
headline

string

Reklamın başlığı.
description

string

Reklamın açıklaması.
videoAspectRatio

enum (VideoAspectRatio)

Masthead'de otomatik oynatılan YouTube videosunun en boy oranı.
autoplayVideoStartMillisecond

string (int64 format)

Videonun oynatılmaya başlayacağı süre (milisaniye cinsinden).
autoplayVideoDuration

string (Duration format)

Videonun otomatik oynatılacağı süre.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
callToActionButtonLabel

string

Harekete geçirici mesaj düğmesindeki metin.
callToActionFinalUrl

string

Harekete geçirici mesaj düğmesinin hedef URL'si.
callToActionTrackingUrl

string

Harekete geçirici mesaj düğmesinin izleme URL'si.
showChannelArt

boolean

YouTube sayfasının üst kısmında görünen bir arka plan veya banner'ın gösterilip gösterilmeyeceğini belirler.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

Masaüstünde Masthead Reklamın yanında görünen videolar. En fazla iki olabilir.

YoutubeVideoDetails

Bir YouTube videosunun ayrıntıları.

JSON gösterimi 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
Alanlar
id

string

YouTube web sayfasında aranabilecek YouTube video kimliği.
unavailableReason

enum (VideoUnavailableReason)

Video verilerinin mevcut olmamasının nedeni.

VideoUnavailableReason

Bir videonun kullanılamamasının olası nedenleri.

Sıralamalar
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Bilinmiyor veya belirtilmedi.
VIDEO_UNAVAILABLE_REASON_PRIVATE Video gizli.
VIDEO_UNAVAILABLE_REASON_DELETED Video silinir.

VideoAspectRatio

YouTube videoları için olası en boy oranları.

Sıralamalar
VIDEO_ASPECT_RATIO_UNSPECIFIED Belirtilmedi veya bilinmiyor.
VIDEO_ASPECT_RATIO_WIDESCREEN Video uzatılır, üst ve alt kısmı kırpılır.
VIDEO_ASPECT_RATIO_FIXED_16_9 Videonun en boy oranı sabit 16:9 olmalıdır.

InStreamAd

Bir yayın içi reklamla ilgili ayrıntılar.

JSON gösterimi 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Alanlar
commonInStreamAttribute

object (CommonInStreamAttribute)

Yaygın reklam özellikleri.
customParameters

map (key: string, value: string)

Özel değerlerin izleme URL'si şablonuna iletilecek özel parametreler.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CommonInStreamAttribute

Yayın içi, atlanamayan ve bumper reklamlar için ortak özellikler.

JSON gösterimi 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Alanlar
displayUrl

string

Reklamda görünen web sayfası adresidir.
finalUrl

string

Kullanıcıların reklamı tıkladıktan sonra eriştikleri web sayfasının URL adresi.
trackingUrl

string

İzleme amacıyla arka planda yüklenen URL adresi.
actionButtonLabel

string

Harekete geçirici mesaj düğmesindeki metin.
actionHeadline

string

Harekete geçirici mesaj banner'ının başlığı.
video

object (YoutubeVideoDetails)

Reklamın YouTube videosu.
companionBanner

object (ImageAsset)

Video reklamın yanında gösterilen resim.

ImageAsset

Bir resim öğesinin meta verileri.

JSON gösterimi 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
Alanlar
mimeType

string

Resim öğesinin MIME türü.
fullSize

object (Dimensions)

Bu resmin orijinal boyutunda meta verileri.
fileSize

string (int64 format)

Resim öğesinin bayt cinsinden dosya boyutu.

NonSkippableAd

Atlanamayan bir reklamın ayrıntıları.

JSON gösterimi 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Alanlar
commonInStreamAttribute

object (CommonInStreamAttribute)

Yaygın reklam özellikleri.
customParameters

map (key: string, value: string)

Özel değerlerin izleme URL'si şablonuna iletilecek özel parametreler.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

BumperAd

Bumper reklamla ilgili ayrıntılar.

JSON gösterimi 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Alanlar
commonInStreamAttribute

object (CommonInStreamAttribute)

Yaygın reklam özellikleri.

AudioAd

Bir işitsel reklamla ilgili ayrıntılar.

JSON gösterimi 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Alanlar
displayUrl

string

Reklamda görünen web sayfası adresidir.
finalUrl

string

Kullanıcıların reklamı tıkladıktan sonra eriştikleri web sayfasının URL adresi.
trackingUrl

string

İzleme amacıyla arka planda yüklenen URL adresi.
video

object (YoutubeVideoDetails)

Reklamın YouTube videosu.

VideoDiscoveryAd

Bir Video Discovery reklamının ayrıntıları.

JSON gösterimi 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
Alanlar
headline

string

Reklamın başlığı.
description1

string

Reklamın ilk metin satırı.
description2

string

Reklamın ikinci metin satırı.
video

object (YoutubeVideoDetails)

Reklamın tanıttığı YouTube videosu.
thumbnail

enum (Thumbnail)

Reklamda kullanılan küçük resim.

Küçük resim

Video Discovery Reklamlarındaki olası küçük resim seçenekleri.

Sıralamalar
THUMBNAIL_UNSPECIFIED Bilinmiyor veya belirtilmedi.
THUMBNAIL_DEFAULT Varsayılan küçük resim, otomatik olarak oluşturulabilir veya kullanıcı tarafından yüklenebilir.
THUMBNAIL_1 Videodan oluşturulan küçük resim 1.
THUMBNAIL_2 Videodan oluşturulan küçük resim 2.
THUMBNAIL_3 Videodan oluşturulan küçük resim 3.

VideoPerformanceAd

Bir video performans reklamıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
Alanlar
finalUrl

string

Kullanıcıların reklamı tıkladıktan sonra eriştikleri web sayfasının URL adresi.
trackingUrl

string

İzleme amacıyla arka planda yüklenen URL adresi.
actionButtonLabels[]

string

Harekete geçirici mesaj düğmesinde gösterilen metin öğelerinin listesi.
headlines[]

string

Harekete geçirici mesaj banner'ında gösterilen başlıkların listesi.
longHeadlines[]

string

Harekete geçirici mesaj banner'ında gösterilen yalın başlıkların listesi.
descriptions[]

string

Harekete geçirici mesaj banner'ında gösterilen açıklama listesi.
displayUrlBreadcrumb1

string

Görünen URL'de alan adından sonraki ilk parça.
displayUrlBreadcrumb2

string

Görünen URL'de alan adından sonraki ikinci parça.
domain

string

Görünen URL'nin alanı.
videos[]

object (YoutubeVideoDetails)

Bu reklam tarafından kullanılan YouTube video öğelerinin listesi.
customParameters

map (key: string, value: string)

Özel değerlerin izleme URL'si şablonuna iletilecek özel parametreler.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanners[]

object (ImageAsset)

Bu reklam tarafından kullanılan tamamlayıcı banner'ların listesi.

AdUrl

İşaretçiler de dahil olmak üzere reklamla ilgili ek URL'ler.

JSON gösterimi 
{
  "type": enum (AdUrlType),
  "url": string
}
Alanlar
type

enum (AdUrlType)

Reklam URL'sinin türü.
url

string

URL dizesi değeri.

AdUrlType

Olası reklam URL'si türleri.

Sıralamalar
AD_URL_TYPE_UNSPECIFIED Bilinmiyor veya belirtilmedi.
AD_URL_TYPE_BEACON_IMPRESSION Bir reklam öğesinin gösterimi yayınlandığında pinglenecek 1x1 izleme pikseli.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Genişletilebilir DCM gösterim işaretçisi. Yayın sırasında, birkaç işaretçi için genişletilir.
AD_URL_TYPE_BEACON_CLICK Tıklama etkinliği tetiklendiğinde pinglenecek izleme URL'si.
AD_URL_TYPE_BEACON_SKIP Atlama etkinliği tetiklendiğinde pinglenecek izleme URL'si.

Yöntemler

get

 Bir YouTube reklam grubu reklamı alır.

list

 YouTube reklam grubu reklamlarını listeler.