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 yapmadan 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

Bu açık artırma paketinin göreli rota adı. "exchanges/{seller_id}/auctionpackages/{auction_package_id}" biçiminde olmalıdır. Örnek: "exchanges/1234/auctionPackage/5678". Yalnızca çıkış.
displayName

string

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

enum (DiscoveryObjectStatus)

Bu açık artırma paketinin durumu. DURDURULDU veya KALDIRILDI durumuna sahip paketler DV3 reklamverenlere gösterilmez. Zorunlu.
description

string

Bu paketin açıklama metni. UTF-8 kodlu olmalı ve en fazla 2.000 karakter uzunluğunda olmalıdır. Zorunlu.
format

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

Teklif isteklerinde kullanılan exchange anlaşma kimliği. En fazla 100 karakter. İzin verilen karakterler alfanümerik, alt çizgi, kısa çizgi ve noktadır. Zorunlu. Zorunlu. Oluşturulduktan sonra güncellemelere izin vermez.
logoUrl

string

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

Yalnızca çıkış.
floorPrice

object (Money)

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

string (Timestamp format)

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

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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)

Bu ürünün etkin olmadığı zaman. Zorunlu.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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 medya türü.
urgOwners[]

enum (UnderRepresentedGroup)

İsteğe bağlı. Sahibinin üyesi olduğu az temsil edilen 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

 Bir açık artırma paketi alır.

list

 Açık artırma paketlerini listeler.

patch

 Açık artırma paketini günceller.
Belirtilen paketin logosunu yükleyin.