Method: customBiddingAlgorithms.list

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

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

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

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

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

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

पैरामीटर
pageSize

integer

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

string

नतीजों के उस पेज की पहचान करने वाला टोकन जिसे सर्वर को दिखाना चाहिए. आम तौर पर, यह customBiddingAlgorithms.list वाले तरीके के पिछले कॉल से मिली nextPageToken की वैल्यू होती है. अगर कोई वैल्यू नहीं दी जाती है, तो नतीजों का पहला पेज दिखेगा.
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 अनुरोधों को फ़िल्टर करने से जुड़ी हमारी गाइड देखें.
यूनियन पैरामीटर accessor. ज़रूरी है. इससे पता चलता है कि किस DV360 इकाई के लिए अनुरोध किया जा रहा है. LIST अनुरोध से सिर्फ़ कस्टम बिडिंग वाली एल्गोरिदम इकाइयां दिखेंगी जो accessor में मौजूद DV360 इकाई के लिए ऐक्सेस की जा सकती हैं. LIST अनुरोध करने के लिए, उपयोगकर्ता के पास accessor इकाई की अनुमति होनी चाहिए. 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 की खास जानकारी देखें.