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)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },

  // 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)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of list of possible types for union field ad_details.
}
Alanlar
name

string

Yalnızca çıkış. Reklamın kaynak adı.
advertiserId

string (int64 format)

Yalnızca çıkış. Reklamın ait olduğu reklamverenin benzersiz kimliği.
adGroupAdId

string (int64 format)

Yalnızca çıkış. Reklamın benzersiz kimliği. Sistem tarafından atanır.
adGroupId

string (int64 format)

Zorunlu. Değişmez. Reklamın ait olduğu reklam grubunun benzersiz kimliği.
displayName

string

Zorunlu. Reklamın görünen adı.

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

object (AdPolicy)

Yalnızca çıkış. Reklamın politika onay durumu.
entityStatus

enum (EntityStatus)

Zorunlu. Reklamın öğe durumu.
adUrls[]

object (AdUrl)

Yalnızca çıkış. Reklam tarafından kullanılan URL'lerin listesi.
dcmTrackingInfo

object (DcmTrackingInfo)

İsteğe bağlı. DCM izleme reklamı bilgileri. Yalnızca Talep Yaratma reklamları için geçerlidir.

DCM izleme reklamı bilgilerini kaldırmak için lütfen bu alanı boş bırakın.
ad_details birleşik alanı. Reklamın ayrıntıları. ad_details aşağıdakilerden yalnızca biri olabilir:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Yalnızca çıkış. Display & Video 360 reklam öğesinden alınan bir reklamın ayrıntıları.
mastheadAd

object (MastheadAd)

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

object (InStreamAd)

Yalnızca çıkış. 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)

Yalnızca çıkış. 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)

Yalnızca çıkış. 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)

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

object (VideoDiscoveryAd)

Yalnızca çıkış. Keşif alanlarında gösterilen video tanıtımı yapan reklam ile ilgili ayrıntılar.
videoPerformanceAd

object (VideoPerformanceAd)

Yalnızca çıkış. İş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ı.
demandGenVideoAd

object (DemandGenVideoAd)

Talep Yaratma video reklamının ayrıntıları.
demandGenImageAd

object (DemandGenImageAd)

Talep Yaratma resim reklamının ayrıntıları.
demandGenProductAd

object (DemandGenProductAd)

Talep Yaratma ürün reklamını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 ülkelerle ilgili 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 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.

Örneğin, "Metinlerde ticari markalar", "Alkol içerir" vb.
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 yayın ü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'a ait 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 bilgiler.
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ünlerle ilgili 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 tespitine 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. Listede tek veya birden fazla URI türü bulunabilir.

1. örnek: [DISPLAY_URL, FINAL_URL] 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 şikayetiyle ilgili ayrıntılar.

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

string

Yasal şikayette bulunan taraf.

LocalLegal

Yerel yasal düzenlemelerle ilgili 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 koşulları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 gerektiren ü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

Politika kısıtlamaları nedeniyle reklamın 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),
  "videoAssetId": string
}
Alanlar
id

string

Yalnızca çıkış. YouTube web sayfasında aranabilen YouTube video kimliği.
unavailableReason

enum (VideoUnavailableReason)

Video verilerinin kullanılamamasının nedeni.
videoAssetId

string (int64 format)

Zorunlu. YouTube video öğesi kimliği. Bu, bir AdAsset kaynağının adAssetId.

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'sine eklenecek özel parametreler ve bunlara eşlik eden değerler.

"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ıkları 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,
  "assetId": string
}
Alanlar
mimeType

string

Yalnızca çıkış. Resim öğesinin MIME türü.
fullSize

object (Dimensions)

Yalnızca çıkış. Bu resmin orijinal boyutundaki meta verileri.
fileSize

string (int64 format)

Yalnızca çıkış. Resim öğesinin bayt cinsinden dosya boyutu.
assetId

string (int64 format)

Zorunlu. Öğenin benzersiz kimliği.

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'sine eklenecek özel parametreler ve bunlara eşlik eden değerler.

"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 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ıkları 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ıkları 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 uzun 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 bölü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 adı.
videos[]

object (YoutubeVideoDetails)

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

map (key: string, value: string)

İzleme URL'sine eklenecek özel parametreler ve bunlara eşlik eden değerler.

"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.

DemandGenVideoAd

