Videos: update

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

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

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

تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض في الطلب تحدّد مستخدمًا في نظام إدارة المحتوى في YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على 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
    • 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.