Method: advertisers.channels.sites.list

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

طلب HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/channels/{channelId}/sites

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

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

المعلمات
channelId

string (int64 format)

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

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 واحدًا فقط مما يلي:
partnerId

string (int64 format)

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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