LiveBroadcasts: insert

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

لإنشاء بث.

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

الطلب

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

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

نص الطلب

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

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

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

  • ويمكنك ضبط قيم لهذه المواقع الإلكترونية:

    • snippet.title
    • snippet.description
    • 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

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

الإجابة

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

الأخطاء

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

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

تجربة

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