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