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,
  "adPolicy": {
    object (AdPolicy)
  },
  "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.

olmamasıyla tanımlanabilir.
displayName

string

Reklamın görünen adı.

Maksimum 255 bayt boyutunda ve UTF-8 kodlu olmalıdır.
adPolicy

object (AdPolicy)

Reklamın politika onay durumu.
entityStatus

enum (EntityStatus)

Reklamın öğe durumu.
adUrls[]

object (AdUrl)

Reklam tarafından kullanılan URL'lerin listesi.

ad_details birleşik alanı. Reklamın ayrıntıları.

ad_details aşağıdakilerden yalnızca 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ı.

AdPolicy

Bir reklam grubu reklamıyla ilişkilendirilmiş tek bir reklam politikası.

JSON gösterimi 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Alanlar
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

Bir reklamın politika onay durumu, onay kararını gösterir.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

Bir reklamın politika inceleme durumu. Reklamın şu anda inceleme sürecinin hangi aşamasında olduğunu gösterir.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Reklamla ilgili olduğu belirlenen her politika konusunun girişleri. Her girişte konu, kısıtlama düzeyi ve politika sorunlarının nasıl düzeltileceğine dair bilgiler yer alır.

AdPolicyApprovalStatus

Reklam politikası onayının olası durumları.

Sıralamalar
AD_POLICY_APPROVAL_STATUS_UNKNOWN Bilinmiyor veya belirtilmemiş.
DISAPPROVED Yayınlanmaz.
APPROVED_LIMITED Kısıtlamalarla yayınlanır.
APPROVED Kısıtlama olmadan yayınlanır.
AREA_OF_INTEREST_ONLY Hedeflenen ülkelerde yayınlanmaz ancak hedeflenen ülkeler hakkında bilgi arayan kullanıcılara gösterilebilir.

AdPolicyReviewStatus

Reklam politikası incelemesinin olası durumları.

Sıralamalar
AD_POLICY_REVIEW_STATUS_UNKNOWN Bilinmiyor veya belirtilmemiş.
REVIEW_IN_PROGRESS Şu anda inceleniyor.
REVIEWED Birincil inceleme tamamlandı. Diğer incelemeler devam ediyor olabilir.
UNDER_APPEAL Onay için yeniden gönderilmiş veya politika kararına itiraz edilmişse
ELIGIBLE_MAY_SERVE Uygun kabul edilir ve yayınlanıyor olabilir. Daha kapsamlı bir inceleme de yapılabilir.

AdPolicyTopicEntry

Bir reklamın nasıl reklam politikasıyla ilgili olarak tanımlandığını açıklayan giriş.

JSON gösterimi 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Alanlar
policyTopic

string

Politika konusu.

Örneğin, "TİCARİ MARKALAR", "ALKOL" vb.
policyLabel

string

Politika için yerelleştirilmiş etiket metni.

Örnekler arasında "Metinlerdeki ticari markalar", "Alkol içerir" vb. yer alır.
policyTopicDescription

string

Politika konusunun kısa bir özet açıklaması.
policyTopicType

enum (AdPolicyTopicEntryType)

Reklam politikasının konusuyla ilişkisi nedeniyle reklam sunumunun nasıl etkileneceği.
policyDecisionType

enum (AdPolicyDecisionType)

Politika kararının kaynağı.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Politika incelemesinde kullanılan politika yaptırımı yöntemi.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Politika kararında kullanılan kanıtlar.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Politika kararıyla ilgili yayın kısıtlamaları.
appealInfo

object (AdPolicyTopicAppealInfo)

Politika kararına nasıl itiraz edeceğinizle ilgili bilgiler

AdPolicyTopicEntryType

Bir reklam politikası konusunun sunum üzerindeki olası etkileri.

Sıralamalar
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Bilinmiyor veya belirtilmemiş.
PROHIBITED Kaynak yayınlanmaz.
FULLY_LIMITED Kaynak, hedeflenen tüm ülkelerde yayınlanmayacak.
LIMITED Kaynak bazı ülkelerde yayınlanamaz.
DESCRIPTIVE Kaynak yayınlanabilir.
BROADENING Kaynak yayınlanabilir ve normal kapsamın ötesinde yayınlanabilir.
AREA_OF_INTEREST_ONLY Kaynak, hedeflenen tüm ülkeler için kısıtlanmıştır ancak hedeflenen ülkeler hakkında bilgi arayan kullanıcılara sunulabilir.

AdPolicyDecisionType

Politika kararının olası kaynakları.

Sıralamalar
AD_POLICY_DECISION_TYPE_UNKNOWN Bilinmiyor veya belirtilmemiş.
PURSUANT_TO_NOTICE Karar, yasal bildirim, mahkeme kararı veya ticari marka içerik sahibi şikayeti gibi bir nedenden kaynaklanıyor.
GOOGLE_INVESTIGATION Karar, Google'ın yaptığı bir incelemeye dayanmaktadır.

AdPolicyEnforcementMeans

