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