حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 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".
معلمة الاتحاد accessor. مطلوب. تحدِّد كيان "مساحة العرض والفيديو 360" الذي يتم تقديم الطلب ضمنه. لن يعرض طلب "القائمة" سوى كيانات الجمهور المُجمَّعة التي يمكن لكيان "مساحة العرض والفيديو 360" المحدّد داخل accessor. يمكن أن يكون accessor واحدًا فقط مما يلي:
رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في طريقة الاستدعاء التالية إلى combinedAudiences.list لاسترداد الصفحة التالية من النتائج.
تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Display & Video 360 API v1 is sunset and this document outlines the specifications for listing combined audiences using the v1 API."],["The API request is a GET request to the specified URL with parameters for pagination, filtering, and sorting results."],["The response returns a list of combined audiences along with a token for retrieving the next page of results, if available."],["Authorization with the 'https://www.googleapis.com/auth/display-video' scope is required to use this API."]]],["This document details how to list combined audiences using the Display & Video 360 API. It uses a `GET` request to `https://displayvideo.googleapis.com/v1/combinedAudiences`. Key parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` for pagination, sorting, and filtering. A required union parameter `accessor` uses either `partnerId` or `advertiserId` to identify the DV360 entity. The empty request body returns a response with `combinedAudiences` and `nextPageToken`. Authorization requires the `https://www.googleapis.com/auth/display-video` scope.\n"]]