REST Resource: exchanges.auctionPackages

Kaynak: AuctionPackage

Tek bir açık artırma paketini kapsar. DV3'teki reklamverenler, pazar yeri keşfi kullanıcı arayüzü aracılığıyla DV3'teki tüm açık artırma paketlerine göz atabilir ve satıcı işlemi olmadan bu paketleri kullanmayı etkinleştirebilir.

JSON gösterimi 
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ],
  "dv3MarketplaceUri": string
}
Alanlar
name

string

Tanımlayıcı. Bu açık artırma paketinin göreli rota adı. Şu biçimde olmalıdır: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Örneğin: "exchanges/1234/auctionPackage/5678". Yalnızca çıkış.
displayName

string

Zorunlu. Bu açık artırma paketinin görünen adı. En fazla 240 karakter uzunluğunda ve UTF-8 kodlu olmalıdır. Zorunlu.
status

enum (DiscoveryObjectStatus)

Zorunlu. Bu açık artırma paketinin durumu. Durumu DURAKLATILDI veya KALDIRILDI olan paketler DV3 reklamverenlerine gösterilmez. Zorunlu.
description

string

Zorunlu. Bu paketin açıklama metni. En fazla 2.000 karakter boyutunda UTF-8 kodlu olmalıdır. Zorunlu.
format

enum (Format)

Zorunlu. Değişmez. Temel reklam biçimi türü. Zorunlu. Oluşturulduktan sonra güncellemelere izin verilmez.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

İsteğe bağlı. Bu açık artırma paketinin envanteri için tahmin dökümü. DV3 reklamverenleri bu dökümleri görebilir ve filtreleyebilir. İsteğe bağlı.
externalDealId

string

Zorunlu. Değişmez. Teklif isteklerinde kullanılan exchange anlaşması kimliği. En fazla 100 karakter. İzin verilen karakterler alfanümerik, alt çizgi, kısa çizgi ve nokta şeklindedir. Zorunlu. Zorunlu. Oluşturulduktan sonra güncellemeye izin verilmez.
logoUrl

string

Yalnızca çıkış. Bu açık artırma paketinin logosunun URL'si.

Yalnızca çıkış.
floorPrice

object (Money)

Zorunlu. Bu açık artırma paketinin taban fiyatı. Zorunlu.
startTime

string (Timestamp format)

Zorunlu. Bu ürünün etkinleşeceği zaman. endTime değerinden önce olmalıdır. Başlangıç zamanı, şu anki tarihten en fazla 1 yıl sonrası olabilir. Zorunlu.

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

string (Timestamp format)

Zorunlu. Bu ürünün devre dışı kalacağı zaman. Zorunlu.

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

enum (MediumType)

Zorunlu. Açık artırma paketinin ortam türü.
urgOwners[]

enum (UnderRepresentedGroup)

İsteğe bağlı. Sahibin üyesi olduğu, yeterince temsil edilmeyen gruplar (varsa)
dv3MarketplaceUri

string

Yalnızca çıkış. Pazar yerindeki açık artırma paketi için DV360 bağlantısı.

Biçim

Açık artırma paketi için reklam biçimi.

Sıralamalar
DEAL_FORMAT_UNSPECIFIED Anlaşma biçimi belirtilmemiş. Giriş için geçerli değil.
DEAL_FORMAT_DISPLAY Görüntüleme biçimi.
DEAL_FORMAT_VIDEO Video biçimi.
DEAL_FORMAT_AUDIO Ses biçimi.

Yöntemler

create

 Yeni bir açık artırma paketi oluşturur.

get

 Açık artırma paketi alır.

list

 Açık artırma paketlerini listeler.

patch

 Bir açık artırma paketini günceller.
Belirtilen paket için logo yükleyin.