Method: advertisers.channels.list

यह किसी पार्टनर या विज्ञापन देने वाले व्यक्ति या कंपनी के लिए चैनल की सूची बनाता है.

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

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/channels

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

पाथ पैरामीटर

पैरामीटर
ज़रूरी है. इससे उस DV360 इकाई की पहचान होती है जिसके पास चैनलों का मालिकाना हक है. यह पार्टनर या विज्ञापन देने वाला व्यक्ति या कंपनी हो सकती है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
advertiserId

string (int64 format)

विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जिसके पास चैनलों का मालिकाना हक है.
एक-दूसरे से अलग फ़ील्ड के आखिर में.

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

पैरामीटर
pageSize

integer

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

string

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

string

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

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

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

string

इससे चैनल फ़ील्ड के हिसाब से फ़िल्टर किया जा सकता है.

काम करने वाला सिंटैक्स:

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

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

  • displayName

उदाहरण:

  • उन सभी चैनलों के लिए जिनमें डिसप्ले नेम में "google" शामिल है: displayName : "google".

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

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

string (int64 format)

चैनलों का मालिकाना हक रखने वाले पार्टनर का आईडी.
एक-दूसरे से अलग फ़ील्ड के आखिर में.

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

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

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में ListChannelsResponse का एक इंस्टेंस शामिल किया जाता है.

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

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

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

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