Method: partners.channels.sites.list

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

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

GET https://displayvideo.googleapis.com/v5/partners/{partnerId}/channels/{channelId}/sites

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

पाथ पैरामीटर

पैरामीटर
channelId

string (int64 format)

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

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 अनुरोधों को फ़िल्टर करना गाइड देखें.
ज़रूरी है. यह उस DV360 इकाई की पहचान करता है जिसके पास पैरंट चैनल का मालिकाना हक है. यह कोई पार्टनर या विज्ञापन देने वाला हो सकता है. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
advertiserId

string (int64 format)

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

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

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

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

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

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

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

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

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