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