- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- YoutubeAdGroupAssignedTargetingOption
- جرِّبه الآن
يسرد خيارات الاستهداف المعيّنة لمجموعات إعلانية متعددة على YouTube على مستوى أنواع الاستهداف المختلفة.
ولا يتم تضمين خيارات الاستهداف المكتسَبة المعيّنة.
طلب HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/youtubeAdGroups:bulkListAdGroupAssignedTargetingOptions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
advertiserId |
مطلوب. رقم تعريف المعلِن الذي تنتمي إليه العناصر |
معامِلات طلب البحث
المعلمات | |
---|---|
youtubeAdGroupIds[] |
مطلوب. أرقام تعريف المجموعات الإعلانية على YouTube المطلوب سرد خيارات الاستهداف المعيّنة لها. |
pageSize |
اختياريّ. حجم الصفحة المطلوب. يجب أن يكون الحجم عددًا صحيحًا بين |
pageToken |
اختياريّ. هو رمز مميز يتيح للعميل جلب صفحة النتائج التالية. وعادةً ما تكون هذه هي قيمة |
orderBy |
اختياريّ. الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي للحقل، يجب استخدام اللاحقة "desc" يجب إضافته إلى اسم الحقل. مثال: |
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 |
مورد خيار الاستهداف المعيّن. |