Method: inventorySources.list

यह इन्वेंट्री के उन सोर्स की सूची बनाता है जिन्हें मौजूदा उपयोगकर्ता ऐक्सेस कर सकते हैं.

यह क्रम orderBy पैरामीटर से तय होता है. अगर entityStatus के filter के बारे में नहीं बताया गया है, तो ENTITY_STATUS_ARCHIVED इकाई की स्थिति वाले इन्वेंट्री सोर्स को नतीजों में शामिल नहीं किया जाएगा.

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

GET https://displayvideo.googleapis.com/v1/inventorySources

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

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

पैरामीटर
pageSize

integer

पेज का वह साइज़ जिसके लिए अनुरोध किया गया है. वैल्यू, 1 और 200 के बीच होनी चाहिए. अगर कोई जानकारी नहीं दी गई है, तो वह डिफ़ॉल्ट रूप से 100 पर सेट हो जाएगी.

pageToken

string

एक टोकन, जो सर्वर को दिखाए जाने वाले नतीजों के पेज की पहचान करता है. आम तौर पर, यह nextPageToken की वैल्यू है. यह वैल्यू, inventorySources.list को पिछले कॉल किए गए तरीके से मिलती है. अगर इसके बारे में तय नहीं किया गया है, तो नतीजों का पहला पेज दिखाया जाएगा.

orderBy

string

वह फ़ील्ड जिसके आधार पर सूची को क्रम से लगाया जाना है. ये वैल्यू स्वीकार की जा सकती हैं:

  • displayName (डिफ़ॉल्ट)

क्रम से लगाने का डिफ़ॉल्ट क्रम बढ़ते क्रम में है. किसी फ़ील्ड के घटते क्रम में तय करने के लिए, फ़ील्ड के नाम में "ब्यौरा" सफ़िक्स जोड़ना चाहिए. उदाहरण के लिए, displayName desc.

filter

string

इन्वेंट्री सोर्स फ़ील्ड के हिसाब से फ़िल्टर करने की सुविधा मिलती है.

इस्तेमाल किया जा सकने वाला सिंटैक्स:

  • फ़िल्टर एक्सप्रेशन में एक या ज़्यादा पाबंदियां होती हैं.
  • AND या OR लॉजिकल ऑपरेटर की मदद से, पाबंदियां जोड़ी जा सकती हैं. पाबंदियों का क्रम, साफ़ तौर पर AND का इस्तेमाल करता है.
  • पाबंदी {field} {operator} {value} के रूप में होती है.
  • सभी फ़ील्ड में EQUALS (=) ऑपरेटर का इस्तेमाल करना ज़रूरी है.

इस्तेमाल किए जा सकने वाले फ़ील्ड:

  • status.entityStatus
  • commitment
  • deliveryMethod
  • rateDetails.rateType
  • exchange

उदाहरण:

  • सभी ऐक्टिव इन्वेंट्री सोर्स: status.entityStatus="ENTITY_STATUS_ACTIVE"
  • Google Ad Manager या Rubicon एक्सचेंज से जुड़े इन्वेंट्री सोर्स: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"

इस फ़ील्ड में 500 से ज़्यादा वर्ण नहीं होने चाहिए.

ज़्यादा जानकारी के लिए, हमारी फ़िल्टर LIST अनुरोध गाइड देखें.

यूनियन पैरामीटर accessor. ज़रूरी है. इससे पता चलता है कि DV360 की किस इकाई के लिए अनुरोध किया जा रहा है. LIST अनुरोध से, इन्वेंट्री के सोर्स की सिर्फ़ वे इकाइयां दिखेंगी जिन्हें accessor में मौजूद DV360 इकाई से ऐक्सेस किया जा सकता है. accessor इनमें से सिर्फ़ एक हो सकता है:
partnerId

string (int64 format)

उस पार्टनर का आईडी जिसके पास इन्वेंट्री सोर्स का ऐक्सेस है.

advertiserId

string (int64 format)

उस विज्ञापन देने वाले का आईडी जिसके पास इन्वेंट्री सोर्स का ऐक्सेस है.

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

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

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

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

जेएसओएन के काेड में दिखाना
{
  "inventorySources": [
    {
      object (InventorySource)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
inventorySources[]

object (InventorySource)

इन्वेंट्री के सोर्स की सूची.

खाली होने पर, यह सूची नहीं दिखेगी.

nextPageToken

string

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

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

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

  • https://www.googleapis.com/auth/display-video

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