تتيح واجهة برمجة التطبيقات الآن تصنيف قناتك أو
فيديوهاتك على أنّها "مخصّصة للأطفال". بالإضافة إلى ذلك،
channel
وتحتوي video
موارد أيضًا على سمة تحدّد المحتوى "المخصّص للأطفال".
حالة تلك القناة أو الفيديو. بنود الخدمة وسياسات مطوّري البرامج بشأن خدمات واجهات برمجة تطبيقات YouTube
تم تحديثها أيضًا في 10 يناير 2020. لمزيد من المعلومات، يرجى الاطلاع على سجلات المراجعات
خدمة YouTube Data API
بنود الخدمة المتعلّقة بخدمات YouTube API
يحتوي مرجع channel
على معلومات حول إحدى القنوات على YouTube.
الطُرق
تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد channels
:
- list
- لا تعرض مجموعة من موارد
channel
أو أكثر تطابق معايير الطلب. تجربة ذلك الآن - تعديل
- يعدّل البيانات الوصفية للقناة. يُرجى العلم بأنّ هذه الطريقة تتيح حاليًا فقط التعديلات على العنصرَين
brandingSettings
وinvideoPromotion
في الموردchannel
وخصائصهما الفرعية. تجربة ذلك الآن
تمثيل الموارد
تعرض بنية JSON التالية تنسيق مورد channels
:
{ "kind": "youtube#channel", "etag": etag, "id": string, "snippet": { "title": string, "description": string, "customUrl": string, "publishedAt": datetime, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "defaultLanguage": string, "localized": { "title": string, "description": string }, "country": string }, "contentDetails": { "relatedPlaylists": { "likes": string, "favorites": string, "uploads": string } }, "statistics": { "viewCount": unsigned long, "subscriberCount": unsigned long, // this value is rounded to three significant figures "hiddenSubscriberCount": boolean, "videoCount": unsigned long }, "topicDetails": { "topicIds": [ string ], "topicCategories": [ string ] }, "status": { "privacyStatus": string, "isLinked": boolean, "longUploadsStatus": string, "madeForKids": boolean, "selfDeclaredMadeForKids": boolean }, "brandingSettings": { "channel": { "title": string, "description": string, "keywords": string, "trackingAnalyticsAccountId": string, "unsubscribedTrailer": string, "defaultLanguage": string, "country": string }, "watch": { "textColor": string, "backgroundColor": string, "featuredPlaylistId": string } }, "auditDetails": { "overallGoodStanding": boolean, "communityGuidelinesGoodStanding": boolean, "copyrightStrikesGoodStanding": boolean, "contentIdClaimsGoodStanding": boolean }, "contentOwnerDetails": { "contentOwner": string, "timeLinked": datetime }, "localizations": { (key): { "title": string, "description": string } } }
أماكن إقامة
يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:
أماكن إقامة | |
---|---|
kind |
string تحدد هذه السياسة نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#channel . |
etag |
etag تشير هذه السمة إلى علامة هذا المورد. |
id |
string المعرّف الذي يستخدمه YouTube لتحديد القناة بشكل فريد |
snippet |
object يحتوي عنصر snippet على تفاصيل أساسية عن القناة، مثل عنوانها ووصفها وصورها المصغّرة. |
snippet.title |
string عنوان القناة |
snippet.description |
string وصف القناة يمكن أن تتألف قيمة الموقع من 1,000 حرف كحدّ أقصى. |
snippet.customUrl |
string عنوان URL المخصّص للقناة يقدّم مركز مساعدة YouTube شرحًا حول متطلبات الأهلية للحصول على عنوان URL مخصّص وكيفية إعداده. |
snippet.publishedAt |
datetime تاريخ ووقت إنشاء القناة يتم تحديد القيمة بتنسيق ISO 8601. |
snippet.thumbnails |
object خريطة للصور المصغّرة المرتبطة بالقناة بالنسبة إلى كل عنصر في الخريطة، يكون المفتاح هو اسم الصورة المصغّرة، والقيمة هي عنصر يحتوي على معلومات أخرى حول الصورة المصغّرة. عند عرض صور مصغّرة في تطبيقك، تأكد من أن الرمز يستخدم عناوين URL للصور تمامًا كما تظهر في استجابات واجهة برمجة التطبيقات. على سبيل المثال، يجب ألا يستخدم تطبيقك النطاق http بدلاً من النطاق https في عنوان URL يتم عرضه في استجابة واجهة برمجة التطبيقات.تتوفّر عناوين URL للصور المصغّرة للقناة في نطاق https فقط، وهو ما تظهر به عناوين URL في الردود من واجهة برمجة التطبيقات. قد تظهر صور معطّلة في تطبيقك إذا حاول تحميل صور YouTube من نطاق http . قد تكون الصور المصغّرة فارغة للقنوات التي تمّ إنشاؤها حديثًا وقد تستغرق عملية تعبئتها مدة تصل إلى يوم واحد. |
snippet.thumbnails.(key) |
object القيم الأساسية الصالحة هي:
|
snippet.thumbnails.(key).url |
string عنوان URL الخاص بالصورة يمكنك الاطّلاع على تعريف السمة snippet.thumbnails للحصول على إرشادات إضافية عن استخدام عناوين URL للصور المصغّرة في تطبيقك. |
snippet.thumbnails.(key).width |
unsigned integer عرض الصورة. |
snippet.thumbnails.(key).height |
unsigned integer ارتفاع الصورة. |
snippet.defaultLanguage |
string لغة النص في السمتَين snippet.title وsnippet.description للمورد channel |
snippet.localized |
object يحتوي العنصر snippet.localized على عنوان ووصف مترجمَين للقناة، أو على عنوان القناة ووصفها باللغة التلقائية الخاصة بالبيانات الوصفية للقناة.
localizations لإضافة البيانات الوصفية المترجَمة أو تعديلها أو حذفها. |
snippet.localized.title |
string عنوان القناة المترجَم |
snippet.localized.description |
string وصف القناة المترجَم |
snippet.country |
string البلد الذي ترتبط به القناة لضبط قيمة هذه السمة، عليك تعديل قيمة السمة brandingSettings.channel.country . |
contentDetails |
object يتضمن العنصر contentDetails معلومات حول محتوى القناة. |
contentDetails.relatedPlaylists |
object العنصر relatedPlaylists هو خريطة تحدّد قوائم التشغيل المرتبطة بالقناة، مثل الفيديوهات التي تم تحميلها أو الفيديوهات التي أعجبتك. يمكنك استرداد أي من قوائم التشغيل هذه باستخدام الطريقة playlists.list . |
contentDetails.relatedPlaylists.likes |
string معرّف قائمة التشغيل التي تحتوي على الفيديوهات التي أعجبتك القناة استخدِم الطريقتَين playlistItems.insert وplaylistItems.delete لإضافة عناصر إلى تلك القائمة أو إزالتها منها. |
contentDetails.relatedPlaylists.favorites |
string تم إيقاف هذه السمة نهائيًا. معرّف قائمة التشغيل التي تتضمّن الفيديوهات المفضّلة في القناة. يمكنك استخدام الطريقتَين playlistItems.insert وplaylistItems.delete لإضافة عناصر أو إزالتها من تلك القائمة.ملاحظة: أوقف YouTube وظيفة الفيديو المفضّلة نهائيًا. على سبيل المثال، تم إيقاف السمة statistics.favoriteCount الخاصة بمورد video في 28 آب (أغسطس) 2015. نتيجةً لذلك، قد تحتوي قيمة السمة هذه لأسباب سابقة على رقم تعريف قائمة تشغيل يشير إلى قائمة تشغيل فارغة، وبالتالي لا يمكن استرجاعها. |
contentDetails.relatedPlaylists.uploads |
string معرّف قائمة التشغيل التي تحتوي على الفيديوهات التي تم تحميلها إلى القناة استخدِم الطريقة videos.insert لتحميل فيديوهات جديدة والطريقة videos.delete لحذف الفيديوهات التي سبق تحميلها. |
statistics |
object يغلف الكائن statistics إحصاءات للقناة. |
statistics.viewCount |
unsigned long عدد مشاهدات القناة |
statistics.commentCount |
unsigned long تم إيقاف هذا الموقع نهائيًا. عدد التعليقات المنشورة على القناة |
statistics.subscriberCount |
unsigned long عدد المشتركين في القناة يتم تقريب هذه القيمة إلى ثلاثة. والأرقام المعنوية. يُرجى الاطّلاع على تاريخ المراجعة أو يمكنك الانتقال إلى مركز مساعدة YouTube للاطّلاع على المزيد من المعلومات. تفاصيل حول كيفية تقريب أعداد المشتركين. |
statistics.videoCount |
unsigned long عدد الفيديوهات العلنية التي تم تحميلها إلى القناة لاحظ أن القيمة تعكس عدد الفيديوهات العلنية للقناة فقط، حتى للمالكين. ويتوافق هذا السلوك مع الأعداد يظهر على موقع YouTube الإلكتروني |
topicDetails |
object يتضمن العنصر topicDetails معلومات حول المواضيع المرتبطة بالقناة.ملاحظة مهمة: اطّلِع على تعريف السمة topicDetails.topicIds[] وسجلّ النُسخ السابقة لمزيد من التفاصيل عن التغييرات ذات الصلة بأرقام تعريف المواضيع. |
topicDetails.topicIds[] |
list قائمة بمعرّفات المواضيع المرتبطة بالقناة. تم إيقاف هذا الموقع اعتبارًا من 10 تشرين الثاني (نوفمبر) 2016. وستبقى متاحة حتى 10 تشرين الثاني (نوفمبر) 2017. ملاحظة مهمة: بسبب إيقاف Freebase وFreebase API، بدأت معرِّفات المواضيع تعمل بشكل مختلف اعتبارًا من 27 شباط (فبراير) 2017. في ذلك الوقت، بدأت منصة YouTube بعرض مجموعة صغيرة من معرّفات المواضيع المنظّمة. |
topicDetails.topicCategories[] |
list قائمة بعناوين URL على ويكيبيديا تصف محتوى القناة. |
status |
object يتضمن العنصر status معلومات حول حالة خصوصية القناة. |
status.privacyStatus |
string حالة خصوصية القناة. في ما يلي القيم الصالحة لهذا الموقع:
|
status.isLinked |
boolean تشير بيانات القناة إلى ما إذا كانت بيانات القناة تحدد مستخدمًا مرتبط مسبقًا باسم مستخدم YouTube أو بحساب في Google+. يمتلك المستخدم الذي يملك أحد هذه الروابط هوية YouTube عامة، وهذا شرط أساسي لتنفيذ عدة إجراءات، مثل تحميل الفيديوهات. |
status.longUploadsStatus |
string يشير هذا العمود إلى ما إذا كانت القناة مؤهلة لتحميل فيديوهات تزيد مدّتها عن 15 دقيقة. لا يتم عرض هذه السمة إلا إذا وافق مالك القناة على طلب البيانات من واجهة برمجة التطبيقات. يمكنك الانتقال إلى مركز مساعدة YouTube للحصول على مزيد من المعلومات حول هذه الميزة. في ما يلي القيم الصالحة لهذا الموقع:
|
status.madeForKids |
boolean تشير هذه القيمة إلى ما إذا كانت القناة مصنّفة على أنّها موجّهة إلى الأطفال، وتتضمّن المحتوى الحالي "محتوى مخصّص للأطفال" حالة القناة. على سبيل المثال، قد تكون الحالة يتم تحديدها استنادًا إلى قيمة السمة selfDeclaredMadeForKids . يمكنك الاطّلاع على
يمكنك زيارة مركز مساعدة YouTube للاطّلاع على المزيد من المعلومات.
معلومات حول إعداد جمهور القناة أو الفيديوهات أو عمليات البث
|
status.selfDeclaredMadeForKids |
boolean في طلب channels.update ،
يسمح هذا الموقع لمالك القناة بتصنيف القناة على أنّها موجَّهة للأطفال. تشير رسالة الأشكال البيانية
إلا إذا سمح مالك القناة بطلب البيانات من واجهة برمجة التطبيقات.
|
brandingSettings |
object يتضمن العنصر brandingSettings معلومات حول العلامة التجارية للقناة. |
brandingSettings.channel |
object يتضمن العنصر channel خصائص العلامة التجارية لصفحة القناة. |
brandingSettings.channel.title |
string عنوان القناة يتضمن العنوان 30 حرفًا كحد أقصى. |
brandingSettings.channel.description |
string وصف القناة الذي يظهر في مربع معلومات القناة على صفحة القناة يمكن أن تتألف قيمة الموقع من 1,000 حرف كحدّ أقصى. |
brandingSettings.channel.keywords |
string الكلمات الرئيسية المرتبطة بقناتك القيمة هي قائمة سلاسل مفصولة بمسافات. القناة قد يتم اقتطاع الكلمات الرئيسية إذا تجاوزت الحد الأقصى المسموح به للطول وهو 500 حرف أو إذا كانت تحتوي على علامات اقتباس لم يتم تجاوزها ( " ). لاحظ أن الحرف 500
ليس حدًا لكل كلمة رئيسية، بل ليس حدًا لإجمالي طول جميع الكلمات الرئيسية. |
brandingSettings.channel.trackingAnalyticsAccountId |
string رقم تعريف حساب على "إحصاءات Google" تريد استخدامه لتتبّع عدد الزيارات إلى قناتك وقياسها |
brandingSettings.channel.unsubscribedTrailer |
string الفيديو الذي يجب تشغيله في وحدة الفيديو المميز ضمن طريقة عرض صفحة القناة للمشاهدين غير المشتركين فيها قد يرى المشاهدون المشتركون فيديو مختلفًا يُبرز الأنشطة الحديثة في القناة. يجب أن تكون قيمة الموقع، في حال تحديدها، معرّف فيديو YouTube الخاص بفيديو علني أو غير مُدرَج يملكه مالك القناة. |
brandingSettings.channel.defaultLanguage |
string لغة النص في السمتَين snippet.title وsnippet.description للمورد channel |
brandingSettings.channel.country |
string البلد الذي ترتبط به القناة عدِّل هذه السمة لضبط قيمة السمة snippet.country . |
brandingSettings.watch |
object ملاحظة: تم إيقاف هذا العنصر وجميع مواقعه الفرعية نهائيًا. يتضمن العنصر watch سمات الهوية البصرية للعلامة التجارية في صفحات المشاهدة الخاصة بفيديوهات القناة. |
brandingSettings.watch.textColor |
string ملاحظة: تم إيقاف هذا الموقع نهائيًا. لون النص لمنطقة العلامة التجارية لصفحة مشاهدة الفيديو |
brandingSettings.watch.backgroundColor |
string ملاحظة: تم إيقاف هذا الموقع نهائيًا. لون الخلفية لمساحة العلامة التجارية في صفحة مشاهدة الفيديو |
brandingSettings.watch.featuredPlaylistId |
string ملاحظة: تم إيقاف هذا الموقع نهائيًا. تعرض واجهة برمجة التطبيقات رسالة خطأ إذا حاولت ضبط قيمتها. |
brandingSettings.image |
object تم إيقاف هذا الموقع وكل مواقعه الفرعية نهائيًا. يتضمن العنصر image معلومات حول الصور التي يتم عرضها على صفحة القناة أو صفحات مشاهدة الفيديو. |
brandingSettings.image.bannerImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة البانر التي تظهر في صفحة القناة على موقع YouTube الإلكتروني. ويكون حجم الصورة 1060 بكسل × 175 بكسل. |
brandingSettings.image.bannerMobileImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة البانر التي تظهر على صفحة القناة في تطبيقات الأجهزة الجوّالة. ويكون حجم الصورة 640 بكسل × 175 بكسل. |
brandingSettings.image.watchIconImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL للصورة التي تظهر فوق مشغّل الفيديو. هذه صورة يبلغ ارتفاعها 25 بكسل وعرضها مرن لا يمكن أن يتجاوز 170 بكسل. في حال عدم تقديم هذه الصورة، سيظهر اسم قناتك بدلاً من صورة. |
brandingSettings.image.trackingImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لبكسل التتبع بمقاس 1 بكسل × 1 بكسل، ويمكن استخدامه لجمع إحصاءات حول مرات مشاهدة القناة أو صفحات الفيديو. |
brandingSettings.image.bannerTabletLowImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر منخفضة الدقة التي يتم عرضها على صفحة القناة في تطبيقات الأجهزة اللوحية. الحد الأقصى لحجم الصورة هو 1138 بكسل × 188 بكسل. |
brandingSettings.image.bannerTabletImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة البانر التي يتم عرضها على صفحة القناة في تطبيقات الأجهزة اللوحية. حجم الصورة 1707 بكسل × 283 بكسل. |
brandingSettings.image.bannerTabletHdImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في تطبيقات الأجهزة اللوحية. الحد الأقصى لحجم الصورة هو 2276 بكسل × 377 بكسل. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في تطبيقات الأجهزة اللوحية. الحد الأقصى لحجم الصورة هو 2560 بكسل × 424 بكسل. |
brandingSettings.image.bannerMobileLowImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر منخفضة الدقة التي يتم عرضها على صفحة القناة في تطبيقات الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 320 بكسل × 88 بكسل. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر متوسطة الدقة يتم عرضها على صفحة القناة في تطبيقات الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 960 × 263 بكسل. |
brandingSettings.image.bannerMobileHdImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في تطبيقات الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 1280 × 360 بكسل. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في تطبيقات الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 1440 بكسل × 395 بكسل. |
brandingSettings.image.bannerTvImageUrl |
string تم إيقاف هذه السمة نهائيًا. عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في تطبيقات التلفزيون. الحد الأقصى لحجم الصورة هو 2120 بكسل × 1192 بكسل. |
brandingSettings.image.bannerTvLowImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر منخفضة الدقة التي يتم عرضها على صفحة القناة في تطبيقات التلفزيون. الحد الأقصى لحجم الصورة هو 854 بكسل × 480 بكسل. |
brandingSettings.image.bannerTvMediumImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر بدرجة دقة متوسطة يتم عرضها على صفحة القناة في تطبيقات التلفزيون. الحد الأقصى لحجم الصورة هو 1280 بكسل × 720 بكسل. |
brandingSettings.image.bannerTvHighImageUrl |
string تم إيقاف هذا الموقع نهائيًا. عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في تطبيقات التلفزيون الحد الأقصى لحجم الصورة هو 1920 × 1080 بكسل. |
brandingSettings.image.bannerExternalUrl |
string تحدّد هذه السمة موقع صورة البانر التي يستخدمها YouTube لإنشاء الأحجام المختلفة لصور البانر للقناة. |
brandingSettings.hints[] |
list تم إيقاف هذا الموقع وكل مواقعه الفرعية نهائيًا. يحتوي العنصر hints على سمات إضافية خاصة بالعلامة التجارية. |
brandingSettings.hints[].property |
string تم إيقاف هذا الموقع نهائيًا. الموقع. |
brandingSettings.hints[].value |
string تم إيقاف هذا الموقع نهائيًا. قيمة الموقع. |
auditDetails |
object يضم العنصر auditDetails بيانات القناة التي ستقيّمها الشبكة المتعددة القنوات (MCN) عند تحديد ما إذا كنت تريد قبول قناة معيّنة أو رفضها. يُرجى العلم أنّ أي طلب من واجهة برمجة التطبيقات يسترد هذا الجزء من المورد يجب أن يقدّم رمزًا مميزًا للتفويض يحتوي على نطاق https://www.googleapis.com/auth/youtubepartner-channel-audit . بالإضافة إلى ذلك، يجب إبطال أي رمز مميّز يستخدم هذا النطاق عندما تقرِّر الشبكة المتعدّدة القنوات قبول القناة أو رفضها أو خلال أسبوعين من تاريخ إصدار الرمز المميّز. |
auditDetails.overallGoodStanding |
boolean يشير هذا الحقل إلى ما إذا كانت هناك أي مشاكل في القناة. في الوقت الحالي، يمثّل هذا الحقل نتيجة عملية AND المنطقية على السمات communityGuidelinesGoodStanding وcopyrightStrikesGoodStanding وcontentIdClaimsGoodStanding ، ما يعني أنّ قيمة هذا الموقع الإلكتروني هي true إذا كانت جميع هذه المواقع الأخرى تحتوي أيضًا على القيمة true . ومع ذلك، ستحتوي هذه السمة على القيمة false إذا كان أيٌّ من هذه السمات يحتوي على القيمة false . مع ذلك، تجدر الإشارة إلى أنّ المنهجية المستخدَمة لضبط قيمة هذا الموقع عرضة للتغيير. |
auditDetails.communityGuidelinesGoodStanding |
boolean تحدّد هذه العلامة ما إذا كانت القناة تلتزم بإرشادات المنتدى في YouTube. |
auditDetails.copyrightStrikesGoodStanding |
boolean يشير إلى ما إذا كانت القناة تلقّت أي إنذارات بسبب انتهاك حقوق الطبع والنشر. |
auditDetails.contentIdClaimsGoodStanding |
boolean تشير هذه العلامة إلى ما إذا كانت القناة تضم أي مطالبات لم يتم حلها. |
contentOwnerDetails |
object يتضمّن العنصر contentOwnerDetails بيانات القناة التي تظهر فقط لشريك YouTube الذي ربط القناة بحسابه في "إدارة المحتوى". |
contentOwnerDetails.contentOwner |
string رقم تعريف مالك المحتوى المرتبط بالقناة. |
contentOwnerDetails.timeLinked |
datetime تمثّل هذه السمة تاريخ ووقت ربط القناة بحساب مالك المحتوى. يتم تحديد القيمة بتنسيق ISO 8601. |
localizations |
object يتضمن العنصر localizations ترجمات للبيانات الوصفية للقناة. |
localizations.(key) |
object لغة البيانات الوصفية المترجمة والمرتبطة بالقيمة الرئيسية. القيمة هي سلسلة تحتوي على رمز اللغة BCP-47. |
localizations.(key).title |
string عنوان القناة المترجَم |
localizations.(key).description |
string وصف القناة المترجَم |