Politika incelemesinde kullanılan olası politika yaptırımı yöntemleri.

Sıralamalar
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Bilinmiyor veya belirtilmemiş.
AUTOMATED Yaptırım süreci tamamen otomatikleştirilmiştir.
HUMAN_REVIEW Kararın uygulanması sürecine kısmen veya tamamen bir kullanıcı dahil oldu.

AdPolicyTopicEvidence

Politika kararında kullanılan kanıt bilgileri.

JSON gösterimi 
{

  // Union field value can be only one of the following:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of list of possible types for union field value.
}
Alanlar
value birleşik alanı. Politika kararıyla ilgili kanıtlar. value aşağıdakilerden yalnızca biri olabilir:
textList

object (TextList)

Reklam metninde bulunan kanıtların listesi.
websiteList

object (WebsiteList)

Reklamla bağlantılı web sitelerinin listesi.
httpCode

integer

Nihai URL tarandığında döndürülen HTTP kodu.
languageCode

string

Reklamın yazıldığı dil.

Bu alanda "en-US" gibi IETF dil etiketleri kullanılır.
destinationTextList

object (DestinationTextList)

Reklamın hedefindeki, politika ihlaline neden olan metin.
destinationMismatch

object (DestinationMismatch)

Reklam hedef URL'leri arasında uyuşmazlık olması
destinationNotWorking

object (DestinationNotWorking)

Reklam hedefiyle ilgili HTTP veya DNS hataları hakkında bilgi.
trademark

object (Trademark)

Politika ihlaline neden olan ticari marka terimleri.
legalRemoval

object (LegalRemoval)

Politika ihlaline neden olan, yasalarla ilgili düzenlemelerin uygulanması.
counterfeit

object (Counterfeit)

Politika ihlaline neden olan sahte ürün yaptırımı.
regionalRequirements

object (RegionalRequirements)

Politika ihlaline neden olan T&S proaktif yaptırımı.

TextList

Politikayı ihlal eden metin parçalarının listesi.

JSON gösterimi 
{
  "texts": [
    string
  ]
}
Alanlar
texts[]

string

Politika bulgusuna neden olan kaynaktaki metin parçaları.

WebsiteList

Politikayı ihlal eden web sitelerinin listesi.

JSON gösterimi 
{
  "websites": [
    string
  ]
}
Alanlar
websites[]

string

Politika bulgusuna neden olan web siteleri.

DestinationTextList

Politikayı ihlal eden hedef metinlerin listesi.

JSON gösterimi 
{
  "destinationTexts": [
    string
  ]
}
Alanlar
destinationTexts[]

string

Politika bulgusuna neden olan hedef metin.

DestinationMismatch

Hedef URL türleri arasındaki uyuşmazlıkla ilgili ayrıntılar.

JSON gösterimi 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Alanlar
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

Eşleşmeyen URL'ler grubu. Liste, tek veya birden fazla URI türü içerebilir.

1. örnek: [DISPLAY_URL, FINAL_URL] ifadesi, reklam görünen URL'sinin reklam nihai URL'siyle eşleşmediği anlamına gelir.

2. örnek: [FINAL_URL], reklam nihai URL'sinin taranan URL ile eşleşmediği anlamına gelir. Bu durum da hedef site veya uygulama uyuşmazlığı olarak kabul edilir.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Olası URL türleri.

Sıralamalar
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN Belirtilmemiş veya bilinmiyor.
DISPLAY_URL Görünen URL.
FINAL_URL Nihai URL.
FINAL_MOBILE_URL Mobil nihai URL.
TRACKING_URL İzleme URL'si.
MOBILE_TRACKING_URL Mobil izleme URL'si.

DestinationNotWorking

Reklam hedefiyle ilgili HTTP veya DNS hatalarının ayrıntıları.

JSON gösterimi 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
Alanlar
expandedUri

string

Çalışmayan tam URL.
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

URL'nin ziyaret edilmesi hataya neden olan cihaz.
lastCheckedTime

string (Timestamp format)

URL'ye gidilirken hatanın en son görüldüğü zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
reason birleşik alanı. HTTP veya DNS hatası. reason aşağıdakilerden yalnızca biri olabilir:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

DNS hatasının türü.
httpErrorCode

string (int64 format)

HTTP hata kodu.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Olası DNS hata türleri.

Sıralamalar
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Belirtilmemiş veya bilinmiyor.
HOSTNAME_NOT_FOUND Açılış sayfası getirilirken DNS'de ana makine adı bulunamadı.
GOOGLE_CRAWLER_DNS_ISSUE Google, DNS ile iletişim kurarken açılış sayfasını tarayamadı.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

URL'yi ziyaret ederken hata gören olası cihazlar.

Sıralamalar
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Belirtilmemiş veya bilinmiyor.
DESKTOP Masaüstü cihaz.
ANDROID Android cihaz
IOS iOS cihaz

Ticari Marka

Politika ihlaline neden olan ticari marka terimleri.

JSON gösterimi 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Alanlar
owner

string

Ticari marka içerik sahibi.
term

