العرض سيتم إيقاف الإصدار 2 من Video 360 API نهائيًا في
3 أيلول (سبتمبر) 2024 . ويجب
نقل البيانات إلى الإصدار 3 قبل ذلك التاريخ لتجنُّب انقطاع الخدمة.
إرسال ملاحظات
Method: advertisers.lineItems.targetingTypes.assignedTargetingOptions.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الشبكة الإعلانية إيقاف الإصدار الثاني من واجهة برمجة التطبيقات Video 360 API نهائيًا وسيتم إيقافه نهائيًا
في 3 سبتمبر 2024 . لمساعدتك في نقل البيانات إلى الإصدار 3، يُرجى الاطّلاع على دليل نقل البيانات .
يسرد خيارات الاستهداف المعيّنة لعنصر.
طلب HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions
يستخدِم عنوان URL بنية تحويل ترميز gRPC .
مَعلمات المسار
المعلمات
advertiserId
string (int64 format)
مطلوب. رقم تعريف المعلِن الذي ينتمي إليه العنصر
lineItemId
string (int64 format)
مطلوب. رقم تعريف العنصر المطلوب سرد خيارات الاستهداف المعيّنة له.
targetingType
enum (TargetingType
)
مطلوب. يحدد نوع خيارات الاستهداف المعينة لإدراجها.
تشمل أنواع الاستهداف المتاحة ما يلي:
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_APP
TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AUDIENCE_GROUP
TARGETING_TYPE_AUDIO_CONTENT_TYPE
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
TARGETING_TYPE_BROWSER
TARGETING_TYPE_BUSINESS_CHAIN
TARGETING_TYPE_CARRIER_AND_ISP
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_CHANNEL
TARGETING_TYPE_CONTENT_DURATION
TARGETING_TYPE_CONTENT_GENRE
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_CONTENT_STREAM_TYPE
TARGETING_TYPE_DAY_AND_TIME
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_INVENTORY_SOURCE
TARGETING_TYPE_INVENTORY_SOURCE_GROUP
TARGETING_TYPE_KEYWORD
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
TARGETING_TYPE_OMID
TARGETING_TYPE_ON_SCREEN_POSITION
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_POI
TARGETING_TYPE_PROXIMITY_LOCATION_LIST
TARGETING_TYPE_REGIONAL_LOCATION_LIST
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_SUB_EXCHANGE
TARGETING_TYPE_THIRD_PARTY_VERIFIER
TARGETING_TYPE_URL
TARGETING_TYPE_USER_REWARDED_CONTENT
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_VIEWABILITY
TARGETING_TYPE_YOUTUBE_CHANNEL
(لعنصرَين (LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
) فقط)
TARGETING_TYPE_YOUTUBE_VIDEO
(لعنصرَين (LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
) فقط)
معامِلات طلب البحث
المعلمات
pageSize
integer
حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 1
و5000
. وفي حال عدم تحديد قيمة، سيتم ضبط القيمة تلقائيًا على "100
". تعرض رمز الخطأ INVALID_ARGUMENT
إذا تم تحديد قيمة غير صالحة.
pageToken
string
هو رمز مميز يحدد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة nextPageToken
التي يتم عرضها من الاستدعاء السابق لطريقة assignedTargetingOptions.list
. وفي حال عدم تحديده، سيتم عرض الصفحة الأولى من النتائج.
orderBy
string
الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
assignedTargetingOptionId
(تلقائي)
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي للحقل، يجب استخدام اللاحقة "desc" يجب إضافته إلى اسم الحقل. مثال: assignedTargetingOptionId desc
filter
string
تسمح بالتصفية حسب حقول خيارات الاستهداف المعينة.
بنية متوافقة:
تتكون تعبيرات الفلاتر من قيد واحد أو أكثر.
يمكن دمج القيود من خلال عامل التشغيل المنطقي OR
.
يكون للقيد {field} {operator} {value}
.
يجب أن تستخدم جميع الحقول عامل التشغيل EQUALS (=)
.
الحقول المسموح بها:
assignedTargetingOptionId
inheritance
أمثلة:
AssignedTargetingOption
موارد برقم التعريف 1 أو 2: assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"
AssignedTargetingOption
مورد بحالة الاكتساب NOT_INHERITED
أو INHERITED_FROM_PARTNER
: inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"
يجب ألا يزيد طول هذا الحقل عن 500 حرف.
يُرجى الرجوع إلى دليل طلبات الفلاتر LIST
للحصول على مزيد من المعلومات.
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة ردّ على assignedTargetingOptions.list
.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
الحقول
assignedTargetingOptions[]
object (AssignedTargetingOption
)
قائمة خيارات الاستهداف المحدّدة.
لن تكون هذه القائمة فارغة إذا كانت فارغة.
nextPageToken
string
رمز مميز يحدد الصفحة التالية من النتائج. يجب تحديد هذه القيمة على أنّها pageToken
في ListLineItemAssignedTargetingOptionsRequest
لاحقة لاسترجاع صفحة النتائج التالية. لن يكون هذا الرمز المميّز متاحًا إذا لم يعد هناك assignedTargetingOptions
للرجوع.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0 .
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
هل تريد مشاركة ملاحظاتك معنا؟
{
"lastModified": "تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)",
"confidential": False
}