Channels: update

تتيح واجهة برمجة التطبيقات الآن إمكانية تصنيف قناتك أو فيديوهاتك على أنّها "محتوى مخصّص للأطفال". بالإضافة إلى ذلك، تتضمّن الموارد channel وvideo الآن سمة تحدّد حالة "محتوى مخصّص للأطفال" الخاصة بالقناة أو الفيديو. تم أيضًا تعديل بنود خدمة YouTube API وسياسات المطوّرين في 10 كانون الثاني (يناير) 2020. لمزيد من المعلومات، يُرجى الاطّلاع على سجلّات النُسخ السابقة الخاصة بخدمة YouTube Data API وبنود خدمات YouTube API.

تعديل البيانات الوصفية لقناة يُرجى العِلم أنّ هذه الطريقة تتيح فقط تعديل عناصر brandingSettings وinvideoPromotion وlocalizations في مورد channel وسماتها الفرعية.

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

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

طلب

طلب HTTP

PUT https://www.googleapis.com/youtube/v3/channels

التفويض

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

النطاق
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

المعلمات

يعرض الجدول التالي المَعلمات التي يتيحها هذا الطلب. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.

المعلمات
المَعلمات المطلوبة
part string
تخدم المَعلمة part غرضَين في هذه العملية. وتحدّد هذه المَعلمة السمات التي ستضبطها عملية الكتابة، بالإضافة إلى السمات التي سيتضمّنها الردّ من واجهة برمجة التطبيقات.

لا تسمح واجهة برمجة التطبيقات بضبط قيمة المَعلمة إلا على brandingSettings أو invideoPromotion أو localizations. (يمكنك تعديل أيّ من هذه الأجزاء باستخدام طلب واحد فقط.)

يُرجى العِلم أنّ هذه الطريقة تلغي القيم الحالية لجميع السمات القابلة للتغيير المضمّنة في الجزء الذي تحدّده قيمة المَعلمة.
المَعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلا في طلب مصرَّح به بشكل صحيح.

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

يجب تقديم هذه المَعلمة إذا تمت مصادقة الطلب باستخدام بيانات اعتماد مستخدم مالك محتوى في "نظام إدارة المحتوى" يتصرف نيابةً عن قناة مُدارة. في حال حذفها، يتم تنفيذ الطلب ضمن السياق المباشر للمستخدم الذي تمت مصادقته ويعرض خطأ HTTP 403 Forbidden.

نص الطلب

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

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

    • id

  • يمكنك ضبط قيم لهذه السمات:

    • brandingSettings.channel.country
    • brandingSettings.channel.description
    • brandingSettings.channel.defaultLanguage
    • brandingSettings.channel.keywords
    • brandingSettings.channel.trackingAnalyticsAccountId
    • brandingSettings.channel.unsubscribedTrailer
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description
    • status.selfDeclaredMadeForKids

    إذا كنت ترسِل طلب تعديل، ولم يحدّد طلبك قيمة لسمة تتضمّن قيمة حاليًا، سيتم حذف القيمة الحالية للسمة.

الردّ

