Method: customBiddingAlgorithms.list

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

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

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

GET https://displayvideo.googleapis.com/v1/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 की किस इकाई के लिए अनुरोध किया जा रहा है. LIST अनुरोध, कस्टम बिडिंग वाले एल्गोरिदम की सिर्फ़ वे इकाइयां दिखाएगा जो accessor में पहचानी गई DV360 इकाई के लिए ऐक्सेस कर सकती हैं. LIST अनुरोध करने के लिए, उपयोगकर्ता के पास 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 की खास जानकारी देखें.