REST Resource: exchanges.auctionPackages

Resource: AuctionPackage

Merangkum satu paket lelang. Pengiklan di DV3 dapat menjelajahi semua paket lelang di DV3 melalui UI penemuan marketplace dan memilih untuk menggunakan paket ini tanpa tindakan penjual.

Representasi JSON 
{
  "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
}
Kolom
name

string

Pengenal. Nama rute relatif untuk paket lelang ini. Harus dalam bentuk: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Contoh: "exchanges/1234/auctionPackage/5678". Hanya output.
displayName

string

Wajib. Nama tampilan paket lelang ini. Harus berenkode UTF-8 dengan ukuran maksimum 240 karakter. Wajib.
status

enum (DiscoveryObjectStatus)

Wajib. Status paket lelang ini. Paket dengan status PAUSED atau REMOVED tidak ditampilkan kepada pengiklan DV3. Wajib.
description

string

Wajib. Teks deskripsi untuk paket ini. Harus berenkode UTF-8 dengan ukuran maksimum 2.000 karakter. Wajib.
format

enum (Format)

Wajib. Tidak dapat diubah. Jenis format iklan yang mendasarinya. Wajib. Pembaruan tidak diizinkan setelah pembuatan.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Opsional. Perincian perkiraan untuk inventaris paket lelang ini. Pengiklan DV3 dapat melihat dan memfilter perincian ini. Opsional.
externalDealId

string

Wajib. Tidak dapat diubah. ID transaksi bursa yang digunakan dalam permintaan bid. Maksimum 100 karakter. Karakter yang diizinkan adalah alfanumerik, garis bawah, tanda hubung, dan titik. Wajib. Wajib. Tidak mengizinkan pembaruan setelah pembuatan.
logoUrl

string

Hanya output. URL untuk logo paket lelang ini.

Hanya output.
floorPrice

object (Money)

Wajib. Harga minimum paket lelang ini. Wajib.
startTime

string (Timestamp format)

Wajib. Waktu saat produk ini menjadi aktif. Harus lebih awal dari endTime. Waktu mulai tidak boleh lebih dari 1 tahun di masa mendatang. Wajib.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Wajib. Waktu saat produk ini menjadi tidak aktif. Wajib.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
mediumType

enum (MediumType)

Wajib. Jenis media paket lelang.
urgOwners[]

enum (UnderRepresentedGroup)

Opsional. Grup yang kurang terwakili yang menjadi anggota pemilik, jika ada.
dv3MarketplaceUri

string

Hanya output. Link Dv360 untuk paket lelang di marketplace.

Format

Format iklan untuk paket lelang.

Enum
DEAL_FORMAT_UNSPECIFIED Format transaksi tidak ditentukan. Tidak valid untuk input.
DEAL_FORMAT_DISPLAY Format Display.
DEAL_FORMAT_VIDEO Format video.
DEAL_FORMAT_AUDIO Format audio.

Metode

create

 Membuat paket lelang baru.

get

 Mendapatkan paket lelang.

list

 Mencantumkan paket lelang.

patch

 Memperbarui paket lelang.
Mengupload logo untuk paket yang ditentukan.