يسرد المواقع في قناة.
طلب HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/channels/{channelId}/sites
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
channelId |
مطلوبة. معرّف القناة الرئيسية التي تنتمي إليها المواقع الإلكترونية المطلوبة. |
معلمة الاتحاد owner . مطلوبة. تحدّد كيان "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. قد يكون إما شريكًا أو معلنًا. يمكن أن يكون الحقل "owner " واحدًا فقط مما يلي: |
|
advertiserId |
رقم تعريف المعلِن الذي يملك القناة الرئيسية. |
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين |
pageToken |
يشير هذا المصطلح إلى رمز مميّز يحدّد صفحة من النتائج التي يجب أن يعرضها الخادم. عادةً ما تكون هذه هي قيمة |
orderBy |
الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي لأحد الحقول، يجب إضافة اللاحقة " الوصف" إلى اسم الحقل. مثال: |
filter |
تسمح بالفلترة حسب حقول الموقع الإلكتروني. البنية المتوافقة:
الحقول المتاحة:
أمثلة:
يجب ألا يزيد طول هذا الحقل عن 500 حرف. يمكنك الرجوع إلى دليل طلبات الفلاتر |
معلمة الاتحاد owner . مطلوبة. تحدّد كيان "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. قد يكون إما شريكًا أو معلنًا. يمكن أن يكون الحقل "owner " واحدًا فقط مما يلي: |
|
partnerId |
رقم تعريف الشريك الذي يملك القناة الرئيسية. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال ListSitesResponse
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.