Method: advertisers.channels.list

تعرض هذه السمة قنوات شريك أو معلن.

طلب HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/channels

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

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

المعلمات
الحقل مطلوب. تحدّد هذه السمة عنصر "مساحة العرض والفيديو 360" الذي يملك القنوات. ويمكن أن يكون شريكًا أو معلنًا. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
advertiserId

string (int64 format)

رقم تعريف المعلِن الذي يملك القنوات

نهاية الحقول التي يستبعد كلّ منها الآخر

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

المعلمات
pageSize

integer

حجم الصفحة المطلوب يجب أن تتراوح القيمة بين 1 و200. إذا لم يتم تحديدها، سيتم ضبط القيمة التلقائية على 100. تعرِض رمز الخطأ INVALID_ARGUMENT في حال تحديد قيمة غير صالحة.

pageToken

string

رمز مميز يحدّد صفحة من النتائج التي يجب أن يعرضها الخادم. عادةً ما تكون هذه القيمة هي قيمة nextPageToken التي تم عرضها من الطلب السابق إلى طريقة channels.list. إذا لم يتم تحديدها، سيتم عرض الصفحة الأولى من النتائج.

orderBy

string

الحقل الذي سيتم ترتيب القائمة حسبه القيم المقبولة هي:

  • displayName (تلقائي)
  • channelId

يكون ترتيب الفرز التلقائي تصاعديًا. لتحديد ترتيب تنازلي لحقل معيّن، يجب إضافة اللاحقة " desc" إلى اسم الحقل. مثال: displayName desc

filter

string

تسمح هذه السمة بالفلترة حسب حقول القناة.

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

  • يمكن أن تحتوي عبارات الفلتر الخاصة بالقناة على قيد واحد كحدّ أقصى.
  • يكون الحظر على شكل {field} {operator} {value}.
  • يجب أن تستخدم جميع الحقول عامل التشغيل HAS (:).

الحقول المتوافقة:

  • displayName

أمثلة:

  • جميع القنوات التي يتضمّن الاسم المعروض فيها كلمة "google": displayName : "google"

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

لمزيد من المعلومات، يُرجى الرجوع إلى دليل طلبات LIST الفلترة.

الحقل مطلوب. تحدّد هذه السمة عنصر "مساحة العرض والفيديو 360" الذي يملك القنوات. ويمكن أن يكون شريكًا أو معلنًا. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
partnerId

string (int64 format)

رقم تعريف الشريك الذي يملك القنوات

نهاية الحقول التي يستبعد كلّ منها الآخر

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال ListChannelsResponse.

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

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

  • https://www.googleapis.com/auth/display-video

لمزيد من المعلومات، راجِع OAuth 2.0 Overview.