LiveStreams: insert

تُنشئ مجموعة بث فيديو. تتيح لك مجموعة البث إرسال الفيديو إلى YouTube الذي يمكن من خلاله بث الفيديو إلى الجمهور بعد ذلك.

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

الطلب

طلب HTTP

POST https://www.googleapis.com/youtube/v3/liveStreams

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والترخيص).

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

المَعلمات

يسرد الجدول التالي المعلَمات التي يتيحها طلب البحث هذا. كلّ المَعلمات المدرَجة هي مَعلمات طلب بحث.

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

سمات part التي يمكنك تضمينها في قيمة المَعلمة هي id وsnippet وcdn وcontentDetails وstatus.
المَعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلا في طلب معتمد بشكل صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.

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

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

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

نص الطلب

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

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

    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

  • ويمكنك ضبط قيم لهذه المواقع الإلكترونية:

    • snippet.title
    • snippet.description
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution
    • contentDetails.isReusable

الإجابة

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
insufficientPermissions insufficientLivePermissions الطلب غير مخوّل لإنشاء البث المباشر المحدّد.
insufficientPermissions livePermissionBlocked يتعذّر على المستخدم الذي فوّض هذا الطلب بث فيديو مباشر على YouTube في الوقت الحالي. قد تتوفر تفاصيل تشرح سبب تعذّر بث الفيديو المباشر في إعدادات قناة المستخدم على https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled إنّ المستخدم الذي فوَّض بالطلب غير مفعّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على المزيد من المعلومات على https://www.youtube.com/features.
invalidValue (400) invalidDescription يمكن أن تحتوي قيمة السمة snippet.description في المورد liveStream على ما يصل إلى 10,000 حرف.
invalidValue (400) invalidFormat قيمة السمة cdn.format في مورد liveStream غير صالحة.
invalidValue (400) invalidFrameRate قيمة السمة cdn.frameRate في المورد liveStream غير صالحة.
invalidValue (400) invalidIngestionType قيمة السمة cdn.ingestionType في المورد liveStream غير صالحة.
invalidValue (400) invalidResolution قيمة السمة cdn.resolution في المورد liveStream غير صالحة.
invalidValue (400) invalidTitle يجب أن يتراوح طول قيمة السمة snippet.title في المورد liveStream بين حرف واحد و128 حرفًا.
rateLimitExceeded userRequestsExceedRateLimit أرسل المستخدم عددًا كبيرًا جدًا من الطلبات في إطار زمني معيّن.
required (400) cdnRequired يجب أن يحتوي المورد liveStream على الكائن cdn.
required (400) frameRateRequired تعرض واجهة برمجة التطبيقات هذا الخطأ إذا حدَّدت قيمة للسمة cdn.resolution ولكن ليس في السمة cdn.frameRate.
required (400) ingestionTypeRequired يجب أن يحدّد مورد liveStream قيمة للسمة cdn.ingestionType>.
required (400) resolutionRequired تعرض واجهة برمجة التطبيقات هذا الخطأ إذا حدَّدت قيمة للسمة cdn.frameRate ولكن ليس في السمة cdn.resolution.
required (400) titleRequired يجب أن يحدّد مورد liveStream قيمة للسمة snippet.title.

تجربة

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