REST Resource: exchanges.orders

संसाधन: ऑर्डर

खरीदार के लिए ऐसा ऑफ़र जिसे स्वीकार करना ज़रूरी है.

JSON के काेड में दिखाना 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
फ़ील्ड
name

string

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

string

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

string (int64 format)

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

string

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

string

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

object (Budget)

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

enum (OrderStatus)

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

object (WSeatConfig)

ज़रूरी नहीं. WSeat कॉन्फ़िगरेशन यह एक्सचेंज के हिसाब से WSeat कॉन्फ़िगरेशन तय करता है. मल्टी-सीट डील का इस्तेमाल करने वाले एक्सचेंज को इस फ़ील्ड को अपडेट रखना होगा.
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".
buyerInfo

object (BuyerInfo)

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

बजट

बजट तय किया गया.

JSON के काेड में दिखाना 
{
  "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.
}
फ़ील्ड
budgetType

enum (BudgetType)

बजट का तय किया गया टाइप.
यूनियन फ़ील्ड budget. सिर्फ़ एक तरह का बजट शामिल किया जा सकता है. budget इनमें से सिर्फ़ एक हो सकता है:
impressions

string (int64 format)

इंप्रेशन बजट.
money

object (Money)

बजट की मुद्रा.

BudgetType

बजट टाइप

Enums
BUDGET_TYPE_UNSPECIFIED बजट तय नहीं किया गया है. इनपुट के लिए मान्य नहीं है.
BUDGET_TYPE_CURRENCY बजट की मुद्रा.
BUDGET_TYPE_IMPRESSION इंप्रेशन बजट.

OrderStatus

ऑर्डर का स्टेटस.

Enums
ORDER_STATUS_UNSPECIFIED ऑर्डर के स्टेटस की जानकारी नहीं दी गई है. यह एक अप्रत्याशित स्थिति है. इससे पता चलता है कि बातचीत की स्थिति के बारे में जानकारी नहीं है. इनपुट वैल्यू मान्य नहीं है.
PENDING_ACCEPTANCE ऑर्डर की स्थिति, स्वीकार किया जाना बाकी है.
ACCEPTED ऑर्डर की स्थिति स्वीकार की गई.
ARCHIVED ऑर्डर का स्टेटस संग्रहित किया गया.
CANCELLED ऑर्डर की स्थिति रद्द की गई.
NEGOTIATING ऑर्डर की स्थिति, नेगोशिएट की जा रही है. यह सिर्फ़ इंस्टैंट डील के लिए लागू होता है.

WSeatConfig

WSeat कॉन्फ़िगरेशन.

JSON के काेड में दिखाना 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
फ़ील्ड
exchangeWseatStatus

enum (WSeatStatus)

ज़रूरी नहीं. WSeat कॉन्फ़िगरेशन के लिए, Exchange की मौजूदा स्थिति.
exchangeWseatIds[]

string (int64 format)

ज़रूरी नहीं. एक्सचेंज के हिसाब से WSeat आईडी.
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. जब एक्सचेंज, WSeatConfiguration को अपडेट करता है, तब DV360 इस फ़ील्ड को अपने-आप अपडेट कर देता है.

यह 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".

WSeatStatus

WSeat Status enum के विकल्प.

Enums
W_SEAT_STATUS_UNSPECIFIED WSeatStatus की जानकारी नहीं दी गई है.
W_SEAT_STATUS_ENFORCED WSeatStatus लागू किया गया. इससे पता चलता है कि Exchange, WSeatId को लागू करता है. इसके लिए, वह WSeatId को DV360 को भेजता है या बिड रिस्पॉन्स में wseatids की पुष्टि करता है.
W_SEAT_STATUS_NOT_ENFORCED WSeatStatus लागू नहीं किया गया है. इससे पता चलता है कि Exchange, बिड अनुरोधों में wseatid नहीं भेजता है. साथ ही, बिड अनुरोधों में wseatid की पुष्टि नहीं करता है.

BuyerInfo

Instant Deal के लिए खरीदार की जानकारी.

JSON के काेड में दिखाना 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
फ़ील्ड
partner

object (PartnerInfo)

सिर्फ़ आउटपुट के लिए. पार्टनर की जानकारी.
advertisers[]

object (AdvertiserInfo)

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले व्यक्ति या कंपनी की जानकारी.

PartnerInfo

Instant Deal के उदाहरणों के लिए, पार्टनर की जानकारी.

JSON के काेड में दिखाना 
{
  "title": string
}
फ़ील्ड
title

string

सिर्फ़ आउटपुट के लिए. Display & Video 360 में पार्टनर का डिसप्ले टाइटल.

AdvertiserInfo

Instant Deal के लिए, विज्ञापन देने वाले व्यक्ति या कंपनी की जानकारी.

JSON के काेड में दिखाना 
{
  "advertiserId": string,
  "domainUri": string
}
फ़ील्ड
advertiserId

string (int64 format)

सिर्फ़ आउटपुट के लिए. Display & Video 360 में विज्ञापन देने वाले का आईडी.
domainUri

string

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले व्यक्ति या कंपनी की वेबसाइट का डोमेन यूआरआई.

तरीके

accept

 ऑर्डर स्वीकार करता है.

create

 यह कुकी, ऑर्डर बनाती है.

get

 ऑर्डर मिलता है.

list

 सूचियों का क्रम.

patch

 इस तरीके का इस्तेमाल करके, किसी ऑर्डर को अपडेट किया जा सकता है.