LiveBroadcasts: insert

تتيح واجهة برمجة التطبيقات الآن إمكانية وضع علامة "محتوى مخصّص للأطفال" على عمليات البث المباشر، ويتضمّن مورد liveBroadcast الآن سمة تحدّد حالة "محتوى مخصّص للأطفال" في عملية البث المباشر هذه. تم أيضًا تعديل "بنود الخدمة" الخاصة بخدمات YouTube API و"سياسات المطوّرين" في 10 يناير 2020. لمزيد من المعلومات، يُرجى الاطّلاع على سجلّات المراجعة الخاصة بـ YouTube Live Streaming API Service و بنود الخدمة الخاصة بخدمات YouTube API.

ينشئ هذا الإجراء عملية بث.

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

طلب

طلب HTTP

POST https://www.googleapis.com/youtube/v3/liveBroadcasts

التفويض

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

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

المعلمات

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

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

نص الطلب

يجب تقديم مورد liveBroadcast في نص الطلب. بالنسبة إلى هذا المورد:

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

  • snippet.title
  • snippet.scheduledStartTime
  • status.privacyStatus

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

  • snippet.title
  • snippet.description
  • snippet.categoryId
  • snippet.scheduledStartTime
  • snippet.scheduledEndTime
  • status.privacyStatus
  • status.selfDeclaredMadeForKids
  • contentDetails.monitorStream.enableMonitorStream
  • contentDetails.monitorStream.broadcastStreamDelayMs
  • contentDetails.enableAutoStart
  • contentDetails.enableAutoStop
  • contentDetails.enableClosedCaptions
  • contentDetails.enableDvr
  • contentDetails.enableEmbed
  • contentDetails.recordFromStart
  • contentDetails.availabilityConfig
  ملاحظة: يوثّق جدول السمات أي قيم تلقائية يتم ضبطها للسمات المُدرَجة. سيتم تخصيص القيم التلقائية في أي من الحالتَين التاليتَين:
  

  • لم تحدّد قيمًا لهذه السمات.
  • لا تحدّد قيمة المَعلمة part في طلبك الجزء الذي يحتوي على هذه السمات.

الردّ

إذا كان الطلب ناجحًا، يعرض هذا الإجراء مورد liveBroadcast في نص الردّ.

الأخطاء

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

نوع الخطأ	تفاصيل الخطأ	الوصف
insufficientPermissions	insufficientLivePermissions	الطلب غير مُفوَّض لإنشاء عملية البث المباشر.
insufficientPermissions	livePermissionBlocked	لا يمكن للمستخدم الذي فوّض الطلب بث فيديو مباشر على YouTube في الوقت الحالي. قد تتوفّر تفاصيل توضّح سبب عدم إمكانية بث المستخدم فيديو مباشر في إعدادات القناة على https://www.youtube.com/features.
insufficientPermissions	liveStreamingNotEnabled	لم يتم تفعيل ميزة بث الفيديو المباشر على YouTube للمستخدم الذي فوّض الطلب. يمكن للمستخدم العثور على مزيد من المعلومات على https://www.youtube.com/features.
invalidValue (400)	invalidAutoStart	احتوى مورد liveBroadcast على قيمة غير صالحة للسمة contentDetails.enableAutoStart. لا تتيح بعض عمليات البث هذا الإعداد.
invalidValue (400)	invalidAutoStop	احتوى مورد liveBroadcast على قيمة غير صالحة للسمة contentDetails.enableAutoStop. لا يمكنك تعديل إعداد enableAutoStop لعملية بث مستمرة.
invalidValue (400)	invalidDescription	لم يحدّد مورد liveBroadcast قيمة صالحة للسمة snippet.description. يمكن أن تحتوي قيمة السمة على ما يصل إلى 5000 حرف.
invalidValue (400)	invalidEmbedSetting	احتوى مورد liveBroadcast على قيمة غير صالحة للسمة contentDetails.enable_embed. لا يمكنك تضمين عملية البث هذه.
invalidValue (400)	invalidLatencyPreferenceOptions	احتوى مورد liveBroadcast على قيمة غير صالحة للسمة contentDetails.latencyPreference. لا تتوافق بعض الإعدادات مع هذا الإعداد المفضّل لتحديد المدة.
invalidValue (400)	invalidPrivacyStatus	احتوى مورد liveBroadcast على قيمة غير صالحة للسمة status.privacy_status.
invalidValue (400)	invalidProjection	احتوى مورد liveBroadcast على قيمة غير صالحة للسمة contentDetails.projection. لا يمكن ضبط عرض عملية البث التلقائية على 360.
invalidValue (400)	invalidScheduledEndTime	احتوى مورد liveBroadcast على قيمة غير صالحة للسمة snippet.scheduledEndTime. يجب أن يكون وقت الانتهاء المحدّد بعد وقت البدء المحدّد.
invalidValue (400)	invalidScheduledStartTime	احتوى مورد liveBroadcast على قيمة غير صالحة للسمة snippet.scheduledStartTime. يجب أن يكون وقت البدء المحدّد في المستقبل وقريبًا بما يكفي من التاريخ الحالي بحيث يمكن جدولة عملية بث بشكل موثوق في ذلك الوقت.
invalidValue (400)	invalidTitle	لم يحدّد مورد liveBroadcast قيمة صالحة للسمة snippet.title. يجب أن يتراوح طول قيمة السمة بين حرف واحد و100 حرف.
limitExceeded	userBroadcastsExceedLimit	أنشأ المستخدم عددًا كبيرًا جدًا من عمليات البث المباشر أو المجدولة، ويجب أن يتوقف عن إنشاء بعضها أو يحذفها.
rateLimitExceeded	userRequestsExceedRateLimit	أرسل المستخدم عددًا كبيرًا جدًا من الطلبات خلال إطار زمني معيّن.
required (400)	privacyStatusRequired	يجب أن يحدّد مورد liveBroadcast حالة الخصوصية. راجِع قيم privacyStatus الصالحة.
required (400)	scheduledEndTimeRequired	يجب أن يحدّد مورد liveBroadcast السمة snippet.scheduledEndTime.
required (400)	scheduledStartTimeRequired	يجب أن يحدّد مورد liveBroadcast السمة snippet.scheduledStartTime.
required (400)	titleRequired	يجب أن يحدّد مورد liveBroadcast السمة snippet.title.

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

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