تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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 CMS الذي يتصرف نيابةً عن مالك المحتوى المحدد في قيمة المعلمة. هذه المعلمة مخصصة لشركاء محتوى YouTube الذين يملكون ويديرون العديد من قنوات 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)`	`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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.