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)

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

string

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

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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