GroupItems: insert

لإنشاء عنصر مجموعة.

طلب

طلب HTTP

POST https://youtubeanalytics.googleapis.com/v2/groupItems

التفويض

ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).

المناظير
https://www.googleapis.com/auth/yt-analytics.readonly عرض تقارير YouTube Analytics للمحتوى في YouTube. يوفر هذا النطاق الوصول إلى مقاييس نشاط المستخدم، مثل عدد المشاهدات وأعداد التقييمات.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly عرض تقارير YouTube Analytics المالية للمحتوى في YouTube. ويوفّر هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدم وإلى مقاييس الأرباح وأداء الإعلان المقدّرة.
https://www.googleapis.com/auth/youtube إدارة حسابك في YouTube. في واجهة برمجة تطبيقات YouTube Analytics، يستخدم مالكو القنوات هذا النطاق لإدارة مجموعات ومجموعات YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner عرض وإدارة مواد عرض YouTube والمحتوى المرتبط بها على YouTube. في YouTube Analytics API، يستخدم مالكو المحتوى هذا النطاق لإدارة مجموعات YouTube Analytics وعناصر المجموعات.

المعلَمات

يسرد الجدول أدناه المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.

المعلَمات
المعلّمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المعلّمة إلا في طلب مفوَّض بشكلٍ سليم. ملاحظة: إنّ هذه المعلّمة مخصّصة حصريًا لشركاء المحتوى في YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة.

تشير المعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد تفويض الطلب تحدد مستخدم YouTube الذي يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المعلّمة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى كل بيانات الفيديو والقناة بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. ويجب أن يكون الحساب الذي يجري المستخدم المصادقة عليه مرتبطًا بمالك المحتوى المحدد على YouTube.

نص الطلب

قدِّم مورد itemitem في نص الطلب. بالنسبة إلى هذا المورد، يجب تحديد قيمة للخصائص التالية.

  • groupId
  • resource.id

الإجابة

إذا تم إدراج العنصر بنجاح، ستعرض هذه الطريقة مورد groupItem في نص الاستجابة.

إذا كان العنصر المحدد في الطلب قد تم تضمينه من قبل في المجموعة قبل تقديم الطلب، ستعرض هذه الطريقة رمز استجابة HTTP 204 (No Content).

الأخطاء

يحدد الجدول أدناه رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) groupContainsMaximumNumberOfItems تحتوي المجموعة بالفعل على أقصى عدد مسموح به من العناصر.

جرِّب هذه الميزة الآن.

يمكنك استخدام APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.