LiveStreams: update

تعديل مصدر بيانات فيديو إذا تعذّر تعديل السمات التي تريد تغييرها، عليك إنشاء بث جديد باستخدام الإعدادات المناسبة.

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

الطلب

طلب HTTP

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

التفويض

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

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

المعلمات

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

المعلمات
المَعلمات المطلوبة
part string
تخدم المَعلمة part غرضَين في هذه العملية. ويحدِّد هذا الإجراء السمات التي ستضبطها عملية الكتابة بالإضافة إلى السمات التي سيتضمّنها ردّ واجهة برمجة التطبيقات.

السمات part التي يمكنك تضمينها في قيمة المَعلمة هي id وsnippet وcdn وstatus.

تجدر الإشارة إلى أنّ هذه الطريقة ستلغي القيم الحالية لجميع السمات القابلة للتغيير والمضمّنة في أي أجزاء تحدّدها قيمة المَعلمة. إذا لم يحدّد نص الطلب قيمة لسمة قابلة للتغيير، ستتم إزالة القيمة الحالية لهذه السمة.
المَعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلّا في طلب مفوَّض بشكل صحيح.

ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.
تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض للطلب تحدّد مستخدمًا في نظام إدارة المحتوى في YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون ويديرون العديد من القنوات المختلفة على YouTube. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب أن يكون حساب نظام إدارة المحتوى الذي يستخدمه المستخدم لمصادقته مرتبطًا بحساب مالك المحتوى المحدّد على YouTube.
onBehalfOfContentOwnerChannel string
لا يمكن استخدام هذه المَعلمة إلا في طلب مفوَّض بشكل صحيح.

ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.
تحدّد المَعلمة onBehalfOfContentOwnerChannel معرّف قناة YouTube التي تتم إضافة الفيديو إليها. تكون هذه المَعلمة مطلوبة عندما يحدّد الطلب قيمة للمَعلمة onBehalfOfContentOwner، ولا يمكن استخدامها إلا مع هذه المَعلمة. بالإضافة إلى ذلك، يجب تفويض الطلب باستخدام حساب على نظام إدارة المحتوى (CMS) مرتبط بمالك المحتوى الذي تحدّده المَعلمة onBehalfOfContentOwner. أخيرًا، يجب أن تكون القناة التي تحدّدها قيمة المَعلمة onBehalfOfContentOwnerChannel مرتبطة بمالك المحتوى الذي تحدّده المَعلمة onBehalfOfContentOwner.

هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة. ويسمح هذا الإجراء لمالكي المحتوى بالمصادقة مرة واحدة وتنفيذ الإجراءات نيابةً عن القناة المحدّدة في قيمة المَعلمة، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة منفصلة.

نص الطلب

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

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

    • id
    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

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

    • snippet.title
    • snippet.description

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

الرد

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

الأخطاء

يحدِّد الجدول التالي رسائل الخطأ التي يمكن أن تعرِضها واجهة برمجة التطبيقات استجابةً لطلب موجَّه إلى هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على YouTube Live Streaming API - Errors.

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) liveStreamModificationNotAllowed لا يمكن تعديل البث المباشر المحدّد بحالته الحالية. لمزيد من المعلومات، يُرجى الاطّلاع على مدة عرض البث.
forbidden (403) liveStreamModificationNotAllowed لا تسمح لك واجهة برمجة التطبيقات بتغيير قيمة الحقول cdn.format أو cdn.frameRate أو cdn.ingestionType أو cdn.resolution بعد إنشاء البث.
forbidden (403) liveStreamModificationNotAllowed لا تسمح لك واجهة برمجة التطبيقات بتغيير بث قابل لإعادة الاستخدام إلى بث غير قابل لإعادة الاستخدام أو العكس. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على البث المباشر والبث.
insufficientPermissions insufficientLivePermissions الطلب غير مصرّح له بتعديل البث المباشر المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تنفيذ مصادقة OAuth2.
insufficientPermissions liveStreamingNotEnabled المستخدم الذي فوّض الطلب غير مفعّل له بث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات في مقالة الأهلية لاستخدام الميزات.
invalidValue (400) invalidDescription يمكن أن تتألف قيمة السمة snippet.description في مورد liveStream من 10,000 حرف كحد أقصى.
invalidValue (400) invalidTitle يجب أن يتراوح طول قيمة السمة snippet.title في مورد liveStream بين 1 و128 حرفًا.
notFound (404) liveStreamNotFound البث المباشر المحدّد غير متوفّر.
required (400) idRequired يجب أن يحدّد مورد البث المباشر قيمة للسمة id.
required (400) ingestionTypeRequired يجب أن يحدّد مورد البث المباشر قيمة للسمة cdn.ingestionType.
required (400) titleRequired يجب أن يحدّد مورد البث المباشر قيمة للسمة snippet.title.

جرّب الآن

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