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