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.