Channels: update

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

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

نص الطلب

قدِّم مورد 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 - Errors (أخطاء واجهة برمجة التطبيقات لبيانات YouTube).

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