Method: exchanges.orders.list

ترتيب القوائم

طلب HTTP

GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/orders

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

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

المعلمات
parent

string

اسم المورد الرئيسي مثال: "exchanges/123". مطلوب.

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

المعلمات
pageSize

integer

الحد الأقصى لعدد العناصر التي سيتم عرضها القيمة التلقائية هي 50. الحد الأقصى المسموح به هو 200. إذا لم يتم تحديد حجم الصفحة، سيكون 50 هو الحجم التلقائي للصفحة. إذا كان pageSize أكبر من 200، سيتم استخدام 200 كحجم الصفحة.

pageToken

string

قيمة nextPageToken التي تم إرجاعها من طلب List سابق، إن توفّر.

filter

string

السماح بالفلترة حسب سمات المنتجات

بنية الجملة المتوافقة:

  • تتألّف عبارات الفلاتر من قيد واحد أو أكثر.
  • يمكن دمج القيود باستخدام عاملَي التشغيل المنطقيَين AND أو OR. تستخدم تسلسل القيود AND بشكل ضمني.
  • يكون التنسيق الخاص بالقيود على النحو التالي: <field> <operator> <value>.
  • يجب أن يكون عامل الحالة وdisplayName هو EQUALS (=).
  • الحقول المتوافقة:
    • OrderStatus
    • DisplayName
    • UpdateTime

أمثلة:

  • الحصول على الطلبات التي تم ضبط حالتها على "مقبولة" status=ACCEPTED

  • الحصول على الطلبات التي تحمل الاسم المعروض "display name" displayName="display name"

  • الحصول على الطلبات التي يكون وقت تعديلها أكبر من "‎2024-02-12T18:47:29.784Z" updateTime>"2024-02-12T18:47:29.784Z"

يجب ألا يزيد طول هذا الحقل عن 500 حرف.

نص الطلب

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

نص الاستجابة

استجابة لترتيب القائمة

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

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

object (Order)

الطلبات المُدرَجة سيكون هناك حدّ أقصى لعدد العناصر التي يتم عرضها استنادًا إلى حقل pageSize في الطلب.

nextPageToken

string

رمز مميز لاسترداد الصفحة التالية من النتائج، أو فارغ إذا لم تتوفّر نتائج أخرى في القائمة

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

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

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

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