يسرد الطلبات المضمونة التي يمكن للمستخدم الحالي الوصول إليها.
يتم تحديد الترتيب من خلال المَعلمة orderBy. إذا لم يتم تحديد filter من قِبل entityStatus، لن يتم تضمين الطلبات المضمونة التي تحمل حالة الكيان ENTITY_STATUS_ARCHIVED في النتائج.
طلب HTTP
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 (=).
تحدّد كيان "مساحة العرض والفيديو 360" الذي يتم تقديم الطلب ضمنه. لن يعرض طلب "القائمة" سوى كيانات الطلبات المضمونة التي يمكن لكيان "مساحة العرض والفيديو 360" المحدّد داخل accessor. يمكن أن يكون accessor واحدًا فقط مما يلي:
رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في طريقة الاستدعاء التالية إلى guaranteedOrders.list لاسترداد الصفحة التالية من النتائج.
تاريخ التعديل الأخير: 2024-09-09 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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"]]