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.