Method: customLists.list

कस्टम सूचियां दिखाता है.

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

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

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

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

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

पैरामीटर
pageSize

integer

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

string

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

string

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

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

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

string

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

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

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

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

  • displayName

उदाहरण:

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

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

ज़्यादा जानकारी के लिए, हमारी फ़िल्टर LIST के अनुरोध गाइड देखें.
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 की खास जानकारी देखें.