يتم تحديد الترتيب من خلال المعلَمة orderBy. إذا لم يتم تحديد filter في entityStatus، لن يتم تضمين العناصر التي تحتوي على ENTITY_STATUS_ARCHIVED في النتائج.
طلب HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems
مطلوب. رقم تعريف المعلِن المطلوب إدراج تفاصيل إعلان له.
معامِلات طلب البحث
المعلمات
pageSize
integer
حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 1 و200. وفي حال عدم تحديد قيمة، سيتم ضبط القيمة تلقائيًا على "100". تعرض رمز الخطأ INVALID_ARGUMENT إذا تم تحديد قيمة غير صالحة.
pageToken
string
هو رمز مميز يحدد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة nextPageToken التي يتم عرضها من الاستدعاء السابق لطريقة lineItems.list. وفي حال عدم تحديده، سيتم عرض الصفحة الأولى من النتائج.
orderBy
string
الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
displayName (تلقائي)
entityStatus
updateTime
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي للحقل، يجب استخدام اللاحقة "desc" يجب إضافته إلى اسم الحقل. مثال: displayName desc
filter
string
تسمح بالفلترة حسب حقول العناصر.
بنية متوافقة:
تتكون تعبيرات الفلاتر من قيد واحد أو أكثر.
ويمكن دمج القيود من خلال عوامل التشغيل المنطقية AND أو OR. سلسلة من القيود تستخدم ضمنيًا AND.
يكون للقيد {field} {operator} {value}.
يجب أن يستخدم الحقل updateTime عامل التشغيل GREATER THAN OR EQUAL TO (>=) أو LESS THAN OR EQUAL TO (<=).
ويجب أن تستخدم جميع الحقول الأخرى عامل التشغيل EQUALS (=).
الحقول المسموح بها:
campaignId
displayName
entityStatus
insertionOrderId
lineItemId
lineItemType
updateTime (إدخال بتنسيق ISO 8601 أو YYYY-MM-DDTHH:MM:SSZ)
أمثلة:
كل العناصر ضمن طلب إدراج: insertionOrderId="1234"
كل العناصر "ENTITY_STATUS_ACTIVE" أو "ENTITY_STATUS_PAUSED" و"LINE_ITEM_TYPE_DISPLAY_DEFAULT" ضمن المعلِن: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
كل العناصر التي استغرق تعديلها أقل من أو يساوي 2020-11-04T18:54:47Z (بتنسيق ISO 8601): updateTime<="2020-11-04T18:54:47Z"
كل العناصر التي يكون وقت التعديل فيها أكبر من أو يساوي 2020-11-04T18:54:47Z (بتنسيق ISO 8601): updateTime>="2020-11-04T18:54:47Z"
رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في طريقة الاستدعاء التالية إلى lineItems.list لاسترداد الصفحة التالية من النتائج.