Method: sellers.availabilityOrders.list

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

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

طلب HTTP

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

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

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

المعلمات
parent

string

مطلوب. أحد الوالدَين الذي يملك مجموعة طلبات التوفّر هذه التنسيق: seller/{seller}

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

المعلمات
pageSize

integer

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

string

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

string

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

string

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

نص الطلب

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

نص الاستجابة

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

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

object (AvailabilityOrder)

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

string

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

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

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

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

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