ChannelSections: insert

لإضافة قسم قناة إلى قناة المستخدم الذي تمت المصادقة عليه. يمكن للقناة إنشاء 10 رفوف كحد أقصى.

التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.

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

طلب

طلب HTTP

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

التفويض

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

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

المعلَمات

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

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

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

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

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

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

نص الطلب

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

  • يجب تحديد قيمة للخصائص التالية:

    • snippet.type

  • يمكنك تعيين قيم للخصائص التالية:

    • snippet.type
    • snippet.title
    • snippet.position
    • contentDetails.playlists[]
    • contentDetails.channels[]

الإجابة

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) notEditable لا يمكن إنشاء قسم القناة هذا.
badRequest (400) typeRequired يجب أن يحدد مورد channelSection قيمة للحقل snippet.type.
forbidden (403) channelSectionForbidden لم تتم مصادقة الطلب بشكل صحيح أو أنه غير معتمد لهذه القناة.
invalidValue (400) channelNotActive قناة واحدة على الأقل من القنوات المحددة غير نشطة.
invalidValue (400) channelsDuplicated تعذَّرت تلبية الطلب نظرًا لتحديد قنوات مكررة.
invalidValue (400) channelsNeeded إذا كانت قيمة السمة snippet.type هي multipleChannels، يجب تحديد السمة contentDetails.channels[] ويجب أن تحدد قناة واحدة على الأقل.
invalidValue (400) channelsNotExpected حدّد المورد المقدّم مع الطلب قيمة للسمة contentDetails.channels[]، ولكن لا يُتوقّع وجود قنوات لهذا النوع من أقسام القناة.
invalidValue (400) contentDetailsNeeded يجب أن يحتوي المورد الذي تدرجه على كائن contentDetails لهذا النوع من أقسام القناة.
invalidValue (400) inValidPosition تحتوي الخاصية snippet.position على قيمة غير صالحة.
invalidValue (400) maxChannelSectionExceeded لا يمكن إكمال الطلب لأنّ القناة بلغت الحدّ الأقصى المسموح به لعدد أقسام القناة.
invalidValue (400) maxChannelsExceeded تعذّرت تلبية الطلب بسبب محاولة تضمين عدد كبير جدًا من القنوات في قسم القناة.
invalidValue (400) maxPlaylistExceeded تعذّرت تلبية الطلب بسبب محاولة تضمين عدد كبير جدًا من قوائم التشغيل في قسم القناة.
invalidValue (400) onePlaylistNeeded إذا كانت السمة snippet.type تحتوي على قيمة singlePlaylist، يجب أن تحدد الخاصية contentDetails.playlists[] قائمة تشغيل واحدة بالضبط.
invalidValue (400) ownChannelInChannels لا يمكنك تضمين قناتك في قسم قناة يظهر على تلك القناة.
invalidValue (400) playlistIsPrivate قائمة تشغيل واحدة أو أكثر من قوائم التشغيل المحددة خاصة، وبالتالي لا يمكن تضمينها في قسم القناة.
invalidValue (400) playlistsDuplicated تعذَّرت تلبية الطلب لأنه حدّد قوائم تشغيل مكررة.
invalidValue (400) playlistsNeeded إذا كانت السمة snippet.type تحتوي على قيمة singlePlaylist أو multiplePlaylists، يجب تحديد السمة contentDetails.playlists[].
invalidValue (400) playlistsNotExpected حدّد المورد المقدّم مع الطلب قيمة للسمة contentDetails.playlists[]، ولكن من غير المتوقع أن تكون قوائم التشغيل لهذا النوع من أقسام القناة.
invalidValue (400) snippetNeeded يجب تحديد snippet لإنشاء قسم القناة.
invalidValue (400) titleLengthExceeded قيمة السمة snippet.title طويلة جدًا.
invalidValue (400) titleRequired إذا كانت قيمة السمة snippet.type هي multiplePlaylists أو multipleChannels، يجب ضبط عنوان القسم من خلال تحديد قيمة للسمة snippet.title.
notFound (404) channelNotFound تعذر العثور على قناة واحدة أو أكثر من القنوات المحددة.
notFound (404) playlistNotFound لا يمكن العثور على قائمة تشغيل واحدة أو أكثر من قوائم التشغيل المحددة.

جرِّب هذه الميزة الآن.

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