Method: sellers.orders.list

يسرد الطلبات.

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

طلب HTTP

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

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

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

المعلمات
parent

string

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

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

المعلمات
pageSize

integer

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

string

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

string

فلتر القائمة. تتيح هذه السياسة حاليًا الفلترة مع المعرِّفات الخارجية والحالة، باستخدام البنية: "externalId = [EXTERNAL_ID]". و"الولاية = [state]". يمكن استخدام العوامل المنطقية AND وOR لسلسلة الفلاتر.
orderBy

string

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

نص الطلب

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

نص الاستجابة

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

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

object (Order)

قائمة الطلبات.
nextPageToken

string

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

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

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

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

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