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 التي يمكنك تضمينها في قيمة المَعلمة:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
المعلّمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المعلّمة إلا في طلب مفوَّض بشكلٍ سليم. ملاحظة: هذه المعلمة مخصصة حصريًا لشركاء محتوى YouTube.

تشير المعلمة onBehalfOfContentOwner إلى أن بيانات اعتماد تفويض الطلب تحدد مستخدم YouTube CMS الذي يتصرف نيابةً عن مالك المحتوى المحدد في قيمة المعلمة. هذه المعلمة مخصصة لشركاء محتوى YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى كل بيانات الفيديو والقناة بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب CMS الفعلي الذي يصادق المستخدم معه بمالك محتوى 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.
    • status.selfDeclaredMadeForKids
    • recordingDetails.locationDescription (متوقف)
    • recordingDetails.location.latitude (متوقف)
    • recordingDetails.location.longitude (متوقف)
    • 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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.