Method: sellers.availabilityOrders.availabilityLines.list

يسرد سطورًا لطلب مدى التوفّر.

  • على سبيل المثال GET /v1/sellers/111/availabilityOrders/123/availabilityLines
  • تعرض قائمة أسطر مدى التوفّر ورمزًا مميزًا لاسترداد الصفحة التالية في حال نجاحها.
  • تعرض رمز الخطأ PERMISSION_DENIED إذا لم يكن لدى المستخدم إذن الوصول إلى البائع أو رقم تعريف البائع غير متوفّر.
  • تعرض رمز الخطأ INVALID_ARGUMENT إذا قدم البائعون حجم صفحة أو رمزًا غير صالح للصفحة.
  • تعرض رمز الخطأ NOT_FOUND إذا كان طلب مدى التوفّر غير متوفّر.

طلب HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*/availabilityOrders/*}/availabilityLines

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. اسم المورد الرئيسي. التنسيق: Sellers/{seller}/availabilityOrders/{availability_order}

معامِلات طلب البحث

المعلمات
pageSize

integer

تمثّل هذه السمة الحد الأقصى لعدد السلع المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى المسموح به لعدد سطور مدى التوفّر هو 1,000. وفي حال عدم تحديده، سيتم عرض 1, 000 سطر مدى التوفّر كحدّ أقصى.
pageToken

string

قيمة NextPageToken التي يتم عرضها من طلب قائمة سابق، إن وجد.
filter

string

فلتر القائمة. تتيح حاليًا فلترة الحالة باستخدام الصيغة: "state = [state]". يمكن استخدام العوامل المنطقية AND وOR لسلسلة الفلاتر.
orderBy

string

الترتيب حسب السلسلة المستخدم لتحديد نظام ترتيب النتائج. يمكن حاليًا إجراء الطلب حسب updateTime. يجب إدخال قيمة "updateTime". لترتيب النتائج تصاعديًا حسب updateTime، أو "updateTime desc" بترتيب تنازلي.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "availabilityLines": [
    {
      object (AvailabilityLine)
    }
  ],
  "nextPageToken": string
}
الحقول
availabilityLines[]

object (AvailabilityLine)

تمثّل هذه السمة قائمة أسطر مدى التوفّر.
nextPageToken

string

رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في طريقة الاستدعاء التالية إلى availabilityLines.list لاسترداد الصفحة التالية من النتائج.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/doubleclickbidmanager

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.