Channels: update

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

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

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

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

الطلب

طلب HTTP

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

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والترخيص).

النطاق
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.

نص الطلب

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

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

    • 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

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

الإجابة

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
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 لاسترداد القيم الصالحة والتأكّد من تعديلها باتّباع الإرشادات الواردة في مستندات مراجع القنوات.
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 لم يتم العثور على معرّف القناة المحدد مؤخرًاUploadedBy.
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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.