Method: sellers.orders.list

ऑर्डर की सूची बनाता है.

  • उदाहरण के लिए, GET /v1/sellers/321/order
  • सफल होने पर अगला पेज वापस पाने के लिए ऑर्डर की सूची और टोकन दिखाता है.
  • अगर उपयोगकर्ता के पास सेलर आईडी या सेलर आईडी का ऐक्सेस नहीं है, तो गड़बड़ी का कोड PERMISSION_DENIED दिखाता है.
  • अगर सेलर अमान्य पेज साइज़ या पेज टोकन देते हैं, तो गड़बड़ी का कोड INVALID_ARGUMENT दिखाता है.

एचटीटीपी अनुरोध

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/orders

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. माता-पिता, जो ऑर्डर के इस कलेक्शन का मालिक होता है. फ़ॉर्मैट: सेलर/{seller}

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

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

string

अगर पिछले सूची अनुरोध की मदद से, NextPageToken वैल्यू कोई मिलती है, तो वह मिलती है.
filter

string

सूची फ़िल्टर. फ़िलहाल, बाहरी आईडी और स्थिति को फ़िल्टर करने के लिए, इस सिंटैक्स का इस्तेमाल किया जा सकता है: "externalId = [EXTERNAL_ID]" और "state = [स्टेट]". लॉजिकल ऑपरेटर AND और OR का इस्तेमाल फ़िल्टर चेन के लिए किया जा सकता है.
orderBy

string

नतीजों को क्रम से लगाने के लिए, स्ट्रिंग के हिसाब से क्रम का इस्तेमाल किया जाता है. फ़िलहाल, updateTime से ऑर्डर करने की सुविधा उपलब्ध है. "updateTime" की जानकारी दें अपडेट के समय के हिसाब से बढ़ते क्रम या "updateTime का ब्यौरा" के हिसाब से क्रम में लगाए गए नतीजे पाने के लिए घटते क्रम में लगाएं.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "orders": [
    {
      object (Order)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
orders[]

object (Order)

ऑर्डर की सूची.
nextPageToken

string

नतीजों का अगला पेज वापस पाने के लिए टोकन. नतीजों का अगला पेज वापस पाने के लिए, अगली कॉल orders.list तरीके में इस वैल्यू को pageToken फ़ील्ड में पास करें.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/doubleclickbidmanager

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.