उन ऑर्डर की सूची दिखाता है जिनके प्रोसेस होने की गारंटी है और जिन्हें मौजूदा उपयोगकर्ता ऐक्सेस कर सकता है.
क्रम, orderBy पैरामीटर से तय होता है. अगर filter तक entityStatus की कोई जानकारी नहीं दी गई है, तो इकाई की स्थिति ENTITY_STATUS_ARCHIVED वाले, गारंटी वाले ऑर्डर नतीजों में शामिल नहीं किए जाएंगे.
एचटीटीपी अनुरोध
GET https://displayvideo.googleapis.com/v3/guaranteedOrders
पेज का अनुरोध किया गया साइज़. यह वैल्यू 1 और 200 के बीच होनी चाहिए. अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से 100 लागू हो जाएगा.
pageToken
string
नतीजों के उस पेज की पहचान करने वाला टोकन जिसे सर्वर को दिखाना चाहिए. आम तौर पर, यह guaranteedOrders.list वाले तरीके के पिछले कॉल से मिली nextPageToken की वैल्यू होती है. अगर कोई नंबर नहीं दिया जाता है, तो नतीजों का पहला पेज दिखेगा.
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 इकाई के लिए किया जा रहा है. LIST अनुरोध, सिर्फ़ उन ऑर्डर की इकाइयों को दिखाएगा जिन्हें 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"]],["आखिरी बार 2025-02-25 (UTC) को अपडेट किया गया."],[[["Lists guaranteed orders accessible to the current user, filterable by order ID, exchange, display name, and entity status."],["Supports pagination with `pageSize` and `pageToken` for retrieving large result sets."],["Requires `https://www.googleapis.com/auth/display-video` authorization scope for access."],["Returns a list of guaranteed orders and a token for retrieving the next page of results, if available."],["Accessible via a `GET` request to `https://displayvideo.googleapis.com/v3/guaranteedOrders`."]]],["This document outlines how to retrieve a list of guaranteed orders via an HTTP GET request to `https://displayvideo.googleapis.com/v3/guaranteedOrders`. Key actions include setting optional query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` to customize the results. `partnerId` or `advertiserId` are required parameters. The response includes a list of `guaranteedOrders` and a `nextPageToken` for pagination. Filtering by fields like `entityStatus` is possible, and specific authorization scopes are needed. The request body should be empty.\n"]]