حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 1 و200. وفي حال عدم تحديد قيمة، سيتم ضبط القيمة تلقائيًا على "100". تعرض رمز الخطأ INVALID_ARGUMENT إذا تم تحديد قيمة غير صالحة.
pageToken
string
هو رمز مميز يحدد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة nextPageToken التي يتم عرضها من الاستدعاء السابق لطريقة customLists.list. وفي حال عدم تحديده، سيتم عرض الصفحة الأولى من النتائج.
orderBy
string
الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
customListId (تلقائي)
displayName
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي للحقل، يجب استخدام اللاحقة "desc" يجب إضافته إلى اسم الحقل. مثال: displayName desc
filter
string
تسمح بالفلترة حسب حقول القوائم المخصَّصة.
بنية متوافقة:
لا يمكن أن تحتوي تعبيرات الفلاتر للقوائم المخصّصة على أكثر من قيد واحد.
يكون للقيد {field} {operator} {value}.
يجب أن تستخدم جميع الحقول عامل التشغيل HAS (:).
الحقول المسموح بها:
displayName
أمثلة:
جميع القوائم المخصّصة التي يحتوي الاسم المعروض عليها على "Google": displayName:"Google"
معلمة الاتحاد accessor. مطلوب. تحدِّد كيان "مساحة العرض والفيديو 360" الذي يتم تقديم الطلب ضمنه. لن يعرض طلب "القائمة" سوى كيانات القوائم المخصّصة التي يمكن لكيان "مساحة العرض والفيديو 360" المحدّد داخل accessor. يمكن أن يكون accessor واحدًا فقط مما يلي:
رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في طريقة الاستدعاء التالية إلى customLists.list لاسترداد الصفحة التالية من النتائج.