- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- YoutubeAdGroupAssignedTargetingOption
- جرِّبه الآن
يسرد خيارات الاستهداف التي تم تعيينها لمجموعات إعلانية متعددة على YouTube عبر أنواع الاستهداف.
لا يتم تضمين خيارات الاستهداف المعيّنة والمكتسَبة.
طلب HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/youtubeAdGroups:bulkListAdGroupAssignedTargetingOptions
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
advertiserId |
مطلوبة. رقم تعريف المعلن الذي تنتمي إليه العناصر. |
معلمات طلب البحث
المَعلمات | |
---|---|
youtubeAdGroupIds[] |
مطلوبة. أرقام تعريف المجموعات الإعلانية على YouTube المطلوب إدراج خيارات الاستهداف المعينة لها. |
pageSize |
اختياريّ. حجم الصفحة المطلوب. يجب أن يكون الحجم عددًا صحيحًا يتراوح بين |
pageToken |
اختياريّ. رمز مميز يتيح للعميل جلب الصفحة التالية من النتائج عادةً ما تكون هذه هي قيمة |
orderBy |
اختياريّ. الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي لأحد الحقول، يجب إضافة اللاحقة "تنازلي" إلى اسم الحقل. مثال: |
filter |
اختياريّ. يسمح بالفلترة حسب حقول خيارات الاستهداف التي تم تعيينها. البنية المتوافقة:
الحقول المتاحة:
أمثلة:
يجب ألا يزيد طول هذا الحقل عن 500 حرف. يمكنك الرجوع إلى دليل طلبات الفلاتر |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"youtubeAdGroupAssignedTargetingOptions": [
{
object ( |
الحقول | |
---|---|
youtubeAdGroupAssignedTargetingOptions[] |
قائمة كائنات الالتفاف، ويوفّر كل منها خيار استهداف معيّنًا والمجموعة الإعلانية على YouTube التي تمّ تعيينه إليها. لن يتم إدخال هذه القائمة إذا كانت فارغة. |
nextPageToken |
رمز مميز يحدد الصفحة التالية من النتائج. يجب تحديد هذه القيمة على أنّها |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
YoutubeAdGroupAssignedTargetingOption
عنصر التفاف يربط بين مورد "AssignedTargetingOption
" والمجموعة الإعلانية على YouTube التي تم تعيينه لها.
تمثيل JSON |
---|
{
"youtubeAdGroupId": string,
"assignedTargetingOption": {
object ( |
الحقول | |
---|---|
youtubeAdGroupId |
رقم تعريف المجموعة الإعلانية على YouTube التي تم تعيين خيار الاستهداف المعيّن لها. |
assignedTargetingOption |
مورد خيار الاستهداف المعيَّن. |