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