Method: advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions

تعمل على إدراج خيارات الاستهداف المعيّنة لمجموعات إعلانية متعددة على مستوى أنواع الاستهداف.

لا يتم تضمين خيارات الاستهداف المكتسبة والمخصصة.

طلب HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/adGroups:bulkListAdGroupAssignedTargetingOptions

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
advertiserId

string (int64 format)

مطلوبة. رقم تعريف المعلِن الذي تنتمي إليه العناصر.

معلمات طلب البحث

المَعلمات
adGroupIds[]

string (int64 format)

مطلوبة. أرقام تعريف المجموعات الإعلانية المراد إدراج خيارات الاستهداف المعينة لها.
pageSize

integer

اختياريّ. حجم الصفحة المطلوب. يجب أن يكون المقاس عددًا صحيحًا بين 1 و5000. في حال عدم تحديد قيمة، ستكون القيمة التلقائية 5000. تعرض رمز الخطأ INVALID_ARGUMENT إذا تم تحديد قيمة غير صالحة.
pageToken

string

اختياريّ. رمز مميز يتيح للعميل جلب الصفحة التالية من النتائج عادةً ما تكون هذه هي قيمة nextPageToken التي تم إرجاعها من الاستدعاء السابق إلى طريقة adGroups.bulkListAdGroupAssignedTargetingOptions. إذا لم يتم تحديد ذلك، سيتم عرض الصفحة الأولى من النتائج.
orderBy

string

اختياريّ. الحقل الذي سيتم ترتيب القائمة بناءً عليه. القيم المقبولة هي:

  • adGroupId (تلقائي)
  • assignedTargetingOption.targetingType

يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي لأحد الحقول، يجب إضافة اللاحقة "desc" إلى اسم الحقل. مثال: targetingType desc
filter

string

اختياريّ. يسمح بالتصفية حسب حقول خيارات الاستهداف المعينة.

البنية المتوافقة:

  • تتألف تعبيرات الفلترة من قيد واحد أو أكثر.
  • يمكن دمج القيود باستخدام عامل التشغيل المنطقي OR.
  • ويكون للقيود الشكل {field} {operator} {value}.
  • يجب أن تستخدم جميع الحقول عامل التشغيل EQUALS (=).

الحقول المتاحة:

  • targetingType

أمثلة:

  • AssignedTargetingOption مورد من نوع الاستهداف TARGETING_TYPE_YOUTUBE_VIDEO أو TARGETING_TYPE_YOUTUBE_CHANNEL: targetingType="TARGETING_TYPE_YOUTUBE_VIDEO" OR targetingType="TARGETING_TYPE_YOUTUBE_CHANNEL"

يجب ألا يزيد طول هذا الحقل عن 500 حرف.

يمكنك الرجوع إلى دليل طلبات LIST للفلترة للحصول على مزيد من المعلومات.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "adGroupAssignedTargetingOptions": [
    {
      object (AdGroupAssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
الحقول
adGroupAssignedTargetingOptions[]

object (AdGroupAssignedTargetingOption)

قائمة كائنات التضمين، التي يوفر كل منها خيار استهداف مُعيَّنًا والمجموعة الإعلانية التي تم تعيينه إليها.

لن يتم ملء هذه القائمة إذا كانت فارغة.
nextPageToken

string

رمز مميز يحدد الصفحة التالية من النتائج. يجب تحديد هذه القيمة على أنّها pageToken في استدعاء لاحق إلى adGroups.bulkListAdGroupAssignedTargetingOptions لجلب الصفحة التالية من النتائج. لن يظهر هذا الرمز المميّز في حال عدم توفّر موارد AdGroupAssignedTargetingOption أخرى يمكن عرضها.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/display-video

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

AdGroupAssignedTargetingOption

عنصر التفاف يربط مورد AssignedTargetingOption والمجموعة الإعلانية التي تم تعيينه إليها.

تمثيل JSON 
{
  "adGroupId": string,
  "assignedTargetingOption": {
    object (AssignedTargetingOption)
  }
}
الحقول
adGroupId

string (int64 format)

رقم تعريف المجموعة الإعلانية التي تمّ تعيين خيار الاستهداف المعيّن إليها.
assignedTargetingOption

object (AssignedTargetingOption)

مورد خيار الاستهداف المعيَّن