REST Resource: adUnits

Kaynak: Reklam Birimi

Tek bir reklam birimi.

JSON gösterimi 
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "attributes": [
    enum (AdUnitAttribute)
  ],
  "creatives": [
    {
      object (CreativeSpecification)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (AdUnitState),
  "rejectedReason": string,
  "location": {
    object (LatLng)
  },
  "directionSet": boolean,
  "direction": integer,
  "elevationMetersSet": boolean,
  "elevationMeters": number,
  "physicalWidthMetersSet": boolean,
  "physicalWidthMeters": number,
  "physicalHeightMetersSet": boolean,
  "physicalHeightMeters": number,
  "venue": enum (OutOfHomeVenue),
  "fixedLocation": boolean,
  "indoors": boolean,
  "impressionDataRanges": [
    {
      object (ImpressionDataRange)
    }
  ],
  "photoUrls": [
    string
  ],
  "products": [
    string
  ]
}
Alanlar
name

string

Reklam biriminin adUnits/{id} biçimindeki kaynak adı. Örneğin: adUnits/adUnit123.
externalId

string

İsteğe bağlı. Satıcı tarafından yönetilen kimlik muhtemelen kendi sisteminde. Değişme olasılığı düşük olarak ayarlandığında. Dahili olarak kullanılmamalıdır ve herhangi bir kısıtlama uygulanmaz.
displayName

string

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

Maksimum 240 bayt boyutta UTF-8 olarak kodlanmış olmalıdır.
description

string

İsteğe bağlı. Reklam birimini açıklayan ek serbest biçimli alan.
labels

map (key: string, value: string)

İsteğe bağlı. Bu reklam birimini açıklayan serbest biçimli etiket kümesi.

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

enum (AdUnitAttribute)

İsteğe bağlı. Bu reklam birimini daha ayrıntılı bir şekilde tanımlayan özellikler.
creatives[]

object (CreativeSpecification)

İsteğe bağlı. Bu reklam birimi için yayınlanabilecek izin verilen reklam öğelerinin listesi. Bu, Ürün düzeyinde de tanımlanabilir.
createTime

string (Timestamp format)

Yalnızca çıkış. Reklam biriminin oluşturulma zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Yalnızca çıkış. Reklam biriminin son güncelleme zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
state

enum (AdUnitState)

Yalnızca çıkış. Reklam biriminin durumu. AD_UNIT_STATE_REJECTED ise ret Nedeni, nedeni içerir.
rejectedReason

string

Yalnızca çıkış. onay_durumu AD_UNIT_APPROVAL_STATUS_REJECTED ise nedeni bu alanda yer alır.
location

object (LatLng)

Zorunlu. Sabit. Reklam biriminin imzalı derece biçimindeki enlem ve boylamı.
directionSet

boolean

Zorunlu. Yön ayarlanmışsa doğru değerini alır.
direction

integer

İsteğe bağlı. Sabit. Kuzeyin 0'ı temsil ettiği derece cinsinden kardinal yön. [0-360).
elevationMetersSet

boolean

Zorunlu. yükseklikMetreleri ayarlanmışsa doğru değerini döndürür.
elevationMeters

number

İsteğe bağlı. Sabit. Reklam biriminin alt kısmından yere kadar olan mesafe (metre cinsinden).
physicalWidthMetersSet

boolean

Zorunlu. fizikselGenişlikMeter ayarlıysa doğru değerini döndürür.
physicalWidthMeters

number

İsteğe bağlı. Sabit. Reklam biriminin metre cinsinden fiziksel genişliği.
physicalHeightMetersSet

boolean

Zorunlu. assetHeightMeter ayarlanmışsa doğru değerini döndürür.
physicalHeightMeters

number

İsteğe bağlı. Sabit. Reklam biriminin metre cinsinden fiziksel yüksekliği.
venue

enum (OutOfHomeVenue)

İsteğe bağlı. DPAA standartlarına dayalı ev dışı mekan türü. Bu, reklamverenlere sunulabilen ve reklam birimlerini filtrelemek için de kullanılabilen bilgi amaçlı bir alandır.
fixedLocation

boolean

İsteğe bağlı. Reklamın sabit konumda mı (ilan tahtası) yoksa hareket halinde mi (taksi) olduğu.
indoors

boolean

Zorunlu. Reklam biriminin içeride olup olmadığı.
impressionDataRanges[]

object (ImpressionDataRange)

Zorunlu. Bu reklam birimiyle ilişkili gösterim veri aralıkları. Tarih aralıklarının çakışması beklenmez. Reklam biriminin satın almaya uygun olması için gösterim verileri gereklidir.
photoUrls[]

string

İsteğe bağlı. Reklam biriminin fotoğraf URL'leri.
products[]

string

Zorunlu. Bu reklam birimiyle ilişkili ürünlerin products/{id} biçimindeki kaynak adları. Örneğin: products/product123.

AdUnitAttribute

Reklam birimini daha ayrıntılı tanımlamak için kullanılan olası özellikler.

Sıralamalar
AD_UNIT_ATTRIBUTE_UNSPECIFIED Reklam Birimi Özelliği belirtilmediğinde veya bu sürümde bilinmiyorsa varsayılan değer.
AD_UNIT_ATTRIBUTE_ILLUMINATED Reklam birimi fiziksel dünyadaysa karanlıkta görülebiliyor mu?
AD_UNIT_ATTRIBUTE_DIGITAL Dijital reklam birimi (klasik fiziksel dahil değilse) ima edilir.
AD_UNIT_ATTRIBUTE_PHYSICAL Reklam birimi fiziksel dünyada bir nesne olarak bulunur.

AdUnitState

Satıcının bakış açısından bir reklam biriminin durumu.

Sıralamalar
AD_UNIT_STATE_UNSPECIFIED Reklam Birimi Durumu belirtilmediğinde veya bu sürümde bilinmiyorsa varsayılan değer.
AD_UNIT_STATE_PENDING Reklam birimi onay bekliyor.
AD_UNIT_STATE_APPROVED Reklam birimi onaylandı.
AD_UNIT_STATE_REJECTED Reklam birimi reddedildi.
AD_UNIT_STATE_DELETED Reklam birimi silindi.

OutOfHomeVenue

DPAA Standartları'na dayalı ev dışı mekan türlerinin listesi.

Sıralamalar
OOH_VENUE_UNSPECIFIED OOH Mekanı belirtilmediğinde veya bu sürümde bilinmiyorsa varsayılan değer.
OOH_VENUE_AIRBORNE Ev dışı mekânlar hava yoluyla sınıflandırılmış.
OOH_VENUE_AIRPORTS_GENERAL Genel havaalanları olarak sınıflandırılan ev dışı yerler.
OOH_VENUE_AIRPORTS_BAGGAGE_CLAIM Ev dışı alanlar, havalimanları bagaj alım yeri olarak sınıflandırılır.
OOH_VENUE_AIRPORTS_TERMINAL Havaalanı terminali olarak sınıflandırılan ev dışı alanlar.
OOH_VENUE_AIRPORTS_LOUNGES Havaalanı dinlenme salonu olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_ATMS ATM olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_BACKLIGHTS Ev dışı mekan, arka ışık olarak sınıflandırılmış.
OOH_VENUE_BARS Bar olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_BENCHES Bank olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_BIKE_RACKS Bisiklet parkı olarak sınıflandırılan ev dışı alanlar.
OOH_VENUE_BULLETINS Bülten olarak sınıflandırılmış ev dışı mekânlar.
OOH_VENUE_BUSES Ev dışı mekan, otobüs olarak sınıflandırılmış.
OOH_VENUE_CAFES Kafe olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_CASUAL_DINING_RESTAURANTS Sade restoran olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_CHILD_CARE Ev dışı mekânlar, çocuk bakımı olarak sınıflandırılmıştır.
OOH_VENUE_CINEMA Sinema olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_CITY_INFORMATION_PANELS Ev dışı mekânlar, şehir bilgi panelleri olarak sınıflandırılır.
OOH_VENUE_CONVENIENCE_STORES Market olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_DEDICATED_WILD_POSTING Ev dışı yayın alanları, özel çılgın içerik yayınlama olarak sınıflandırılmıştır.
OOH_VENUE_DOCTORS_OFFICES_GENERAL Genel doktor muayenehanesi olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_DOCTORS_OFFICES_OBSTETRICS Doktor muayenehanesi olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_DOCTORS_OFFICES_PEDIATRICS Doktor muayenehaneleri ve çocuk doktoru olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_FAMILY_ENTERTAINMENT Aile eğlencesi olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_FERRIES Feribot olarak sınıflandırılan ev dışı alanlar.
OOH_VENUE_FINANCIAL_SERVICES Finansal hizmetler olarak sınıflandırılan ev dışı yerler.
OOH_VENUE_GAS_STATIONS Benzin istasyonu olarak sınıflandırılan ev dışı mekânlar.
OOH_VENUE_GOLF_COURSES Golf sahası olarak sınıflandırılan ev dışı tesis.
OOH_VENUE_GYMS Spor salonu olarak sınıflandırılan ev dışı mekânlar.
OOH_VENUE_HOSPITALS Hastane olarak sınıflandırılan ev dışı mekânlar.
OOH_VENUE_HOTELS Otel olarak sınıflandırılan ev dışı mekânlar.
OOH_VENUE_JUNIOR_POSTERS Genç reklam posterleri olarak sınıflandırılan ev dışı alanlar.
OOH_VENUE_KIOSKS Kiosk olarak sınıflandırılan ev dışı yerler.
OOH_VENUE_MALLS_GENERAL Genel alışveriş merkezi olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_MALLS_FOOD_COURTS Alışveriş merkezlerindeki yemek alanları olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_MARINE Deniz temalı olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_MOBILE_BILLBOARDS Ev dışı mekanları, mobil ilan tahtaları olarak sınıflandırılır.
OOH_VENUE_MOVIE_THEATER_LOBBIES Sinema lobisi olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_NEWSSTANDS gazetelik olarak sınıflandırılan ev dışı mekânlar.
OOH_VENUE_OFFICE_BUILDINGS Ofis binası olarak sınıflandırılan ev dışı alanlar.
OOH_VENUE_PHONE_KIOSKS Ev dışı yerler, telefon kioskları olarak sınıflandırılmıştır.
OOH_VENUE_POSTERS Poster olarak sınıflandırılan ev dışı mekânlar.
OOH_VENUE_QSR Ev dışı mekânlar, qsr olarak sınıflandırılmış.
OOH_VENUE_RAIL Demir yolu olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_RECEPTACLES Ev dışı mekânlar, priz olarak sınıflandırılmıştır.
OOH_VENUE_RESORTS Tatil köyü olarak sınıflandırılan ev dışı yerler.
OOH_VENUE_RETAIL Perakende olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_SALONS Ev dışı mekânlar, salon olarak sınıflandırılmıştır.
OOH_VENUE_SHELTERS Sığınma olarak sınıflandırılan ev dışı alanlar.
OOH_VENUE_SPORTS_ARENAS Spor arenası olarak sınıflandırılan ev dışı alanlar.
OOH_VENUE_SUBWAY Metro olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_TAXIS Taksi olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_TRUCKSIDE Kamyon kenarı olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_UNIVERSITIES Üniversite olarak sınıflandırılan ev dışı yerler.
OOH_VENUE_URBAN_PANELS Şehir dışı paneller olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_VETERINARIAN_OFFICES Veteriner muayenehaneleri olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_WALLS Duvar olarak sınıflandırılan ev dışı mekan.
OOH_VENUE_OTHER Ev dışı mekan, diğer olarak sınıflandırılmış.

ImpressionDataRange

Bir tarih aralığına ait gösterim verileri.

JSON gösterimi 
{
  "impressionDataStartTime": string,
  "impressionDataEndTime": string,
  "impressionDataUnits": [
    {
      object (ImpressionDataUnit)
    }
  ]
}
Alanlar
impressionDataStartTime

string (Timestamp format)

Zorunlu. Gösterim verilerinin geçerli olduğu aralığın başlangıcı (dahil).

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
impressionDataEndTime

string (Timestamp format)

Zorunlu. Gösterim verilerinin geçerli (hariç) olduğu aralığın sonu.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
impressionDataUnits[]

object (ImpressionDataUnit)

Zorunlu. Belirtilen tarih aralığındaki gösterim verileri.

ImpressionDataUnit

Haftanın belirli bir günü ve günün belirli bir saati için gösterim verileri.

JSON gösterimi 
{
  "dayOfWeek": enum (DayOfWeek),
  "hourOfDay": integer,
  "impressions": string
}
Alanlar
dayOfWeek

enum (DayOfWeek)

Zorunlu. Gösterim verilerinin temsil ettiği haftanın günüdür.
hourOfDay

integer

Zorunlu. Gösterim verilerinin 24 saat biçiminde temsil ettiği günün saatleri. 0 ile 23 arasında olmalıdır.
impressions

string (int64 format)

Zorunlu. Haftanın belirtilen gününde, belirtilen günün saatlerinde gösterim sayısı.

Yöntemler

create

 Yeni bir reklam birimi oluşturur.

delete

 Mevcut bir reklam birimini siler.

get

 Tek bir reklam birimini alır.

list

 Reklam birimlerini listeler.

patch

 Mevcut bir reklam birimini günceller.