يسرد خيارات الاستهداف المعينة لطلب إدراج.
طلب HTTP
GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
advertiserId |
مطلوبة. رقم تعريف المعلِن الذي ينتمي إليه طلب الإدراج. |
insertionOrderId |
مطلوبة. رقم تعريف طلب الإدراج لإدراج خيارات الاستهداف المحدّدة له. |
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.