Method: customBiddingAlgorithms.list

इस फ़ंक्शन से, कस्टम बिडिंग वाले उन एल्गोरिदम की सूची मिलती है जिन्हें मौजूदा उपयोगकर्ता ऐक्सेस कर सकता है. साथ ही, बिडिंग की रणनीतियों में इस्तेमाल कर सकता है.

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

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

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

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

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

पैरामीटर
pageSize

integer

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

string

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

string

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

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

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

string

इसकी मदद से, कस्टम बिडिंग वाले एल्गोरिदम के फ़ील्ड के हिसाब से फ़िल्टर किया जा सकता है.

काम करने वाला सिंटैक्स:

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

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

  • customBiddingAlgorithmType
  • displayName

उदाहरण:

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

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

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

string (int64 format)

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

string (int64 format)

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

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

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

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

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "customBiddingAlgorithms": [
    {
      object (CustomBiddingAlgorithm)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
customBiddingAlgorithms[]

object (CustomBiddingAlgorithm)

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

अगर यह सूची खाली होगी, तो यह मौजूद नहीं होगी.
nextPageToken

string

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

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

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

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

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