channel
وvideo الآن سمة تحدّد حالة "محتوى مخصّص للأطفال" الخاصة بالقناة أو الفيديو. تم أيضًا تعديل "بنود خدمة YouTube API" و"سياسات المطوّرين" في 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تمثّل هذه السمة علامة Etag لهذا المورد. |
id |
stringالمعرّف الذي يستخدمه YouTube لتحديد القناة بشكل فريد. |
snippet |
objectيحتوي العنصر snippet على تفاصيل أساسية حول القناة، مثل عنوانها ووصفها وصورها المصغّرة. |
snippet.title |
stringتمثّل هذه السمة عنوان القناة. |
snippet.description |
stringوصف القناة يبلغ الحد الأقصى لطول قيمة السمة 1000 حرف. |
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 للصورة للحصول على إرشادات إضافية حول استخدام عناوين URL للصور المصغّرة في تطبيقك، يمكنك الاطّلاع على تعريف السمة snippet.thumbnails. |
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مجموع عدد مرات مشاهدة جميع الفيديوهات بجميع التنسيقات في قناة معيّنة اعتبارًا من 24 أغسطس 2026، سيتم تعديل مقياس " |
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 على Wikipedia تصف محتوى القناة |
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وصف القناة الذي يظهر في مربّع معلومات القناة على صفحة قناتك يبلغ الحد الأقصى لطول قيمة السمة 1000 حرف. |
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وصف القناة المترجَم |