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