REST Resource: exchanges.auctionPackages

Resource: AuctionPackage

Mengenkapsulasi 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

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

displayName

string

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

status

enum (DiscoveryObjectStatus)

Status paket lelang ini. Paket dengan status DIJEDA atau DIHAPUS tidak ditampilkan kepada pengiklan DV3. Wajib.

description

string

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

format

enum (Format)

Jenis format iklan yang mendasarinya. Wajib. Pembaruan tidak diizinkan setelah pembuatan.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

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

externalDealId

string

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)

Harga minimum paket lelang ini. Wajib.

startTime

string (Timestamp format)

Waktu saat produk ini menjadi aktif. Harus lebih awal dari endTime. Waktu mulai tidak boleh lebih dari 1 tahun ke depan. Wajib.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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)

Waktu saat produk ini menjadi tidak aktif. Wajib.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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 anggotanya adalah 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 tampilan.
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.
Upload logo untuk paket yang ditentukan.