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 يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى في YouTube الذين يملكون ويديرون العديد من قنوات على YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد للمصادقة لكل قناة على حدة. يجب أن يكون حساب نظام إدارة المحتوى الذي يصادق عليه المستخدم مرتبطًا بمالك المحتوى المحدّد على YouTube.
onBehalfOfContentOwnerChannel string
لا يمكن استخدام هذه المَعلمة إلا في طلب مصرَّح به بشكل صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى على YouTube.

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

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

نص الطلب

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

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

    • snippet.type

  • يمكنك ضبط قيم للخصائص التالية:

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

الردّ

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة.