مطلوب. رقم تعريف القناة الرئيسية التي تنتمي إليها المواقع الإلكترونية المطلوبة.
مَعلمة الائتلاف owner. مطلوب. تُحدِّد هذه السمة عنصر "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. ويمكن أن يكون شريكًا أو معلِنًا. يمكن أن يكون owner واحدًا فقط مما يلي:
حجم الصفحة المطلوب يجب أن تتراوح بين 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 واحدًا فقط مما يلي:
تاريخ التعديل الأخير: 2025-02-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-02-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists sites within a given Display & Video 360 channel using a `GET` request."],["Requires specifying the parent channel's ID and the owning partner or advertiser ID."],["Allows filtering and sorting results with query parameters like `filter` and `orderBy`."],["Supports pagination with `pageSize` and `pageToken` to retrieve large result sets."],["Needs authorization with the `https://www.googleapis.com/auth/display-video` scope."]]],["This document outlines how to retrieve a list of sites within a channel using a `GET` HTTP request. The request URL requires `channelId` and either `partnerId` or `advertiserId` as path parameters to specify the owning entity. Query parameters, including `pageSize`, `pageToken`, `orderBy`, and `filter`, allow for result customization. The request body must be empty and requires OAuth 2.0 authorization. A successful response returns a `ListSitesResponse` instance containing the requested sites.\n"]]