इसमें, गारंटी वाले ऐसे ऑर्डर की सूची होती है जिन्हें मौजूदा उपयोगकर्ता ऐक्सेस कर सकता है.
ऑर्डर, orderBy पैरामीटर से तय होता है. अगर entityStatus के लिए filter की जानकारी नहीं दी गई है, तो इकाई की स्थिति ENTITY_STATUS_ARCHIVED वाले गारंटी वाले ऑर्डर, नतीजों में शामिल नहीं किए जाएंगे.
एचटीटीपी अनुरोध
GET https://displayvideo.googleapis.com/v2/guaranteedOrders
अनुरोध किया गया पेज साइज़. वैल्यू, 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 से ज़्यादा वर्ण नहीं होने चाहिए.
इससे पता चलता है कि किस DV360 इकाई के लिए अनुरोध किया जा रहा है. 'सूची' अनुरोध की मदद से, गारंटी वाली सिर्फ़ वे ऑर्डर इकाइयां दिखाई जाएंगी जिन्हें accessor में बताई गई DV360 इकाई के पास ऐक्सेस किया जा सकता है. accessor इनमें से सिर्फ़ एक हो सकता है:
नतीजों का अगला पेज वापस पाने के लिए टोकन. नतीजों का अगला पेज वापस पाने के लिए, अगली कॉल guaranteedOrders.list तरीके में इस वैल्यू को pageToken फ़ील्ड में पास करें.
[[["समझने में आसान है","easyToUnderstand","thumb-up"],["मेरी समस्या हल हो गई","solvedMyProblem","thumb-up"],["अन्य","otherUp","thumb-up"]],[["वह जानकारी मौजूद नहीं है जो मुझे चाहिए","missingTheInformationINeed","thumb-down"],["बहुत मुश्किल है / बहुत सारे चरण हैं","tooComplicatedTooManySteps","thumb-down"],["पुराना","outOfDate","thumb-down"],["अनुवाद से जुड़ी समस्या","translationIssue","thumb-down"],["सैंपल / कोड से जुड़ी समस्या","samplesCodeIssue","thumb-down"],["अन्य","otherDown","thumb-down"]],["आखिरी बार 2024-09-09 (UTC) को अपडेट किया गया."],[[["Lists guaranteed orders accessible to the current user, filterable by order ID, exchange, display name, and entity status."],["Results can be sorted by display name and are paginated with default page size of 100."],["Requires specifying an accessor (partner ID or advertiser ID) to identify the DV360 entity context for the request."],["Uses the `https://www.googleapis.com/auth/display-video` OAuth scope for authorization."]]],["This document details how to list accessible guaranteed orders using the Display & Video 360 API. Use a `GET` request to `guaranteedOrders` endpoint. Parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` for sorting and filtering results. You must specify a `partnerId` or `advertiserId`. The response returns a list of `guaranteedOrders` and a `nextPageToken` for pagination. Authorization requires the `display-video` OAuth scope. `ENTITY_STATUS_ARCHIVED` is excluded unless it is specifically filtered for.\n"]]