Talep Yaratma video reklamıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
Alanlar
finalUrl

string

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

string

Yalnızca çıkış. İzleme amacıyla arka planda yüklenen URL adresi.
userSpecifiedTrackingUrl

string

İsteğe bağlı. Kullanıcı tarafından manuel olarak belirtilen izleme URL'si.
callToAction

enum (CallToAction)

Zorunlu. Reklamda gösterilen harekete geçirici mesaj düğmesi.

Desteklenen değerler:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

Zorunlu. Reklamda gösterilen başlıkların listesi.
longHeadlines[]

string

Zorunlu. Reklamda gösterilen uzun başlıkların listesi.
descriptions[]

string

Zorunlu. Reklamda gösterilen açıklamaların listesi.
displayUrlBreadcrumb1

string

İsteğe bağlı. Görünen URL'deki alan adından sonraki ilk bölüm.
displayUrlBreadcrumb2

string

İsteğe bağlı. Görünen URL'deki alan adından sonra gelen ikinci kısım.
videos[]

object (YoutubeVideoDetails)

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

map (key: string, value: string)

İsteğe bağlı. İzleme URL'sine eklenecek özel parametreler ve bunlara eşlik eden değerler.

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

object (ImageAsset)

İsteğe bağlı. Bu reklam tarafından kullanılan tamamlayıcı banner.
finalMobileUrl

string

İsteğe bağlı. Kullanıcıların mobil cihazda reklamı tıkladıktan sonra eriştiği web sayfasının URL adresi.
finalUrlSuffix

string

İsteğe bağlı. Açılış sayfası URL'lerine eklenecek sonek.
businessName

string

Zorunlu. Reklamda gösterilen işletme adı.

CallToAction

Talep Yaratma ürün/video reklamları için olası harekete geçirici mesaj değerleri.

Sıralamalar
CALL_TO_ACTION_UNSPECIFIED Belirtilmemiş veya bilinmiyor.
AUTOMATED Otomatiktir.
LEARN_MORE Daha fazla bilgi edinin.
GET_QUOTE Fiyat teklifi alın.
APPLY_NOW Hemen başvurun.
SIGN_UP Kaydol'u tıklayın.
CONTACT_US Bize ulaşın.
SUBSCRIBE Abone ol'a dokunun.
DOWNLOAD İndir'e dokunun.
BOOK_NOW Hemen rezervasyon yapın.
SHOP_NOW Hemen satın alın.
BUY_NOW Hemen satın alın.
DONATE_NOW Hemen bağış yapın.
ORDER_NOW Hemen sipariş verin.
PLAY_NOW Şimdi oynat.
SEE_MORE Daha fazla bilgi edinin.
START_NOW Şimdi başlayın.
VISIT_SITE Siteyi ziyaret edin.
WATCH_NOW Şimdi İzleyin.

DemandGenImageAd

Talep Yaratma resim reklamıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
Alanlar
finalUrl

string

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

string

Yalnızca çıkış. İzleme amacıyla arka planda yüklenen URL adresi.
userSpecifiedTrackingUrl

string

İsteğe bağlı. Kullanıcı tarafından manuel olarak belirtilen izleme URL'si.
callToAction

string

Zorunlu. Reklamda gösterilen harekete geçirici mesaj düğmesi.
headlines[]

string

Zorunlu. Reklamda gösterilen başlıkların listesi.
descriptions[]

string

Zorunlu. Reklamda gösterilen açıklamaların listesi.
customParameters

map (key: string, value: string)

İsteğe bağlı. İzleme URL'sine eklenecek özel parametreler ve bunlara eşlik eden değerler.

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

string

İsteğe bağlı. Kullanıcıların mobil cihazda reklamı tıkladıktan sonra eriştiği web sayfasının URL adresi.
finalUrlSuffix

string

İsteğe bağlı. Açılış sayfası URL'lerine eklenecek sonek.
businessName

string

Zorunlu. Reklamda gösterilen işletme adı.
marketingImages[]

object (ImageAsset)

Reklamda gösterilen pazarlama resimlerinin listesi.
squareMarketingImages[]

object (ImageAsset)

Reklamda gösterilen kare pazarlama resimlerinin listesi.
portraitMarketingImages[]

object (ImageAsset)

Reklamda gösterilen dikey pazarlama resimlerinin listesi.
logoImages[]

