ChannelSections: update

يعدّل هذا الطلب قسمًا في القناة.

تأثير الحصة: تبلغ تكلفة الحصة لطلب هذه الطريقة 50 وحدة.

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

طلب

طلب HTTP

PUT 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.

نص الطلب

يجب تقديم مورد 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) idInvalid تحدّد السمة id معرّفًا غير صالح لقسم القناة.
invalidValue (400) idRequired يجب أن تحدّد السمة id قيمة تحدّد قسم القناة الذي يتم تعديله.
invalidValue (400) inValidPosition تحتوي السمة snippet.position على قيمة غير صالحة.
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) channelSectionNotFound يتعذّر العثور على قسم القناة الذي تحاول تعديله.
notFound (404) playlistNotFound يتعذّر العثور على قائمة تشغيل واحدة أو أكثر من قوائم التشغيل المحدّدة.

جرِّبها الآن.

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