Videos: update

تتيح واجهة برمجة التطبيقات الآن إمكانية تصنيف قناتك أو فيديوهاتك على أنّها "محتوى مخصّص للأطفال". بالإضافة إلى ذلك، تحتوي الآن موارد channel وvideo على سمة تحدّد حالة "محتوى مخصّص للأطفال" لتلك القناة أو الفيديو. تم أيضًا تعديل بنود خدمة YouTube API وسياسات المطوّرين في 10 كانون الثاني (يناير) 2020. لمزيد من المعلومات، يُرجى الاطّلاع على سجلّ النُسخ السابقة لخدمة YouTube Data API وبنود خدمة YouTube API.

تعديل البيانات الوصفية لفيديو معيّن

التأثير في الحصة: يتطلّب طلب هذه الطريقة تكلفة حصة تبلغ 50 وحدة.

حالات الاستخدام الشائعة

طلب

طلب HTTP

PUT https://www.googleapis.com/youtube/v3/videos

التفويض

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

النطاق
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

المعلمات

يعرض الجدول التالي المَعلمات التي يتيحها هذا الطلب. جميع المَعلمات المدرَجة هي مَعلمات طلب البحث.

المعلمات
المَعلمات المطلوبة
part	string تخدم المَعلمة part غرضَين في هذه العملية. وتحدّد السمات التي ستضبطها عملية الكتابة والسمات التي سيتضمّنها الردّ من واجهة برمجة التطبيقات. يُرجى العِلم أنّ هذه الطريقة ستلغي القيم الحالية لجميع السمات القابلة للتغيير المضمّنة في أي أجزاء تحدّدها قيمة المَعلمة. على سبيل المثال، يتم تضمين إعدادات خصوصية الفيديو في الجزء status. وبالتالي، إذا كان طلبك يهدف إلى تعديل فيديو خاص، وكانت قيمة المَعلمة part في الطلب تتضمّن الجزء status، سيتم تعديل إعدادات خصوصية الفيديو إلى أي قيمة يحدّدها نص الطلب. إذا لم يحدّد نص الطلب قيمة، ستتم إزالة إعداد الخصوصية الحالي وسيعود الفيديو إلى إعداد الخصوصية التلقائي. بالإضافة إلى ذلك، لا تحتوي بعض الأجزاء على سمات يمكن ضبطها عند إدراج فيديو أو تعديله. على سبيل المثال، يتضمّن العنصر statistics الإحصاءات التي يحتسبها YouTube لفيديو معيّن، ولا يحتوي على قيم يمكنك ضبطها أو تعديلها. إذا كانت قيمة المَعلمة تحدّد part لا يحتوي على قيم قابلة للتغيير، سيظلّ هذا الـ part مضمّنًا في الردّ من واجهة برمجة التطبيقات. تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المَعلمة: brandPartner contentDetails fileDetails id liveStreamingDetails localizations paidProductPlacementDetails player processingDetails recordingDetails snippet statistics status suggestions topicDetails
المَعلمات الاختيارية
onBehalfOfContentOwner	string لا يمكن استخدام هذه المَعلمة إلا في طلب مصرَّح به بشكل صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube. تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض للطلب تحدّد مستخدمًا في نظام إدارة محتوى YouTube يعمل بالنيابة عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون ويديرون العديد من القنوات المختلفة على YouTube. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الفعلي الذي يصادق عليه المستخدم بمالك المحتوى المحدّد على YouTube.

نص الطلب

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

• يجب تحديد قيمة للسمات التالية:

  • id
  • snippet.title: يجب استخدام هذه السمة فقط إذا كان الطلب يحدّث snippet الخاص بمورد video.
  • ‫snippet.categoryId: يجب استخدام هذه السمة فقط إذا كان الطلب يعدّل snippet لمورد video.

• يمكنك ضبط قيم لهذه السمات:

  • snippet.categoryId
  • snippet.defaultLanguage
  • snippet.description
  • snippet.tags[]
  • snippet.title
  • status.embeddable
  • status.license
  • status.privacyStatus
  • status.publicStatsViewable
  • ‫status.publishAt: في حال ضبط قيمة لهذه السمة، يجب أيضًا ضبط السمة status.privacyStatus على private. لا يمكن ضبط هذه السمة إلا إذا كانت حالة خصوصية الفيديو private ولم يسبق نشره.
  • status.selfDeclaredMadeForKids
  • status.containsSyntheticMedia
  • recordingDetails.recordingDate
  • localizations.(key)
  • localizations.(key).title
  • localizations.(key).description

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

الردّ

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

الأخطاء

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

نوع الخطأ	تفاصيل الخطأ	الوصف
badRequest (400)	defaultLanguageNotSet	يحاول طلب البيانات من واجهة برمجة التطبيقات إضافة تفاصيل فيديو معدَّلة بما يناسب السوق المحلية بدون تحديد اللغة التلقائية لتفاصيل الفيديو.
badRequest (400)	invalidCategoryId	تحدّد السمة snippet.categoryId معرّف فئة غير صالح. استخدِم طريقة videoCategories.list لاسترداد الفئات المتوافقة.
badRequest (400)	invalidDefaultBroadcastPrivacySetting	يحاول الطلب ضبط إعداد خصوصية غير صالح للبث التلقائي.
badRequest (400)	invalidDescription	تحدّد البيانات الوصفية للطلب وصفًا غير صالح للفيديو.
badRequest (400)	invalidPublishAt	تحدّد البيانات الوصفية للطلب وقت نشر مجدوَل غير صالح.
badRequest (400)	invalidRecordingDetails	يحدّد العنصر recordingDetails في البيانات الوصفية للطلب تفاصيل تسجيل غير صالحة.
badRequest (400)	invalidTags	تحدّد البيانات الوصفية للطلب كلمات رئيسية غير صالحة للفيديو.
badRequest (400)	invalidTitle	تحدّد البيانات الوصفية للطلب عنوان فيديو غير صالح أو فارغًا.
badRequest (400)	invalidVideoMetadata	البيانات الوصفية للطلب غير صالحة.
forbidden (403)	forbidden
forbidden (403)	forbiddenEmbedSetting	يحاول الطلب ضبط إعداد تضمين غير صالح للفيديو. يُرجى العِلم أنّ بعض القنوات قد لا تملك الإذن بتقديم مشغّلات مضمّنة لأحداث البث المباشر. لمزيد من المعلومات، يُرجى الانتقال إلى مركز مساعدة YouTube.
forbidden (403)	forbiddenLicenseSetting	يحاول الطلب ضبط ترخيص غير صالح للفيديو.
forbidden (403)	forbiddenPrivacySetting	تحاول الطلبات ضبط إعدادات خصوصية غير صالحة للفيديو.
notFound (404)	videoNotFound	تعذّر العثور على الفيديو الذي تحاول تعديله. تحقَّق من قيمة الحقل id في نص الطلب للتأكّد من صحتها.

جرِّبها الآن.

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