يسرد خيارات الاستهداف المعينة لمجموعة إعلانية على YouTube.
ولا يتم تضمين خيارات الاستهداف المكتسَبة المعيّنة.
طلب HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/youtubeAdGroups/{youtubeAdGroupId}/targetingTypes/{targetingType}/assignedTargetingOptions
مطلوب. يحدد نوع خيارات الاستهداف المعينة لإدراجها.
تشمل أنواع الاستهداف المتاحة ما يلي:
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_APP
TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AUDIENCE_GROUP
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_GENDER
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_KEYWORD
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_URL
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
معامِلات طلب البحث
المعلمات
pageSize
integer
حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 1 و5000. وفي حال عدم تحديد قيمة، سيتم ضبط القيمة تلقائيًا على "100". تعرض رمز الخطأ INVALID_ARGUMENT إذا تم تحديد قيمة غير صالحة.
pageToken
string
هو رمز مميز يحدد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة nextPageToken التي يتم عرضها من الاستدعاء السابق لطريقة assignedTargetingOptions.list. وفي حال عدم تحديده، سيتم عرض الصفحة الأولى من النتائج.
orderBy
string
الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
assignedTargetingOptionId (تلقائي)
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي للحقل، يجب استخدام اللاحقة "desc" يجب إضافته إلى اسم الحقل. مثال: assignedTargetingOptionId desc
filter
string
تسمح بالتصفية حسب حقول خيارات الاستهداف المعينة.
بنية متوافقة:
تتكون تعبيرات الفلاتر من قيد واحد أو أكثر.
يمكن دمج القيود من خلال عامل التشغيل المنطقي OR.
يكون للقيد {field} {operator} {value}.
يجب أن تستخدم جميع الحقول عامل التشغيل EQUALS (=).
الحقول المسموح بها:
assignedTargetingOptionId
أمثلة:
AssignedTargetingOption موارد برقم التعريف 1 أو 2: assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"
رمز مميز يحدد الصفحة التالية من النتائج. يجب تحديد هذه القيمة على أنّها pageToken في ListYoutubeAdGroupAssignedTargetingOptionsRequest لاحقة لاسترجاع صفحة النتائج التالية. لن يظهر هذا الرمز المميّز إذا لم يعد هناك assignedTargetingOptions للرجوع.