string

Ticari marka terimi.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Politika ihlalinin geçerli olduğu ülkeler.

AdPolicyCriterionRestriction

Ülke kısıtlamasını gösterir.

JSON gösterimi 
{
  "countryCriterionId": string,
  "countryLabel": string
}
Alanlar
countryCriterionId

string (int64 format)

Ülke ölçütü kimliği.
countryLabel

string

Ülkenin yerelleştirilmiş adı. Boş olabilir.

LegalRemoval

DMCA veya yerel yasal düzenlemelerden kaynaklanan yasal düzenlemelerin uygulanması

JSON gösterimi 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
Alanlar
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Yasal kaldırmaya neden olan şikayetin türü.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Yasal kaldırma nedeniyle kısıtlanan ülkeler.
restrictedUris[]

string

Yasal kaldırma nedeniyle kısıtlanan URL'ler.
type birleşik alanı. Yasal kaldırma türüyle ilgili ayrıntılar. type aşağıdakilerden yalnızca biri olabilir:
dmca

object (Dmca)

DMCA düzenlemesiyle ilgili yasal kaldırma hakkında ayrıntılar.

DMCA

DMCA şikayetinin ayrıntıları.

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

string

Yasal şikayette bulunan taraf.

LocalLegal

Yerel yasal düzenleme ayrıntıları.

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

string

Yasal uyarı için geçerli olan yasa türü.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Yasal kaldırma için olası şikayet türleri.

Sıralamalar
COPYRIGHT

Telif Hakkı.

Yalnızca DMCA için geçerlidir.
COURT_ORDER

Mahkeme kararı

Yalnızca yerel yasalara göre geçerlidir.

Taklit

Politika ihlaline neden olan sahte ürünlerle ilgili yaptırım hakkında ayrıntılar.

JSON gösterimi 
{
  "owners": [
    string
  ]
}
Alanlar
owners[]

string

Şikayette bulunan içerik veya ürün sahipleri

RegionalRequirements

Bölgesel gereksinimleri karşılamaya yönelik politikalar için Güven ve Güvenlik (T&S) proaktif yaptırım Bu, proaktif T&S yaptırımı olduğundan bir düzenleme bildirimi yerine Google'a ait bir inceleme olarak kabul edilir.

JSON gösterimi 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
Alanlar
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

Bölgesel şartların listesi.

RegionalRequirementsEntry

Politika düzeyinde bölgesel yasal ihlal ayrıntıları.

JSON gösterimi 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Alanlar
legalPolicy

string

İhlal edilen yasal politika.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Yasal politika nedeniyle kısıtlanan ülkeler.

AdPolicyTopicConstraint

Reklam sunma kısıtlamalarıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "requestCertificateFormLink": string,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
Alanlar
constraint birleşik alanı. Yayın kısıtlaması. constraint aşağıdakilerden yalnızca biri olabilir:
countryConstraint

object (AdPolicyCountryConstraintList)

Reklamın yayınlanamayacağı ülkeler.
resellerConstraint

object (AdPolicyResellerConstraint)

Bayi kısıtlaması.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Yayın için sertifika gereken ülkeler.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Kaynağın alanının, kendisiyle ilişkili sertifikalar kapsamında olmadığı ülkeler.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

Herhangi bir ülkede yayınlanmak için sertifika gerekir.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Herhangi bir ülkede yayın yapmak için sertifika gereklidir ve mevcut sertifika, reklamın alanını kapsamamaktadır.

AdPolicyCountryConstraintList

Reklamın politika kısıtlamaları nedeniyle yayınlanamayacağı ülkelerin listesi.

JSON gösterimi 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Alanlar
countries[]

object (AdPolicyCriterionRestriction)

Reklamın yayınlanamayacağı ülkeler.

AdPolicyResellerConstraint

Bu türde alan yok.

Bayi amaçlı web sitesi onaylanmadığı için politika konusu sınırlandırıldı.

AdPolicyGlobalCertificateMissingConstraint

Bu türde alan yok.

Herhangi bir ülkede yayınlanmak için sertifika gerekir.

AdPolicyGlobalCertificateDomainMismatchConstraint

Bu türde alan yok.

Herhangi bir ülkede yayın yapmak için sertifika gereklidir ve mevcut sertifika, reklamın alanını kapsamamaktadır.

AdPolicyTopicAppealInfo

Politika kararlarına nasıl itiraz edileceği hakkında bilgi.

JSON gösterimi 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
Alanlar
appealType

enum (AdPolicyAppealType)

Karara self servis itiraz veya itiraz formu aracılığıyla itiraz edilip edilemeyeceği.

AdPolicyAppealType

Olası itiraz türleri.

Sıralamalar
AD_POLICY_APPEAL_TYPE_UNKNOWN Bilinmiyor veya belirtilmemiş.
SELF_SERVICE_APPEAL Karara self servis itiraz yoluyla itiraz edilebilir.
APPEAL_FORM Karara itiraz etmek için itiraz formu kullanılabilir.

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.