Method: exchanges.auctionPackages.patch

नीलामी पैकेज अपडेट करता है.

एचटीटीपी अनुरोध

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
auctionPackage.name

string

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

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
फ़ील्ड
auctionPackage.displayName

string

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

enum (DiscoveryObjectStatus)

ज़रूरी है. इस नीलामी पैकेज की स्थिति. जिन पैकेज की स्थिति PAUSED या REMOVED है वे DV360 के विज्ञापन देने वाले लोगों या कंपनियों को नहीं दिखते.
auctionPackage.description

string

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

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

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

string

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

object (Money)

ज़रूरी है. इस नीलामी पैकेज का न्यूनतम मूल्य.
auctionPackage.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".
auctionPackage.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".
auctionPackage.mediumType

enum (MediumType)

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

enum (UnderRepresentedGroup)

ज़रूरी नहीं. ऐसे ग्रुप जिनमें मालिक, कम प्रतिनिधित्व वाले ग्रुप का सदस्य है.
updateMask

string (FieldMask format)

ज़रूरी नहीं. मास्क, यह कंट्रोल करने के लिए होता है कि किन फ़ील्ड को अपडेट करना है.

यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा लगाकर अलग की गई लिस्ट है. उदाहरण: "user.displayName,photo".
auctionPackage.dv3MarketplaceUri

string

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

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में AuctionPackage का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/doubleclickbidmanager

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.