Method: exchanges.publishers.list

تعرض هذه السمة قائمة بالناشرين.

طلب HTTP

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

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

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

المعلمات
parent

string

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

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

المعلمات
pageSize

integer

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

string

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

string

اختياريّ. تتيح الفلترة حسب خصائص الناشر.

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

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

أمثلة:

  • الحصول على الناشرين الذين تم ضبط حالتهم على "نشط" status=DISCOVERY_OBJECT_STATUS_ACTIVE

  • الحصول على الناشرين الذين يحملون الاسم المعروض display name displayName="display name"

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

نص الطلب

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

نص الاستجابة

الردّ على ناشري القوائم

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

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

object (Publisher)

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

string

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

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

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

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

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