Method: partners.channels.sites.list

يُدرج المواقع الإلكترونية في قناة.

طلب HTTP

GET https://displayvideo.googleapis.com/v3/partners/{partnerId}/channels/{channelId}/sites

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

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

المعلمات
channelId

string (int64 format)

مطلوب. رقم تعريف القناة الرئيسية التي تنتمي إليها المواقع الإلكترونية المطلوبة
مَعلمة الائتلاف owner. مطلوب. تُحدِّد هذه السمة عنصر "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. ويمكن أن يكون شريكًا أو معلِنًا. يمكن أن يكون owner واحدًا فقط مما يلي:
partnerId

string (int64 format)

معرّف الشريك الذي يملك القناة الرئيسية

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

المعلمات
pageSize

integer

حجم الصفحة المطلوب يجب أن تتراوح بين 1 و10000. وفي حال عدم تحديد قيمة، سيتم ضبط القيمة تلقائيًا على "100". تُعرِض رمز الخطأ INVALID_ARGUMENT في حال تحديد قيمة غير صالحة.
pageToken

string

هو رمز مميز يحدد صفحة من النتائج التي يجب أن يعرضها الخادم.

وعادةً ما تكون هذه هي قيمة nextPageToken التي يتم عرضها من الاستدعاء السابق لطريقة sites.list. وفي حال عدم تحديده، سيتم عرض الصفحة الأولى من النتائج.
orderBy

string

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

  • urlOrAppId (تلقائي)

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

string

السماح بالفلترة حسب حقول الموقع الإلكتروني

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

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

الحقول المسموح بها:

  • urlOrAppId

أمثلة:

  • جميع المواقع الإلكترونية التي يتضمّن عنوان URL أو رقم تعريف التطبيق فيها "google": urlOrAppId : "google"

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

يمكنك الرجوع إلى دليل طلبات فلترة LIST للحصول على مزيد من المعلومات.
معلمة الاتحاد owner. مطلوب. تُحدِّد هذه السمة عنصر "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. ويمكن أن يكون شريكًا أو معلِنًا. يمكن أن يكون owner واحدًا فقط مما يلي:
advertiserId

string (int64 format)

رقم تعريف المعلِن الذي يملك القناة الرئيسية

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

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

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