REST Resource: availabilityOrders

रिसॉर्स: AvailabilityOrder

उपलब्धता ऑर्डर, AvailabilityLines का कलेक्शन होता है. खरीदारी के लिए उपलब्धता का ऑर्डर, खरीदार ने बनाया है. सेलर, उपलब्धता की जानकारी को जवाब के साथ अपडेट करता है.

वर्कफ़्लो इस तरह से है:

  • खरीदार, खरीदारी के लिए उपलब्धता का ऑर्डर बनाता है और लाइन बनाता है. इसके बाद, स्थिति को 'मंज़ूरी बाकी है' पर सेट कर देता है. खरीदारी के लिए उपलब्धता ऑर्डर या लाइन में, आगे के खरीदारों को बदलाव करने की अनुमति नहीं है.
  • विक्रेता, खरीदारी के लिए उपलब्धता की सभी लाइनों पर कार्रवाई करता है. इसके लिए, विक्रेता को खरीदारी के लिए उपलब्धता की शर्तों को पूरा करना होता है या 'अस्वीकार किया गया' के तौर पर मार्क करना होता है. पूरा या अस्वीकार करने की कार्रवाइयां सिर्फ़ तब की जा सकती हैं, जब ऑर्डर और लाइन की स्थिति 'मंज़ूरी बाकी' हो.
  • उपलब्धता के अनुरोध को 'पूरा हो गया' के तौर पर मार्क करने के लिए, विक्रेता complete कस्टम ऐक्शन का इस्तेमाल करता है. उपलब्धता ऑर्डर या चाइल्ड लाइन में और बदलाव करने की अनुमति नहीं है.
JSON के काेड में दिखाना 
{
  "name": string,
  "description": string,
  "state": enum (State),
  "pendingExpirationTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. उपलब्धता के क्रम में मौजूद संसाधन का नाम: availabilityOrders/{id}.
description

string

सिर्फ़ आउटपुट के लिए. उपलब्धता ऑर्डर के बारे में बताने के लिए, अतिरिक्त फ़्रीफ़ॉर्म फ़ील्ड.
state

enum (State)

सिर्फ़ आउटपुट के लिए. खरीदारी के लिए उपलब्धता ऑर्डर की स्थिति. AvailabilityOrder की लाइफ़साइकल के बारे में जानने के लिए AvailabilityOrder.State पर जाएं.

विक्रेता, Complete कस्टम तरीके का इस्तेमाल करके, STATE_COMPLETED पर सेट कर सकता है.
pendingExpirationTime

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. पिछली बार अपडेट किया गया टाइमस्टैंप. सिस्टम ने असाइन किया है.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
advertiserInfo

object (AdvertiserInfo)

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

स्थिति

खरीदारी के लिए उपलब्धता के ऑर्डर की स्थिति के लिए संभावित वैल्यू.

Enums
STATE_UNSPECIFIED डिफ़ॉल्ट वैल्यू, जब इस वर्शन में 'खरीदारी के लिए उपलब्धता' के ऑर्डर की स्थिति के बारे में नहीं बताया गया हो या उसकी जानकारी मौजूद न हो.
STATE_PENDING खरीदारी के लिए उपलब्धता अनुरोध की सेटिंग उपलब्ध कराने पर, उपलब्धता की मंज़ूरी बाकी है.
STATE_COMPLETED उपलब्धता की स्थिति तब पूरी हुई, जब विक्रेता ने सभी लाइनों के लिए उपलब्धता की जानकारी दे दी थी.
STATE_CANCELLED विक्रेता द्वारा सभी पंक्तियों के लिए उपलब्धता उत्तर प्रदान करने से पहले खरीदार द्वारा रद्द करने का अनुरोध प्रदान करने पर रद्द की गई उपलब्धता स्थिति.
STATE_EXPIRED सेलर के पूरा किए जाने से पहले, ऑर्डर की समयसीमा खत्म होने पर, उसकी उपलब्धता की स्थिति की समयसीमा खत्म हो गई हो.

तरीके

complete

 मौजूदा उपलब्धता ऑर्डर को 'पूरा हो गया' के तौर पर मार्क करता है.

get

 व्यक्तिगत उपलब्धता ऑर्डर को हासिल करता है.

list

 यह उपलब्धता ऑर्डर की सूची बनाता है.