REST Resource: advertisers.adGroupAds

Kaynak: Reklam GrubuReklam

Bir 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 baytlık bir boyutla kodlanmış UTF-8 olmalıdır.
entityStatus

enum (EntityStatus)

Reklamın öğe durumu.
adUrls[]

object (AdUrl)

Reklamın kullandığı URL'lerin listesi.
ad_details alanı. 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ın ayrıntıları.
nonSkippableAd

object (NonSkippableAd)

Pazarlama hedeflerine ulaşmak için kullanılan, 6 ila 15 saniye uzunluğundaki 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

Reklamın kaynağı DV360 reklam öğesidir.

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

string (int64 format)

Kaynak reklam öğesinin kimliği.

MastheadAd

Masthead Reklamla ilgili 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ın kullandığı 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 olarak oynatılacağı süre.

En fazla dokuz kesir basamağı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".
callToActionButtonLabel

string

Harekete geçirici mesaj düğmesi üzerindeki 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. 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 Bilinmeyen veya belirtilmedi.
VIDEO_UNAVAILABLE_REASON_PRIVATE Video gizlidir.
VIDEO_UNAVAILABLE_REASON_DELETED Video silinir.

VideoAspectRatio

Bir YouTube videosu için olası en boy oranları.

Sıralamalar
VIDEO_ASPECT_RATIO_UNSPECIFIED Belirtilmedi veya bilinmiyor.
VIDEO_ASPECT_RATIO_WIDESCREEN Videonun uzatılmış şekilde görünmesi ve üst ve alt kısmı kırpılmış.
VIDEO_ASPECT_RATIO_FIXED_16_9 Video 16:9 sabit bir 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)

Özel değerlerin izleme URL'si şablonuna iletileceği ö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ı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üğmesi üzerindeki 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 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)

Özel değerlerin izleme URL'si şablonuna iletileceği ö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)

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ı 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 Bilinmeyen 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ı 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ık 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'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 iletileceği ö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 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 Bilinmeyen veya belirtilmedi.
AD_URL_TYPE_BEACON_IMPRESSION Reklam öğesi gösterimi yayınlandığında pinglenecek 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 pinglenecek izleme URL'si.
AD_URL_TYPE_BEACON_SKIP Atlama etkinliği tetiklendiğinde pinglenecek izleme URL'si.

Yöntemler

get

 Bir reklam grubu reklamı alır.

list

 Reklam grubu reklamlarını listeler.