لإنشاء عنصر مجموعة.
طلب
طلب 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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.