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 के उपयोगकर्ताओं के ऑर्डर स्वीकार करने, रद्द करने या संग्रहित करने के बाद, स्थिति में बदलाव हो सकता है. साथ ही, एपीआई में ऑर्डर बनाने के बाद, उसे 'रद्द किया गया' के तौर पर अपडेट करने की सुविधा भी उपलब्ध है. इससे यह पता चलता है कि एक्सचेंज पर यह ऑर्डर रद्द कर दिया गया है.
wseatConfig

object (WSeatConfig)

ज़रूरी नहीं. WSeat Configuration Specifies the WSeat configuration on the exchange side. मल्टी-सीट डील का इस्तेमाल करने वाले एक्सचेंज को इस फ़ील्ड को अपडेट रखना होगा.
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".
buyerInfo

object (BuyerInfo)

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

बजट

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

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

enum (BudgetType)

बजट का तय किया गया टाइप.
सिर्फ़ एक तरह का बजट शामिल किया जा सकता है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 इस फ़ील्ड को अपने-आप अपडेट कर देता है.

यह आरएफ़सी 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 लागू किया गया. यह दर्शाता है कि एक्सचेंज या तो WSeatId को DV3 को भेजकर या बोली प्रतिक्रियाओं में wseatids को सत्यापित करके WSeatId का प्रवर्तन करता है.
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

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