Method: customBiddingAlgorithms.list

यह कस्टम बिडिंग वाले ऐसे एल्गोरिदम की सूची बनाता है जिन्हें मौजूदा उपयोगकर्ता ऐक्सेस कर सकते हैं और जिनका इस्तेमाल बिडिंग के अलग-अलग लेवल में किया जा सकता है.

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

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

GET https://displayvideo.googleapis.com/v2/customBiddingAlgorithms

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

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

पैरामीटर
pageSize

integer

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

pageToken

string

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

orderBy

string

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

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

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

filter

string

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

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

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

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

  • customBiddingAlgorithmType
  • displayName

उदाहरण:

  • सभी कस्टम बिडिंग एल्गोरिदम, जिनके डिसप्ले नेम में "politics" शामिल है: displayName:"politics".
  • सभी कस्टम बिडिंग एल्गोरिदम, जिनका टाइप "स्क्रिप्ट_BASED" है: customBiddingAlgorithmType=SCRIPT_BASED

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

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

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

string (int64 format)

उस DV360 पार्टनर का आईडी जिसके पास कस्टम बिडिंग वाले एल्गोरिदम का ऐक्सेस है.

advertiserId

string (int64 format)

DV360 की मदद से विज्ञापन देने वाले उस व्यक्ति का आईडी जिसके पास कस्टम बिडिंग वाले एल्गोरिदम का ऐक्सेस है.

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

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

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

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

जेएसओएन के काेड में दिखाना
{
  "customBiddingAlgorithms": [
    {
      object (CustomBiddingAlgorithm)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
customBiddingAlgorithms[]

object (CustomBiddingAlgorithm)

कस्टम बिडिंग वाले एल्गोरिदम की सूची.

अगर कोई सूची खाली होगी, तो यह नहीं दिखेगी.

nextPageToken

string

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

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

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

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

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