حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 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"
تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists sites associated with a given channel within a Display & Video 360 partner."],["Supports pagination and filtering to refine the list of sites retrieved."],["Requires authorization with the `https://www.googleapis.com/auth/display-video` scope."],["Provides details such as site URL or app ID, along with navigation for accessing subsequent pages of results."]]],["This document outlines the process for listing sites within a channel using the Display & Video 360 API. To list sites, a `GET` request is sent to a specific URL, including `partnerId` and `channelId` as path parameters. Optional query parameters like `pageSize`, `pageToken`, `orderBy`, `filter`, and `advertiserId` can be used to refine the search. The request body must be empty, and the successful response is a `ListSitesResponse` instance. Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"]]