يسرد مصادر المستودع التي يمكن للمستخدم الحالي الوصول إليها.
يتم تحديد الترتيب من خلال المعلَمة orderBy. إذا لم يتم تحديد filter لـ entityStatus، لن يتم تضمين مصادر المستودع التي تحمل حالة الكيان ENTITY_STATUS_ARCHIVED في النتائج.
طلب HTTP
GET https://displayvideo.googleapis.com/v1/inventorySources
حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 1 و200. وفي حال عدم تحديد قيمة، سيتم ضبط القيمة تلقائيًا على "100".
pageToken
string
هو رمز مميز يحدد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة nextPageToken التي يتم عرضها من الاستدعاء السابق لطريقة inventorySources.list. وفي حال عدم تحديده، سيتم عرض الصفحة الأولى من النتائج.
orderBy
string
الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
displayName (تلقائي)
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي للحقل، يجب استخدام اللاحقة "desc" يجب إضافته إلى اسم الحقل. مثلاً: displayName desc
filter
string
تسمح بالفلترة حسب حقول مصدر المستودع.
بنية متوافقة:
تتكون تعبيرات الفلاتر من قيد واحد أو أكثر.
ويمكن دمج القيود من خلال عوامل التشغيل المنطقية AND أو OR. سلسلة من القيود تستخدم ضمنيًا AND.
يكون للقيد {field} {operator} {value}.
يجب أن تستخدم جميع الحقول عامل التشغيل EQUALS (=).
الحقول المسموح بها:
status.entityStatus
commitment
deliveryMethod
rateDetails.rateType
exchange
أمثلة:
كل مصادر المستودع النشطة: status.entityStatus="ENTITY_STATUS_ACTIVE"
مصادر المستودع التابعة لـ "مدير إعلانات Google" أو تبادلات Rubicon: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"
معلمة الاتحاد accessor. مطلوب. تحدِّد كيان "مساحة العرض والفيديو 360" الذي يتم تقديم الطلب ضمنه. لن يعرض طلب "القائمة" سوى كيانات مصدر المستودع التي يمكن لكيان "مساحة العرض والفيديو 360" المحدّد داخل accessor. يمكن أن يكون accessor واحدًا فقط مما يلي:
رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في طريقة الاستدعاء التالية إلى inventorySources.list لاسترداد الصفحة التالية من النتائج.
تاريخ التعديل الأخير: 2024-09-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-12 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists inventory sources accessible to the current user, ordered by `orderBy` parameter and excluding archived sources unless specified in the `filter`."],["The API request is a `GET` request to `https://displayvideo.googleapis.com/v1/inventorySources` with optional query parameters for pagination, sorting, and filtering."],["Request body should be empty, and the response will contain a list of inventory sources and a token for retrieving the next page of results."],["Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope."]]],["This document details how to use the Display & Video 360 API to list accessible inventory sources. Users send a `GET` request to the specified URL, with optional query parameters for `pageSize`, `pageToken`, `orderBy`, and `filter`, to refine the results. The request must identify the accessible DV360 entity via the required union parameter `accessor` which can be a `partnerId` or `advertiserId`. The response contains a list of `inventorySources` and a `nextPageToken` for pagination. Archived inventory sources are excluded unless specified by a filter. The request body must be empty, and authorization requires a specific OAuth scope.\n"]]