REST Resource: exchanges.auctionPackages

रिसॉर्स: AuctionPackage

इसमें नीलामी के एक पैकेज की जानकारी होती है. DV3 में विज्ञापन देने वाले लोग या कंपनियां, Marketplace Discovery यूज़र इंटरफ़ेस (यूआई) की मदद से, 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 में विज्ञापन देने वाले लोगों या कंपनियों को, PAUSED या REMOVED स्थिति वाले पैकेज नहीं दिखाए जाते. ज़रूरी है.
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 से पहले का होना चाहिए. startTime, आने वाले समय के एक साल से ज़्यादा आगे का नहीं हो सकता. ज़रूरी है.

यह आरएफ़सी 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

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

फ़ॉर्मैट

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

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

तरीके

create

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

get

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

list

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

patch

 इससे नीलामी पैकेज अपडेट होता है.
इससे तय किए गए पैकेज के लिए लोगो अपलोड होता है.