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

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

object (WSeatConfig)

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

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. ऑर्डर या उससे जुड़े प्रॉडक्ट की जानकारी अपडेट किए जाने का टाइमस्टैंप.

यह RFC 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 देखें.