حجم الصفحة المطلوب يجب أن تتراوح بين 1 و200. إذا لم يتم تحديد قيمة، سيتم ضبطها تلقائيًا على 100. تُعرِض رمز الخطأ INVALID_ARGUMENT في حال تحديد قيمة غير صالحة.
pageToken
string
رمز مميّز يحدِّد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة nextPageToken التي تم إرجاعها من الطلب السابق لاستخدام طريقة combinedAudiences.list. إذا لم يتم تحديدها، سيتم عرض الصفحة الأولى من النتائج.
orderBy
string
الحقل الذي يتم ترتيب القائمة حسبه القيم المقبولة هي:
combinedAudienceId (تلقائي)
displayName
يكون ترتيب الفرز التلقائي تصاعديًا. لتحديد الترتيب التنازلي لحقل معيّن، يجب إضافة اللاحقة "desc" إلى اسم الحقل. مثال: displayName desc
filter
string
السماح بالفلترة حسب حقول الجمهور المجمّع
بنية الجملة المتوافقة:
لا يمكن أن تحتوي تعبيرات الفلترة لشرائح الجمهور المجمّعة إلا على قيد واحد كحد أقصى.
يكون قيد المحتوى على شكل {field} {operator} {value}.
يجب أن تستخدم جميع الحقول عامل التشغيل HAS (:).
الحقول المتوافقة:
displayName
أمثلة:
جميع شرائح الجمهور المجمّعة التي يحتوي اسمها المعروض على "Google": displayName : "Google".
يجب ألا يزيد طول هذا الحقل عن 500 حرف.
يُرجى الرجوع إلى دليل طلبات فلترة LIST للحصول على مزيد من المعلومات.
مَعلمة الائتلاف accessor. مطلوب. لتحديد كيان "مساحة العرض والفيديو 360" الذي يتم تقديم الطلب من خلاله. لن يعرض طلب LIST سوى عناصر الجمهور المجمّعة التي يمكن الوصول إليها من خلال عنصر "مساحة العرض والفيديو 360" المحدّد في accessor. يمكن أن يكون accessor واحدًا فقط مما يلي:
رمز مميّز لاسترداد الصفحة التالية من النتائج نقْل هذه القيمة في حقل pageToken في الطلب اللاحق لطريقة combinedAudiences.list لاسترداد الصفحة التالية من النتائج.
تاريخ التعديل الأخير: 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 combined audiences accessible to a specified DV360 entity, ordered by `combinedAudienceId` by default."],["Allows filtering and pagination using query parameters such as `filter`, `orderBy`, `pageSize`, and `pageToken`."],["Requires authorization with the `https://www.googleapis.com/auth/display-video` scope."],["Returns a list of combined audiences and a token for retrieving subsequent pages, if available."],["The request body must be empty for this `GET` request to the endpoint `https://displayvideo.googleapis.com/v3/combinedAudiences`."]]],["This document outlines how to list combined audiences via an HTTP GET request to `https://displayvideo.googleapis.com/v3/combinedAudiences`. Key actions involve using query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` to refine the results. A required parameter of `partnerId` or `advertiserId` is needed for access. The response body includes an array of `combinedAudiences` and a `nextPageToken` for pagination. The request body must be empty, and authorization requires the `https://www.googleapis.com/auth/display-video` scope.\n"]]