Method: inventorySources.list

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

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

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

GET https://displayvideo.googleapis.com/v2/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 की किस इकाई में अनुरोध किया जा रहा है. सूची के अनुरोध से, इन्वेंट्री सोर्स की सिर्फ़ वे इकाइयां दिखेंगी जिन्हें 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 की खास जानकारी देखें.