يربط هذا الطلب بثًا على YouTube بدفق أو يزيل ربطًا حاليًا بين بث ودفق. يمكن ربط بث واحد فقط بدفق فيديو واحد، مع أنّه يمكن ربط دفق فيديو بأكثر من بث واحد.
حالات الاستخدام الشائعة
طلب
طلب HTTP
POST https://www.googleapis.com/youtube/v3/liveBroadcasts/bind
التفويض
يتطلّب هذا الطلب الحصول على إذن باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة ومنح الإذن).
| النطاق |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المعلمات
يعرض الجدول التالي المَعلمات التي يتيحها هذا الطلب. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.
| المعلمات | ||
|---|---|---|
| المَعلمات المطلوبة | ||
id |
stringتحدّد المَعلمة id المعرّف الفريد للبث الذي يتم ربطه بدفق فيديو. |
|
part |
stringتحدّد المَعلمة part قائمة قيم مفصولة بفاصلة لسمة واحدة أو أكثر من سمات المورد liveBroadcast التي سيتضمّنها الردّ من واجهة برمجة التطبيقات. أسماء 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. وهي تتيح لمالكي المحتوى المصادقة مرة واحدة وتنفيذ الإجراءات نيابةً عن القناة المحدّدة في قيمة المَعلمة، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة منفصلة. |
|
streamId |
stringتحدّد المَعلمة streamId المعرّف الفريد لدفق الفيديو الذي يتم ربطه ببث. إذا تم حذف هذه المَعلمة، ستزيل واجهة برمجة التطبيقات أي ربط حالي بين البث المباشر ومصدر بيانات الفيديو. |
|
نص الطلب
لا تقدّم نص طلب عند استدعاء هذه الطريقة.
الردّ
إذا نجح هذا الإجراء، سيعرض مورد liveBroadcast في نص الاستجابة.
الأخطاء
يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب هذه الطريقة. يُرجى الاطّلاع على مستندات رسالة الخطأ لمزيد من التفاصيل.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
backendError |
internalError |
حدث خطأ داخلي أثناء الربط. |
forbidden (403) |
liveBroadcastBindingNotAllowed |
لا تسمح الحالة الحالية للبث المباشر بربطه ببث. |
insufficientPermissions |
insufficientLivePermissions |
الطلب غير مصرّح به لاسترداد البث المباشر المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على تنفيذ مصادقة OAuth2. |
insufficientPermissions |
liveStreamingNotEnabled |
المستخدم الذي سمح بالطلب غير مسموح له ببث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على الرابط https://www.youtube.com/features. |
notFound (404) |
liveBroadcastNotFound |
البث المحدّد بواسطة المَعلمة id غير متوفّر. |
notFound (404) |
liveStreamNotFound |
لا يتوفّر مصدر البيانات المحدّد بالمعلَمة streamId. |
rateLimitExceeded |
userRequestsExceedRateLimit |
أرسل المستخدم عددًا كبيرًا جدًا من الطلبات خلال إطار زمني معيّن. |
required (400) |
idRequired |
يجب أن تحدّد مَعلمة id المطلوبة البث الذي تريد ربطه. |
جرِّبها الآن.
استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة.