REST Resource: exchanges.auctionPackages

संसाधन: AuctionPackage

इसमें एक नीलामी पैकेज होता है. DV3 में विज्ञापन देने वाले, मार्केटप्लेस डिस्कवरी यूज़र इंटरफ़ेस (यूआई) की मदद से DV3 में सभी ऑक्शन पैकेज ब्राउज़ कर सकते हैं. साथ ही, सेलर की कार्रवाई के बिना इन पैकेज का इस्तेमाल करने के लिए ऑप्ट इन कर सकते हैं.

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
}
फ़ील्ड
name

string

इस नीलामी पैकेज के लिए रिलेटिव रूट का नाम. यह इस फ़ॉर्मैट में होना चाहिए: "exchanges/{seller_id}/auctionpackages/{auction_package_id} उदाहरण: "exchanges/1234/auctionPackage/5678". सिर्फ़ आउटपुट के लिए.
displayName

string

इस नीलामी पैकेज का डिसप्ले नेम. यह UTF-8 कोड में होना चाहिए और इसमें ज़्यादा से ज़्यादा 240 वर्ण होने चाहिए. ज़रूरी है.
status

enum (DiscoveryObjectStatus)

इस नीलामी पैकेज की स्थिति. जिन पैकेज की स्थिति 'रोका गया' या 'हटाया गया' है वे DV3 का इस्तेमाल करने वाले विज्ञापन देने वालों को नहीं दिखाए जाते. ज़रूरी है.
description

string

इस पैकेज के बारे में जानकारी देने वाला टेक्स्ट. यह UTF-8 कोड में होना चाहिए और इसमें ज़्यादा से ज़्यादा 2,000 वर्ण होने चाहिए. ज़रूरी है.
format

enum (Format)

विज्ञापन फ़ॉर्मैट का टाइप. ज़रूरी है. स्पेस बनाने के बाद, उसमें बदलाव नहीं किया जा सकता.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

इस ऑक्शन पैकेज की इन्वेंट्री के लिए, अनुमानित ब्रेकडाउन. DV3 का इस्तेमाल करने वाले विज्ञापन देने वाले, इन ब्रेकडाउन को देख सकते हैं और फ़िल्टर कर सकते हैं. ज़रूरी नहीं.
externalDealId

string

बिड रिक्वेस्ट में इस्तेमाल किया जाने वाला एक्सचेंज डील आईडी. ज़्यादा से ज़्यादा 100 वर्ण. इसमें अक्षर, अंक, अंडरस्कोर, डैश, और बिंदु का इस्तेमाल किया जा सकता है. ज़रूरी है. ज़रूरी है. बनाने के बाद अपडेट करने की अनुमति नहीं है.
logoUrl

string

सिर्फ़ आउटपुट के लिए. इस नीलामी पैकेज के लोगो का यूआरएल.

सिर्फ़ आउटपुट के लिए.
floorPrice

object (Money)

इस नीलामी पैकेज की फ़्लोर प्राइस. ज़रूरी है.
startTime

string (Timestamp format)

यह प्रॉडक्ट चालू होने का समय. यह endTime से पहले की होनी चाहिए. शुरू होने का समय, आने वाले समय में एक साल से ज़्यादा का नहीं हो सकता. ज़रूरी है.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होता है और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाते हैं. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

वह समय जब यह प्रॉडक्ट बंद हो जाता है. ज़रूरी है.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होता है और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाते हैं. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
mediumType

enum (MediumType)

ज़रूरी है. नीलामी पैकेज का मीडियम टाइप.
urgOwners[]

enum (UnderRepresentedGroup)

ज़रूरी नहीं. ऐसे ग्रुप जिनमें कम प्रतिनिधित्व वाले समुदायों के लोग शामिल हैं. अगर कोई ग्रुप है, तो मालिक उस ग्रुप का सदस्य होना चाहिए.
dv3MarketplaceUri

string

सिर्फ़ आउटपुट के लिए. मार्केटप्लेस में नीलामी पैकेज के लिए DV360 लिंक.

फ़ॉर्मैट

नीलामी पैकेज के लिए विज्ञापन फ़ॉर्मैट.

Enums
DEAL_FORMAT_UNSPECIFIED डील के फ़ॉर्मैट की जानकारी नहीं दी गई है. इनपुट के लिए मान्य नहीं है.
DEAL_FORMAT_DISPLAY डिसप्ले फ़ॉर्मैट.
DEAL_FORMAT_VIDEO वीडियो फ़ॉर्मैट.
DEAL_FORMAT_AUDIO ऑडियो फ़ॉर्मैट.

तरीके

create

 नया नीलामी पैकेज बनाता है.

get

 नीलामी पैकेज मिलता है.

list

 नीलामी पैकेज की सूची दिखाता है.

patch

 नीलामी पैकेज को अपडेट करता है.
चुने गए पैकेज का लोगो अपलोड करें.