REST Resource: advertisers.adGroupAds

Kaynak: AdGroupAd

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 bayt boyutunda ve UTF-8 kodlu 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 yalnızca aşağıdakilerden biri olabilir:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Display & Video 360 reklam öğesinden alınan 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 erişim pazarlama hedefleri için kullanılan 5 saniye sonra atlanabilen yayın içi reklamın ayrıntıları.
nonSkippableAd

object (NonSkippableAd)

Erişim pazarlama hedefleri için kullanılan, 6 ila 15 saniye uzunluğunda atlanamayan kısa yayın içi video reklam ayrıntıları.
bumperAd

object (BumperAd)

Erişim için kullanılan, 6 saniyeye eşit veya daha kısa süreli 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 alanlarında gösterilen video tanıtımı yapan reklam ile ilgili ayrıntılar.
videoPerformanceAd

object (VideoPerformanceAd)

İşletmeye, hizmete 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

Reklam, bir DV360 reklam öğesinden alınmıştır.

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

string (int64 format)

Kaynak reklam öğesinin kimliği.

MastheadAd

Masthead reklam 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 olarak oynatılacağı süre.

En fazla dokuz kesirli basamak içeren 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ö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 tane olabilir.

YoutubeVideoDetails

YouTube videosunun ayrıntıları.

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

string

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

enum (VideoUnavailableReason)

Video verilerinin kullanılamamasının nedeni.

VideoUnavailableReason

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

Sıralamalar
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Bilinmiyor veya belirtilmemiş.
VIDEO_UNAVAILABLE_REASON_PRIVATE Video gizli olabilir.
VIDEO_UNAVAILABLE_REASON_DELETED Video silinmişse

VideoAspectRatio

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

Sıralamalar
VIDEO_ASPECT_RATIO_UNSPECIFIED Belirtilmemiş veya bilinmiyor.
VIDEO_ASPECT_RATIO_WIDESCREEN Video uzatılmış ve üst ile alt kısımları kırpılmış.
VIDEO_ASPECT_RATIO_FIXED_16_9 Video, sabit 16:9 en boy oranını kullanıyor.

InStreamAd

Yayın içi reklam 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 aktarmak için kullanılan ö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

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

string

Kullanıcıların reklamı tıkladıktan sonra ulaştığı 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

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 boyutundaki meta verileri.
fileSize

string (int64 format)

Resim öğesinin bayt cinsinden dosya boyutu.

NonSkippableAd

Atlanamayan bir reklama ilişkin 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 aktarmak için kullanılan ö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

Sesli reklam 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ı adresi.
finalUrl

string

Kullanıcıların reklamı tıkladıktan sonra ulaştığı 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

Video discovery reklamıyla ilgili 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ıtımını yaptığı 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 belirtilmemiş.
THUMBNAIL_DEFAULT Varsayılan küçük resim, otomatik olarak oluşturulabilir veya kullanıcı tarafından yüklenebilir.
THUMBNAIL_1 Videodan oluşturulan 1. küçük resim.
THUMBNAIL_2 Videodan oluşturulan 2. küçük resim.
THUMBNAIL_3 Videodan oluşturulan 3. küçük resim.

VideoPerformanceAd

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 ulaştığı 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 tek başına başlıkların 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 kısım.
displayUrlBreadcrumb2

string

Görünen URL'deki alan adından sonra gelen ikinci kısım.
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 aktarmak için kullanılan ö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 eşlik eden banner'ların listesi.

AdUrl

Beacon'lar 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 dize değeri.

AdUrlType

Olası reklam URL'si türleri.

Sıralamalar
AD_URL_TYPE_UNSPECIFIED Bilinmiyor veya belirtilmemiş.
AD_URL_TYPE_BEACON_IMPRESSION Bir reklam öğesinin gösterimi yayınlandığında ping göndermek için kullanılan 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çiye genişletilir.
AD_URL_TYPE_BEACON_CLICK Tıklama etkinliği tetiklendiğinde ping göndermek için kullanılan izleme URL'si.
AD_URL_TYPE_BEACON_SKIP Atlama etkinliği tetiklendiğinde ping gönderilecek izleme URL'si.

Yöntemler

get

 Bir reklam grubu reklamı alır.

list

 Reklam grubu reklamlarını listeler.