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. إذا كان حجم الصفحة أكبر من 200، فسيتم استخدام 200 كحجم للصفحة.

pageToken

string

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

filter

string

يسمح بالتصفية حسب خصائص الطلب.

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

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

أمثلة:

  • الحصول على الطلبات التي تم ضبط حالتها على ACCEPTED 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.