REST Resource: sellers.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,
  "photoUris": [
    string
  ],
  "products": [
    string
  ]
}
Alanlar
name

string

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

string

Satıcı tarafından yönetilen kimlik muhtemelen kendi sisteminde. Değişme olasılığı düşük olarak ayarlandığında.
displayName

string

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

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

string

Reklam birimini açıklayan ek serbest biçimli alan.
labels

map (key: string, value: string)

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)

Bu reklam birimini daha ayrıntılı bir şekilde tanımlayan özellikler.
creatives[]

object (CreativeSpecification)

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

True (doğru) ise yön alanında yön değeri bulunur. Yanlış ise yön sıfır olmalıdır.
direction

integer

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

boolean

True (doğru) ise, yükseklik alanı metre cinsinden yüksekliği içerir. Yanlış ise yükseklik sıfır olmalıdır.
elevationMeters

number

Sabit. Reklam biriminin alt kısmından yere kadar olan mesafe (metre cinsinden).
physicalWidthMetersSet

boolean

True (doğru) değerine ayarlanırsa fiziksel GenişlikMeter alanı, metre cinsinden fiziksel genişliği içerir. False (yanlış) değerine ayarlanırsa fizikselGenişlikMeter değeri sıfır olmalıdır.
physicalWidthMeters

number

Sabit. Reklam biriminin metre cinsinden fiziksel genişliği.
physicalHeightMetersSet

boolean

True (doğru) değerine ayarlanırsa geoHeightMeters alanı, fiziksel yüksekliği metre cinsinden içerir. False (yanlış) değerine ayarlanırsa fizikselHeightMeter değeri sıfır olmalıdır.
physicalHeightMeters

number

Sabit. Reklam biriminin metre cinsinden fiziksel yüksekliği.
venue

enum (OutOfHomeVenue)

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

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

boolean

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

string

Reklam biriminin fotoğraf URI'leri.
products[]

string

Zorunlu. Bu reklam birimiyle ilişkili ürünlerin sellers/{seller}/products/{product} biçimindeki kaynak adları. Örneğin: sellers/seller111/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ış.

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.