في حال نجاح هذه الطريقة، ستعرض مورد channel في نص الاستجابة.

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) brandingValidationError تعذّر التحقّق من صحة إحدى القيم في العنصر brandingSettings. استخدِم الطريقة channels.list لاسترداد الإعدادات الحالية للقناة، وعدِّل قيم السمات باتّباع الإرشادات الواردة في مستندات المرجع channels.
badRequest (400) channelTitleUpdateForbidden عند تعديل brandingSettings part لقناة، يجب ضبط قيمة السمة brandingSettings.channel.title على العنوان الحالي للقناة أو حذف السمة. تعرض واجهة برمجة التطبيقات خطأً إذا غيّرت قيمة السمة.
badRequest (400) defaultLanguageNotSetError يجب ضبط defaultLanguage لتحديث localizations.
badRequest (400) invalidBrandingOption أحد إعدادات العلامة التجارية التي حدّدتها غير متوفّر. استخدِم طريقة channels.list لاسترداد القيم الصالحة وتأكَّد من تعديلها باتّباع الإرشادات الواردة في مستندات مرجع channels.
badRequest (400) invalidCustomMessage تحدّد البيانات الوصفية للطلب رسالة مخصّصة غير صالحة. تحقَّق من قيمة السمة invideoPromotion.items[].customMessage في المورد الذي أرسل الطلب.
badRequest (400) invalidDuration تحدّد البيانات الوصفية للطلب مدة غير صالحة في الجزء invideoPromotion.
badRequest (400) invalidDuration تحدّد البيانات الوصفية للطلب نوع موضع غير صالح لتحديد كيفية وضع السلعة المُحسّنة في مشغّل الفيديو. تحقَّق من قيمة السمة invideoPromotion.position.type في المورد الذي أرسله الطلب.
badRequest (400) invalidRecentlyUploadedBy تحدّد البيانات الوصفية للطلب معرّف قناة غير صالح. تحقَّق من قيمة السمة invideoPromotion.items[].id.recentlyUploadedBy في المورد الذي أرسل الطلب.
badRequest (400) invalidTimingOffset تحدّد البيانات الوصفية للطلب إزاحة توقيت غير صالحة في جزء invideoPromotion.
badRequest (400) invalidTimingOffset تحدّد البيانات الوصفية للطلب إزاحة توقيت غير صالحة لتحديد وقت عرض العنصر الذي يتم الترويج له في مشغّل الفيديو. تحقَّق من قيمة السمة invideoPromotion.timing.offsetMs في المورد الذي أرسله الطلب.
badRequest (400) invalidTimingType تحدّد البيانات الوصفية للطلب طريقة توقيت غير صالحة لتحديد وقت عرض العنصر الذي يتم الترويج له في مشغّل الفيديو. تحقَّق من قيمة السمة invideoPromotion.timing.type في المورد الذي أرسله الطلب.
badRequest (400) localizationValidationError تعذّر التحقّق من صحة إحدى القيم في عنصر الترجمات. استخدِم طريقة channels.list لاسترداد القيم الصالحة وتأكَّد من تعديلها باتّباع الإرشادات الواردة في مستندات مرجع قنوات YouTube.
badRequest (400) tooManyPromotedItems تم تجاوز عدد الفيديوهات المسموح بالترويج لها في الجزء invideoPromotion.
forbidden (403) channelForbidden لا تتيح القناة المحدّدة في المَعلمة id تنفيذ الطلب أو لم يتم منح الإذن اللازم لتنفيذه.
forbidden (403) promotedVideoNotAllowed تعذّر العثور على القناة التي يحاول طلب بيانات من واجهة برمجة التطبيقات تعديلها. تحقَّق من قيمة السمة id في مورد channel الذي أرسله الطلب للتأكّد من صحة معرّف القناة.
forbidden (403) websiteLinkNotAllowed عنوان URL المحدّد للموقع الإلكتروني غير مسموح به.
notFound (404) channelNotFound يتعذّر العثور على القناة المحدّدة في المَعلمة id.
notFound (404) channelNotFound تعذّر العثور على القناة المحدّدة من خلال المَعلمة id أو لا تتوفّر فيها خيارات الهوية البصرية.
notFound (404) unknownChannelId لم يتم العثور على معرّف القناة المحدّد.
notFound (404) unknownChannelId لم يتم العثور على معرّف القناة المحدّد recentlyUploadedBy.
notFound (404) unknownVideoId يتعذّر العثور على معرّف الفيديو المحدّد كعنصر مروَّج.
required (400) requiredItemIdType يجب أن تحدّد البيانات الوصفية للطلب نوع العنصر في الجزء invideoPromotion.
required (400) requiredItemId يجب أن تحدّد البيانات الوصفية للطلب معرّف السلعة في الجزء invideoPromotion.
required (400) requiredTimingOffset يجب أن تحدّد البيانات الوصفية للطلب إزاحة توقيت تلقائية لكي يتمكّن YouTube من تحديد وقت عرض العنصر الذي يتم الترويج له. اضبط قيمة السمة invideoPromotion.defaultTiming.offsetMs في المورد الذي يرسله الطلب.
required (400) requiredTimingOffset يجب أن تحدّد البيانات الوصفية للطلب إزاحة توقيت لكي يتمكّن YouTube من تحديد وقت عرض المنتج الترويجي. اضبط قيمة السمة invideoPromotion.timing.offsetMs في المورد الذي يرسله الطلب.
required (400) requiredTimingType يجب أن تحدّد البيانات الوصفية للطلب طريقة تحديد التوقيت لكي يتمكّن YouTube من تحديد وقت عرض المنتج الترويجي. اضبط قيمة السمة invideoPromotion.defaultTiming.type في المورد الذي يرسله الطلب.
required (400) requiredTimingType يجب أن تحدّد البيانات الوصفية للطلب طريقة التوقيت لكي يتمكّن YouTube من تحديد وقت عرض العنصر الذي يتم الترويج له. اضبط قيمة السمة invideoPromotion.timing.type في المورد الذي يرسله الطلب.
required (400) requiredTiming يجب أن تحدّد البيانات الوصفية للطلب توقيتًا لكل عنصر في الجزء invideoPromotion.
required (400) requiredVideoId يجب أن تحدّد البيانات الوصفية للطلب معرّف الفيديو لتحديد السلعة التي يتم الترويج لها.
required (400) requiredWebsiteUrl يجب أن تحدّد البيانات الوصفية للطلب عنوان URL لموقع إلكتروني في جزء invideoPromotion. اضبط قيمة السمة invideoPromotion.items[].id.websiteUrl في المورد الذي يرسله الطلب.

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

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