Groups: update

تعديل البيانات الوصفية لمجموعة في الوقت الحالي، السمة الوحيدة التي يمكن تعديلها هي عنوان المجموعة. (استخدِم groupItems.insert وgroupItems.delete لإضافة عناصر المجموعة وإزالتها).

الطلب

طلب HTTP

PUT 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.

  • id
  • snippet.title

الرد

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

الأخطاء

لا تحدِّد واجهة برمجة التطبيقات أي رسائل خطأ فريدة لطريقة واجهة برمجة التطبيقات هذه. ومع ذلك، قد تظل هذه الطريقة تعرض أخطاء واجهة برمجة التطبيقات العامة المدرجة في وثائق رسالة الخطأ.

جرّب الآن

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