Groups: insert

تُنشئ مجموعة في "إحصاءات YouTube". بعد إنشاء مجموعة، استخدِم الطريقة groupItems.insert لإضافة عناصر إلى المجموعة.

الطلب

طلب HTTP

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

التفويض

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

المستويات
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.

نص الطلب

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

  • snippet.title
  • contentDetails.itemType

الرد

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

الأخطاء

لا تحدِّد واجهة برمجة التطبيقات أي رسائل خطأ فريدة لطريقة واجهة برمجة التطبيقات هذه. ومع ذلك، قد تؤدي هذه الطريقة إلى عرض أخطاء عامة في واجهة برمجة التطبيقات مُدرَجة في مستندات رسالة الخطأ.

جرّب الآن

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