REST Resource: orders.lines

संसाधन: लाइन

एक ऑर्डर लाइन, जो कॉन्फ़िगर किए गए प्रॉडक्ट के बारे में बताती है.

JSON के काेड में दिखाना
{
  "name": string,
  "product": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "lineState": enum (LineState),
  "rejection": {
    object (Rejection)
  },
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "lineTerms": {
    object (LineTerms)
  },
  "pendingReservationExpirationTime": string,
  "reservationExpirationTime": string,
  "targeting": {
    object (Targeting)
  },
  "createTime": string,
  "updateTime": string
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. फ़ॉर्मैट में लाइन के संसाधन का नाम: orders/{order_id}/lines/{id}.

product

string

सिर्फ़ आउटपुट के लिए. उस Product का नाम जिसे यह लाइन कॉन्फ़िगर कर रही है. फ़ॉर्मैट = products/123

externalId

string

ज़रूरी नहीं. इस इकाई को बाहरी सोर्स से मैप करने के लिए इस्तेमाल किया जाने वाला आईडी.

displayName

string

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

description

string

सिर्फ़ आउटपुट के लिए. लाइन के बारे में जानकारी देने के लिए, फ़्रीफ़ॉर्म फ़ील्ड.

lineState

enum (LineState)

सिर्फ़ आउटपुट के लिए. लाइन की स्थिति. लाइन का लाइफ़साइकल जानने के लिए, LineState पर जाएं.

विक्रेता इन कस्टम तरीकों का इस्तेमाल कर सकता है: Reserve, Book, और Reject:

  • LINE_STATE_RESERVED
  • LINE_STATE_BOOKED
  • LINE_STATE_REJECTED_BY_SELLER.

अन्य सभी लाइन की स्थितियों को खरीदार सेट करता है.

rejection

object (Rejection)

ज़रूरी नहीं. लाइन के अस्वीकार होने की जानकारी.

startTime
(deprecated)

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. जब लाइन को दिखाना शुरू किया जाएगा (शामिल है).

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

endTime
(deprecated)

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. जब लाइन का दिखना बंद हो जाएगा (खास तौर पर).

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

startDate

object (Date)

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

endDate

object (Date)

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

budget

object (Money)

सिर्फ़ आउटपुट के लिए. लाइन का बजट.

lineTerms

object (LineTerms)

सिर्फ़ आउटपुट के लिए. इस लाइन के लिए विक्रेता की गारंटी वाली शर्तें.

pendingReservationExpirationTime

string (Timestamp format)

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

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

reservationExpirationTime

string (Timestamp format)

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

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

targeting

object (Targeting)

सिर्फ़ आउटपुट के लिए. लाइन के लिए टारगेटिंग.

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

LineState

लाइन की स्थिति.

Enums
LINE_STATE_UNSPECIFIED इस वर्शन में लाइन के स्टेटस के बारे में जानकारी नहीं दी गई हो या उसके बारे में जानकारी न हो, तो डिफ़ॉल्ट वैल्यू.
LINE_STATE_PENDING_RESERVATION खरीदार ने यह लाइन बनाई है. इसमें प्रॉडक्ट को बुक करने का अनुरोध किया जा रहा है. साथ ही, प्रॉडक्ट की कीमत और खरीदारी के लिए उपलब्धता की जानकारी को अपडेट करने का भी अनुरोध किया गया है.
LINE_STATE_RESERVED यह लाइन विक्रेता ने बुक की थी. ऐसा सिर्फ़ तब किया जा सकता है, जब पिछले राज्य में बुकिंग की मंज़ूरी बाकी हो.
LINE_STATE_PENDING_BOOKING खरीदार ने बुकिंग स्वीकार कर ली है और लाइन बुक करने का अनुरोध कर रहा है.
LINE_STATE_BOOKED विक्रेता ने लाइन बुक कर दी है. ऐसा सिर्फ़ तब किया जा सकता है, जब पिछले राज्य में बुकिंग होनी बाकी हो. इस समय, आवेदन अस्वीकार होने की उम्मीद नहीं है.
LINE_STATE_REJECTED_BY_SELLER विक्रेता ने अनुरोध अस्वीकार कर दिया. ऐसा सिर्फ़ तब किया जा सकता है, जब पिछले राज्य में बुकिंग की मंज़ूरी बाकी हो.
LINE_STATE_CANCELLED_BY_BUYER खरीदार ने लाइन को रद्द कर दिया.
LINE_STATE_PENDING_RESERVATION_EXPIRED लंबित आरक्षण की वजह से लाइन की समय-सीमा खत्म हो गई.
LINE_STATE_RESERVED_EXPIRED आरक्षण के दौरान पंक्ति की समय सीमा खत्म हो गई, क्योंकि खरीदार के जवाब की इंतज़ार की जा रही है.

तरीके

book

मौजूदा लाइन को बुक करता है.

get

किसी ऑर्डर के लिए अलग-अलग लाइन की जानकारी हासिल करता है.

list

यह किसी ऑर्डर के लिए लाइनें दिखाता है.

patch

किसी मौजूदा लाइन को अपडेट करता है.

reject

मौजूदा लाइन को अस्वीकार कर देता है.

reserve

मौजूदा लाइन को रिज़र्व करता है.