Method: customBiddingAlgorithms.list

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

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

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

GET https://displayvideo.googleapis.com/v3/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 करने के अनुरोध से जुड़ी हमारी गाइड देखें.
यूनियन पैरामीटर 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 Overview देखें.