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),

      // Union field budget can be only one of the following:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of list of possible types for union field budget.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string
  },
  "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 उपयोगकर्ताओं के ऑर्डर स्वीकार करने, रद्द करने या संग्रहित करने के बाद, स्थिति बदल सकती है. एपीआई में ऑर्डर बनाने के बाद, उसे 'रद्द किया गया' के तौर पर अपडेट करने की सुविधा भी उपलब्ध है. इससे यह पता चलता है कि Exchange पर यह ऑर्डर रद्द कर दिया गया है.
order.wseatConfig

object (WSeatConfig)

ज़रूरी नहीं. WSeat कॉन्फ़िगरेशन, Exchange के 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".
updateMask

string (FieldMask format)

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

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

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

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

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

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