REST Resource: advertisers.youtubeAdGroupAds

Kaynak: YouTubeAdGroupAd

Bir YouTube reklam grubuyla 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 boyutunda UTF-8 olarak kodlanmış olmalıdır.
entityStatus

enum (EntityStatus)

Reklamın öğe durumu.
adUrls[]

object (AdUrl)

Reklam tarafından kullanılan URL'lerin listesi.
Birleştirme alanı ad_details. Reklamın ayrıntıları. ad_details şunlardan yalnızca biri olabilir:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Display & Video 360 reklam öğesinden elde edilen bir reklamın ayrıntıları.
mastheadAd

object (MastheadAd)

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

object (InStreamAd)

Marka bilinirliği veya pazarlama hedeflerine ulaşmak için kullanılan, 5 saniye sonra atlanabilir yayın içi reklam ile ilgili ayrıntılar.
nonSkippableAd

object (NonSkippableAd)

Erişim pazarlama hedefleri için kullanılan, 6 ila 15 saniye arasındaki atlanamayan kısa yayın içi video 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)

Pazarlama hedeflerine ulaşmak için kullanılan bir işitsel reklamın ayrıntıları.
videoDiscoverAd

object (VideoDiscoveryAd)

Keşif yerlerinde gösterilen video tanıtan bir reklamın ayrıntıları.
videoPerformanceAd

object (VideoPerformanceAd)

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

DisplayVideoSourceAd

DV360 reklam öğesinden elde edilen reklam.

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

string (int64 format)

Kaynak reklam öğesinin kimliği.

MastheadAd

Masthead Reklama ilişkin 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şlaması için geçmesi gereken süre (milisaniye cinsinden).
autoplayVideoDuration

string (Duration format)

Videonun otomatik oynatılacağı süre.

"s" ile biten ve en fazla dokuz kesir basamağı olan, saniye cinsinden bir 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österilen bir arka plan veya banner'ın gösterilip gösterilmeyeceği.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

Masaüstünde Masthead Reklamın yanında görünen videolar. İkiden fazla olamaz.

YoutubeVideoDetails

Bir YouTube videosunun ayrıntıları.

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

string

YouTube web sayfasında aranabilir 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 gizlidir.
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 ve üst ve alt kısmı kırpılır.
VIDEO_ASPECT_RATIO_FIXED_16_9 Video, sabit 16:9 en boy oranı kullanır.

InStreamAd

Yayın içi reklamın ayrıntıları.

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

object (CommonInStreamAttribute)

Sık kullanılan reklam özellikleri.
customParameters

map (key: string, value: string)

İzleme URL'si şablonuna özel değerler ileten özel parametreler.

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

CommonInStreamAttribute

Yayın içi, atlanamayan ve bumper reklamların yaygın özellikleri.

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

string

Reklamla birlikte görünen web sayfası adresidir.
finalUrl

string

Kullanıcıların reklamı tıkladıktan sonra ulaştıkları web sayfasının URL adresidir.
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 verileridir.

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 reklamla ilgili ayrıntılar.

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

object (CommonInStreamAttribute)

Sık kullanılan reklam özellikleri.
customParameters

map (key: string, value: string)

İzleme URL'si şablonuna özel değerler ileten özel parametreler.

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

BumperAd

Bumper reklamın ayrıntıları.

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

object (CommonInStreamAttribute)

Sık kullanılan reklam özellikleri.

AudioAd

İşitsel reklamın ayrıntıları.

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

string

Reklamla birlikte görünen web sayfası adresidir.
finalUrl

string

Kullanıcıların reklamı tıkladıktan sonra ulaştıkları web sayfasının URL adresidir.
trackingUrl

string

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

object (YoutubeVideoDetails)

Reklamın YouTube videosu.

VideoDiscoveryAd

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)

Reklamda tanıtılan YouTube videosu.
thumbnail

enum (Thumbnail)

Reklamda kullanılan küçük resim.

Küçük resim

Video Discovery Reklamlarda 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

Video performans reklamının 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 ulaştıkları web sayfasının URL adresidir.
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 tek başlık listesi.
descriptions[]

string

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

string

Görünen URL'deki 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)

İzleme URL'si şablonuna özel değerler ileten özel parametreler.

"key": value çiftlerin 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 dahil, 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 dize 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 pinglenen 1x1 izleme pikseli.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Genişletilebilir DCM gösterim işaretçisi. Sunum sırasında birkaç işaretçiye genişletilir.
AD_URL_TYPE_BEACON_CLICK Tıklama etkinliği tetiklendiğinde ping'lenecek izleme URL'si.
AD_URL_TYPE_BEACON_SKIP Atlama etkinliği tetiklendiğinde ping'lenecek izleme URL'si.

Yöntemler

get

 Bir YouTube reklam grubu reklamı alır.

list

 YouTube reklam grubu reklamlarını listeler.