Method: partners.channels.sites.list

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

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

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

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

पाथ पैरामीटर

पैरामीटर
channelId

string (int64 format)

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

string (int64 format)

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

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

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

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

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

अनुमति के दायरे

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

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

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