LiveBroadcasts: update

تعديل بث على سبيل المثال، يمكنك تعديل إعدادات البث المحدّدة في عنصر contentDetails لمصدر liveBroadcast.

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

الطلب

طلب HTTP

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

التفويض

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

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

المعلمات

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

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

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

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

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

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

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

نص الطلب

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

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

    • id
    • snippet.scheduledStartTime
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs

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

    • snippet.title
    • snippet.description
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • monetizationDetails.cuepointSchedule.pauseAdsUntil

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

الرد

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) closedCaptionsTypeModificationNotAllowed لا يمكن تعديل قيمة contentDetails.closedCaptionsType إلا عندما يكون البث في الحالة created أو ready.
forbidden (403) enabledModificationNotAllowed حقل enabled للقراءة فقط.
forbidden (403) scheduleStrategyModificationNotAllowed حقل scheduleStrategy للقراءة فقط.
forbidden (403) repeatIntervalSecsModificationNotAllowed الحقل repeatIntervalSecs للقراءة فقط.
forbidden (403) pauseAdsUntilModificationNotAllowed لا يمكن تعديل الحقل pauseAdsUntil. يمكن أن يحدث هذا الخطأ للأسباب التالية:
  • لم يتم ضبط الحقل monetizationDetails.cuepointSchedule.enabled على true. لا يمكن ضبط هذا الحقل إلا باستخدام "استوديو YouTube".
  • البث غير مباشر.
forbidden (403) enableAutoStartModificationNotAllowed لا يمكن تعديل قيمة contentDetails.enableAutoStart إلا عندما يكون البث غير نشط ويكون البث في الحالة created أو ready.
forbidden (403) enableClosedCaptionsModificationNotAllowed لا يمكن تعديل قيمة contentDetails.enableClosedCaptions إلا عندما تكون حالة البث هي created أو ready.
forbidden (403) enableDvrModificationNotAllowed لا يمكن تعديل قيمة contentDetails.enableDvr إلا إذا كانت حالة البث هي created أو ready.
forbidden (403) enableMonitorStreamModificationNotAllowed لا يمكن تعديل قيمة contentDetails.monitorStream.enableMonitorStream إلا عندما تكون حالة البث هي created أو ready.
forbidden (403) recordFromStartModificationNotAllowed لا يمكن تعديل قيمة contentDetails.recordFromStart إلا عندما تكون حالة البث هي created أو ready.
insufficientPermissions insufficientLivePermissions الطلب غير مصرّح له بتعديل البث المباشر المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تنفيذ مصادقة OAuth2.
insufficientPermissions liveStreamingNotEnabled المستخدم الذي فوّض الطلب غير مفعّل له بث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على https://www.youtube.com/features.
invalidValue (400) invalidAutoStart يحتوي مورد البث المباشر على قيمة غير صالحة للسمة contentDetails.enableAutoStart. لا يمكنك تعديل إعدادات "enableAutoStart" لبث دائم.
invalidValue (400) invalidAutoStop يحتوي مصدر البث المباشر على قيمة غير صالحة للسمة contentDetails.enableAutoStop. لا يمكنك تعديل الإعداد enableAutoStop لبث دائم.
invalidValue (400) invalidDescription لم يحدِّد مورد البث المباشر قيمة صالحة للسمة snippet.description. يمكن أن يتضمّن snippet.description ما يصل إلى 5,000 حرف.
invalidValue (400) invalidEmbedSetting يحتوي مصدر البث المباشر على قيمة غير صالحة للسمة contentDetails.enable_embed. لا يمكنك تضمين هذا البث.
invalidValue (400) invalidEnableClosedCaptions في مورد البث المباشر، لا تتوافق قيمة السمة contentDetails.enableClosedCaptions مع قيمة الإعداد contentDetails.closedCaptionType. عدِّل المرجع لتضمين أحد الموقعَين فقط، ثم أعِد إرسال الطلب.
invalidValue (400) invalidLatencyPreferenceOptions يحتوي مصدر البث المباشر على قيمة غير صالحة للسمة contentDetails.latencyPreference. لا تتوفر بعض الإعدادات مع هذا الخيار المفضّل لوقت الاستجابة.
invalidValue (400) invalidPauseAdsUntil يحتوي مورد البث المباشر على قيمة غير صالحة لسمة monetizationDetails.cuepointSchedule.pauseAdsUntil. يمكن أن يحدث هذا الخطأ للأسباب التالية:
  • لم يتم تحديد قيمة monetizationDetails.cuepointSchedule.pauseAdsUntil بتنسيق ISO 8601‏ (YYYY-MM-DDThh:mm:ss.sZ).
  • قيمة monetizationDetails.cuepointSchedule.pauseAdsUntil ليست في المستقبل.
  • قيمة monetizationDetails.cuepointSchedule.pauseAdsUntil أبعد من 10 دقائق عن الوقت الحالي.
invalidValue (400) invalidPrivacyStatus لم يحدِّد مصدر البث المباشر حالة خصوصية صالحة. راجِع قيم privacyStatus الصالحة.
invalidValue (400) invalidProjection يحتوي مصدر البث المباشر على قيمة غير صالحة للسمة contentDetails.projection. لا يمكن ضبط عرض البث الثابت على 360.
invalidValue (400) invalidScheduledEndTime يحتوي مورد البث المباشر على قيمة غير صالحة للسمة snippet.scheduledEndTime. يجب أن يكون وقت الانتهاء المُجدوَل بعد وقت البدء المُجدوَل.
invalidValue (400) invalidScheduledStartTime يحتوي مصدر البث المباشر على قيمة غير صالحة للسمة snippet.scheduledStartTime. يجب أن يكون وقت البدء المُجدوَل في المستقبل.
invalidValue (400) invalidTitle لم يحدّد مصدر البث المباشر قيمة صالحة للسمة snippet.title. يجب أن يتراوح طول snippet.title بين حرف واحد و100 حرف.
notFound (404) liveBroadcastNotFound لم يحدّد الموقع id المحدّد في مصدر البث المباشر بثًا.
required (400) broadcastStreamDelayMsRequired لم يحدِّد مصدر البث المباشر السمة contentDetails.monitorStream.broadcastStreamDelayMs.
required (400) enableMonitorStreamRequired لم يحدِّد مصدر البث المباشر السمة contentDetails.monitorStream.enableMonitorStream.
required (400) idRequired يجب أن يتضمّن مورد البث المباشر قيمة للسمة id ويحدّدها.
required (400) scheduledEndTimeRequired لم يحدّد مصدر البث المباشر السمة snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired لم يحدِّد مصدر البث المباشر السمة snippet.scheduledStartTime.

جرّب الآن

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