Videos: update

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

يُرجى العِلم أنّ هذه الطريقة ستلغي القيم الحالية لكل السمات القابلة للتغيير والمضمَّنة في أي أجزاء تحدِّدها قيمة المَعلمة. على سبيل المثال، يتضمّن الجزء 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" الذي يتصرّف نيابةً عن مالك المحتوى المحدَّد في قيمة المَعلمة. هذه المعلمة مخصصة لشركاء المحتوى في 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.
    • 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.