Method: exchanges.auctionPackages.list

تعرض هذه الطريقة حِزم المزادات.

طلب HTTP

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

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

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

المعلمات
parent

string

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

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

المعلمات
pageSize

integer

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

string

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

string

اختياريّ. تتيح الفلترة حسب المواقع.

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

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

أمثلة:

  • الحصول على حِزم المزادات مع ضبط externalDealId على "package-1234" externalDealId="package-1234"

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

نص الطلب

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

نص الاستجابة

ردّ لعرض حِزم المزاد

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

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

object (AuctionPackage)

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

string

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

نطاقات الأذونات

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

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

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