يسرد خيارات الاستهداف المعينة لإحدى الحملات لنوع محدّد من الاستهداف.
طلب HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
advertiserId |
مطلوب. رقم تعريف المعلِن الذي تنتمي إليه الحملة |
campaignId |
مطلوب. رقم تعريف الحملة المطلوب إدراج خيارات الاستهداف المعيّنة لها. |
targetingType |
مطلوب. يحدد نوع خيارات الاستهداف المعينة لإدراجها. أنواع الاستهداف المتوافقة:
|
معامِلات طلب البحث
المعلمات | |
---|---|
pageSize |
حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين |
pageToken |
هو رمز مميز يحدد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة |
orderBy |
الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي للحقل، يجب استخدام اللاحقة "desc" يجب إضافته إلى اسم الحقل. مثال: |
filter |
تسمح بالتصفية حسب حقول خيارات الاستهداف المعينة. بنية متوافقة:
الحقول المسموح بها:
أمثلة:
يجب ألا يزيد طول هذا الحقل عن 500 حرف. يُرجى الرجوع إلى دليل طلبات الفلاتر |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة ردّ على assignedTargetingOptions.list
.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"assignedTargetingOptions": [
{
object ( |
الحقول | |
---|---|
assignedTargetingOptions[] |
قائمة خيارات الاستهداف المحدّدة. لن تكون هذه القائمة فارغة إذا كانت فارغة. |
nextPageToken |
رمز مميز يحدد الصفحة التالية من النتائج. يجب تحديد هذه القيمة على أنّها |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.