Method: guaranteedOrders.list

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

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

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

GET https://displayvideo.googleapis.com/v4/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 Exchanges से जुड़े गारंटी वाले ऑर्डर: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"

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

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

ज़रूरी है.

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