Method: exchanges.orders.patch

किसी ऑर्डर को अपडेट करता है.

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

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

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

पाथ पैरामीटर

पैरामीटर
order.name

string

ऑर्डर के लिए, संसाधन का रिलेटिव नाम. सर्वर से जनरेट किया गया. उदाहरण: "exchanges/1234/orders/5678". सिर्फ़ आउटपुट के लिए.

अनुरोध का मुख्य हिस्सा

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

JSON के काेड में दिखाना 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "budgetType": enum (BudgetType),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
फ़ील्ड
order.displayName

string

ऑर्डर का वह नाम जो खरीदार को दिखता है. ज़्यादा से ज़्यादा 250 वर्ण. ज़रूरी नहीं.
order.partnerId[]

string (int64 format)

Google Display &Video 360 में पार्टनर आईडी. इसे पहले Doubleclick Bid Manager(DBM) के नाम से जाना जाता था. सिर्फ़ एक पार्टनर आईडी की अनुमति है. ज़रूरी है.
order.publisherEmail

string

पब्लिशर के लिए ईमेल. यह ईमेल, मान्य फ़ॉर्मैट में होना चाहिए. ज़्यादा से ज़्यादा 250 वर्ण. ज़रूरी नहीं.
order.publisherName

string

पब्लिशर का नाम. ज़्यादा से ज़्यादा 250 वर्ण. ज़रूरी है.
order.budget

object (Budget)

सिर्फ़ आउटपुट के लिए. खरीदार की ओर से सेट किया गया बजट. यह सेटिंग, सिर्फ़ इंस्टैंट डील के लिए लागू होती है.
order.status

enum (OrderStatus)

ऑर्डर का स्टेटस DV3 के उपयोगकर्ता, किसी ऑर्डर को स्वीकार, रद्द या संग्रहित करने के बाद, उसकी स्थिति बदल सकती है. इसके अलावा, एपीआई में ऑर्डर बनाने के बाद, उसे 'रद्द किया गया' के तौर पर अपडेट किया जा सकता है. इससे यह पता चलता है कि एक्सचेंज पर यह ऑर्डर रद्द कर दिया गया है.
order.wseatConfig

object (WSeatConfig)

ज़रूरी नहीं. WSeat कॉन्फ़िगरेशन, एक्सचेंज की ओर से WSeat कॉन्फ़िगरेशन के बारे में बताता है. मल्टी-सीट डील का इस्तेमाल करने वाले एक्सचेंज से यह उम्मीद की जाती है कि वे इस फ़ील्ड को अपडेट रखें.
order.updateTime

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".
order.buyerInfo

object (BuyerInfo)

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

string (FieldMask format)

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

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

जवाब का मुख्य हिस्सा

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

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

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

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

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