لتعديل بث. على سبيل المثال، يمكنك تعديل إعدادات البث المحددة في عنصر 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 .
يمكن أن يحدث هذا الخطأ للأسباب التالية:
|
forbidden (403) |
enableAutoStartModificationNotAllowed |
لا يمكن تعديل قيمة contentDetails.enableAutoStart إلا عندما يكون البث غير نشط وعندما يكون البث بالحالة created أو ready . |
forbidden (403) |
enableClosedCaptionsModificationNotAllowed |
لا يمكن تعديل قيمة contentDetails.enableClosedCaptions إلا عندما تكون حالة البث created أو ready . |
forbidden (403) |
enableDvrModificationNotAllowed |
لا يمكن تعديل القيمة contentDetails. إلا عندما تكون حالة البث created أو ready . |
forbidden (403) |
enableMonitorStreamModificationNotAllowed |
لا يمكن تعديل القيمة contentDetails. إلا عندما تكون حالة البث created أو ready . |
forbidden (403) |
recordFromStartModificationNotAllowed |
لا يمكن تعديل القيمة contentDetails. إلا عندما تكون حالة البث 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 .
يمكن أن يحدث هذا الخطأ للأسباب التالية:
|
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. . |
required (400) |
enableMonitorStreamRequired |
لم يحدِّد مورد البث المباشر السمة contentDetails. . |
required (400) |
idRequired |
يجب أن يتضمّن مورد البث المباشر قيمة للسمة id ويحدّدها. |
required (400) |
scheduledEndTimeRequired |
لم يحدِّد مورد البث المباشر السمة snippet.scheduledEndTime . |
required (400) |
scheduledStartTimeRequired |
لم يحدِّد مورد البث المباشر السمة snippet.scheduledStartTime . |
تجربة
يمكنك استخدام APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.