LiveStreams: insert

تنشئ هذه السمة بث فيديو. يتيح لك البث إرسال الفيديو إلى YouTube، والذي يمكنه بعد ذلك بث الفيديو إلى جمهورك.

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

طلب

طلب HTTP

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

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

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

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

نص الطلب

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

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

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

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

    • snippet.title
    • snippet.description
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution
    • contentDetails.isReusable

الردّ

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
insufficientPermissions insufficientLivePermissions الطلب غير مصرّح به لإنشاء البث المباشر المحدّد.
insufficientPermissions livePermissionBlocked لا يمكن للمستخدم الذي سمح بالطلب بث فيديو مباشر على YouTube في الوقت الحالي. قد تتوفّر تفاصيل توضّح سبب عدم تمكُّن المستخدم من بث فيديو مباشر في إعدادات قناة المستخدم على https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled المستخدم الذي سمح بالطلب غير مسموح له ببث فيديو مباشر على YouTube. يمكن للمستخدم الاطّلاع على مزيد من المعلومات على الرابط https://www.youtube.com/features.
invalidValue (400) invalidDescription يمكن أن تتضمّن قيمة السمة snippet.description في المورد liveStream ما يصل إلى 10,000 حرف.
invalidValue (400) invalidFormat قيمة السمة cdn.format في المرجع liveStream غير صالحة.
invalidValue (400) invalidFrameRate قيمة السمة cdn.frameRate في المرجع liveStream غير صالحة.
invalidValue (400) invalidIngestionType قيمة السمة cdn.ingestionType في المرجع liveStream غير صالحة.
invalidValue (400) invalidResolution قيمة السمة cdn.resolution في المورد liveStream غير صالحة.
invalidValue (400) invalidTitle يجب أن تتراوح قيمة السمة snippet.title في المورد liveStream بين حرف واحد و128 حرفًا.
rateLimitExceeded userRequestsExceedRateLimit أرسل المستخدم عددًا كبيرًا جدًا من الطلبات في إطار زمني معيّن.
required (400) cdnRequired يجب أن يحتوي مورد liveStream على عنصر cdn.
required (400) frameRateRequired تعرض واجهة برمجة التطبيقات هذا الخطأ إذا حدّدت قيمة للسمة cdn.resolution بدون تحديد قيمة للسمة cdn.frameRate.
required (400) ingestionTypeRequired يجب أن يحدّد مورد liveStream قيمة للسمة cdn.ingestionType>.
required (400) resolutionRequired تعرض واجهة برمجة التطبيقات هذا الخطأ إذا حدّدت قيمة للسمة cdn.frameRate بدون تحديد قيمة للسمة cdn.resolution.
required (400) titleRequired يجب أن يحدّد مورد liveStream قيمة للسمة snippet.title.

جرِّبها الآن.

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