object (ImageAsset)

Reklamda gösterilen logo resimlerinin listesi.

DemandGenCarouselAd

Talep Yaratma dönen reklamıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
Alanlar
finalUrl

string

Zorunlu. Kullanıcıların reklamı tıkladıktan sonra ulaştıkları web sayfasının URL adresi.
headline

string

Zorunlu. Reklamın başlığı.
description

string

Zorunlu. Reklamın açıklaması.
cards[]

object (CarouselCard)

Zorunlu. Reklamda gösterilen kartların listesi.
finalUrlSuffix

string

İsteğe bağlı. Açılış sayfası URL'lerine eklenecek sonek.
trackingUrl

string

Yalnızca çıkış. İzleme amacıyla arka planda yüklenen URL adresi.
userSpecifiedTrackingUrl

string

İsteğe bağlı. Kullanıcı tarafından manuel olarak belirtilen izleme URL'si.
businessName

string

Zorunlu. Reklamda gösterilen işletme adı.
customParameters

map (key: string, value: string)

İsteğe bağlı. İzleme URL'sine eklenecek özel parametreler ve bunlara eşlik eden değerler.

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

CarouselCard

Talep Yaratma rulo resim kartıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
Alanlar
finalUrl

string

Zorunlu. Kartı tıkladıktan sonra kullanıcıların eriştiği web sayfasının URL adresi.
finalMobileUrl

string

İsteğe bağlı. Mobil cihazda kartı tıkladıktan sonra kullanıcıların eriştiği web sayfasının URL adresi.
headline

string

Zorunlu. Kartın başlığı.
callToAction

string

Zorunlu. Kartta gösterilen harekete geçirici mesaj düğmesindeki metin.

En fazla 10 karakter kullanılmalıdır.
marketingImage

object (ImageAsset)

İsteğe bağlı. Kartta gösterilen pazarlama resmi.
squareMarketingImage

object (ImageAsset)

İsteğe bağlı. Kartta gösterilen kare pazarlama resmi.
portraitMarketingImage

object (ImageAsset)

İsteğe bağlı. Kartta gösterilen dikey pazarlama resmi.

DemandGenProductAd

Talep Yaratma ürün reklamıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
Alanlar
finalUrl

string

Zorunlu. Kullanıcıların reklamı tıkladıktan sonra ulaştıkları web sayfasının URL adresi.
headline

string

Zorunlu. Reklamın başlığı.
description

string

Zorunlu. Reklamın açıklaması.
finalUrlSuffix

string

İsteğe bağlı. Açılış sayfası URL'lerine eklenecek sonek.
callToAction

enum (CallToAction)

Zorunlu. Reklamda gösterilen harekete geçirici mesaj düğmesi.

Desteklenen değerler:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

Yalnızca çıkış. İzleme amacıyla arka planda yüklenen URL adresi.
userSpecifiedTrackingUrl

string

İsteğe bağlı. Kullanıcı tarafından manuel olarak belirtilen izleme URL'si.
businessName

string

Zorunlu. Reklamda gösterilen işletme adı.
customParameters

map (key: string, value: string)

İsteğe bağlı. İzleme URL'sine eklenecek özel parametreler ve bunlara eşlik eden değerler.

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

string

İsteğe bağlı. Görünen URL'deki alan adından sonraki ilk bölüm.
displayUrlBreadcrumb2

string

İsteğe bağlı. Görünen URL'deki alan adından sonra gelen ikinci kısım.

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önderilecek izleme URL'si.
AD_URL_TYPE_BEACON_SKIP Atlama etkinliği tetiklendiğinde ping gönderilecek izleme URL'si.

DcmTrackingInfo

DCM izleme ile ilgili ayrıntılar.

JSON gösterimi 
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
Alanlar
placementId

string (int64 format)

Zorunlu. DCM yerleşim kimliği.
trackingAdId

string (int64 format)

Zorunlu. DCM izleme reklamı kimliği.
creativeId

string (int64 format)

Zorunlu. DCM reklam öğesi kimliği.

Yöntemler

create

 Bir reklam grubu reklamı oluşturur.

delete

 Reklam grubu reklamını siler.

get

 Bir reklam grubu reklamı alır.

list

 Reklam grubu reklamlarını listeler.

patch

 Bir reklam grubu reklamını günceller.