Method: advertisers.channels.sites.list

किसी चैनल में मौजूद साइटों की सूची दिखाता है.

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

GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/channels/{channelId}/sites

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

पाथ पैरामीटर

पैरामीटर
channelId

string (int64 format)

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

string (int64 format)

विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जिसके पास पैरंट चैनल का मालिकाना हक है.

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

पैरामीटर
pageSize

integer

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

string

यह एक टोकन है. इससे नतीजों के उस पेज की पहचान होती है जिसे सर्वर को दिखाना चाहिए.

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

string

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

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

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

string

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

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

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

इन फ़ील्ड के लिए यह सुविधा उपलब्ध है:

  • urlOrAppId

उदाहरण:

  • वे सभी साइटें जिनके यूआरएल या ऐप्लिकेशन आईडी में "google" शामिल है: urlOrAppId : "google"

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

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

string (int64 format)

उस पार्टनर का आईडी जिसके पास पैरंट चैनल का मालिकाना हक है.

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

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

जवाब का मुख्य हिस्सा

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

अनुमति के स्कोप

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

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

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