Method: sellers.orders.lines.list

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

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

طلب HTTP

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

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

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

المعلمات
parent

string

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

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

المعلمات
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
{
  "lines": [
    {
      object (Line)
    }
  ],
  "nextPageToken": string
}
الحقول
lines[]

object (Line)

تمثّل هذه السمة قائمة الأسطر.

nextPageToken

string

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

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

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

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

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