يسرد خيارات الاستهداف التي تم تعيينها لمجموعة إعلانية على 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 (تلقائي)
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي لأحد الحقول، يجب إضافة اللاحقة "تنازلي" إلى اسم الحقل. مثال: assignedTargetingOptionId desc
filter
string
يسمح بالفلترة حسب حقول خيارات الاستهداف التي تم تعيينها.
البنية المتوافقة:
وتتكون تعبيرات الفلاتر من قيد واحد أو أكثر.
يمكن دمج القيود باستخدام عامل التشغيل المنطقي OR.
يكون نوع القيود كالآتي {field} {operator} {value}.
يجب أن تستخدم جميع الحقول عامل التشغيل EQUALS (=).
الحقول المتاحة:
assignedTargetingOptionId
أمثلة:
AssignedTargetingOption مورد برقم التعريف 1 أو 2: assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"
رمز مميز يحدد الصفحة التالية من النتائج. يجب تحديد هذه القيمة على أنّها pageToken في ListYoutubeAdGroupAssignedTargetingOptionsRequest لاحقة لجلب الصفحة التالية من النتائج. لن يكون هذا الرمز المميّز غير متوفّر إذا لم يكن هناك المزيد من assignedTargetingOptions يمكن عرضه.