GroupItems: insert

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

الطلب

طلب HTTP

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

التفويض

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

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

المعلمات

يسرد الجدول التالي المَعلمات التي يتيح طلب البحث استخدامها. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.

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

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

نص الطلب

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

  • groupId
  • resource.id

الرد

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

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

الأخطاء

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

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

جرّب الآن

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