LiveStreams: update

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

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

الطلب

طلب HTTP

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

التفويض

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

النطاق
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

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

الإجابة

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

الأخطاء

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

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

تجربة

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