Method: guaranteedOrders.list

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

ऑर्डर, orderBy पैरामीटर से तय होता है. अगर entityStatus के लिए filter की जानकारी नहीं दी गई है, तो इकाई की स्थिति ENTITY_STATUS_ARCHIVED वाले गारंटी वाले ऑर्डर, नतीजों में शामिल नहीं किए जाएंगे.

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

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

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

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

पैरामीटर
pageSize

integer

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

string

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

string

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

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

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

string

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

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

इस्तेमाल किए जा सकने वाले फ़ील्ड: * guaranteedOrderId * exchange * displayName * status.entityStatus

उदाहरण:

  • 'किराया रिफ़ंड की गारंटी' वाले सभी चालू ऑर्डर: status.entityStatus="ENTITY_STATUS_ACTIVE"
  • Google Ad Manager या Rubicon एक्सचेंज से जुड़े गारंटी वाले ऑर्डर: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"

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

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

यूनियन पैरामीटर accessor. ज़रूरी है.

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

string (int64 format)

उस पार्टनर का आईडी जिसके पास, 'किराया रिफ़ंड की गारंटी' वाले ऑर्डर का ऐक्सेस है.
advertiserId

string (int64 format)

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

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

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

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

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

JSON के काेड में दिखाना 
{
  "guaranteedOrders": [
    {
      object (GuaranteedOrder)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
guaranteedOrders[]

object (GuaranteedOrder)

'किराया रिफ़ंड की गारंटी' वाले ऑर्डर की सूची.

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

string

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

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

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

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

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