LiveBroadcasts: update

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

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

الطلب

طلب HTTP

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