Method: customLists.list

यह कस्टम सूचियों की सूची बनाता है.

ऑर्डर, orderBy पैरामीटर से तय होता है.

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

GET https://displayvideo.googleapis.com/v3/customLists

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

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

पैरामीटर
pageSize

integer

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

pageToken

string

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

orderBy

string

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

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

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

filter

string

कस्टम सूची वाले फ़ील्ड के हिसाब से फ़िल्टर करने की अनुमति देता है.

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

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

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

  • displayName

उदाहरण:

  • वे सभी कस्टम सूचियां जिनके डिसप्ले नाम में "Google" शामिल है: displayName:"Google".

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

ज़्यादा जानकारी के लिए, हमारी फ़िल्टर LIST के अनुरोध गाइड देखें.

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

string (int64 format)

DV360 ऐडवर्टाइज़र का आईडी, जिसके पास फ़ेच की गई कस्टम सूचियों का ऐक्सेस है.

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

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

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

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना
{
  "customLists": [
    {
      object (CustomList)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
customLists[]

object (CustomList)

कस्टम सूचियों की सूची.

अगर यह सूची खाली होगी, तो यह नहीं होगी.

nextPageToken

string

नतीजों का अगला पेज वापस पाने के लिए टोकन. नतीजों का अगला पेज वापस पाने के लिए, अगली कॉल customLists.list तरीके में इस वैल्यू को pageToken फ़ील्ड में पास करें.

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

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

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

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