تتيح واجهة برمجة التطبيقات الآن تصنيف قناتك أو
فيديوهاتك على أنّها "مخصّصة للأطفال". بالإضافة إلى ذلك، تتضمّن الآن المرجعَين
channel
وvideo
سمة تحدد حالة "محتوى مخصّص للأطفال"
لهذه القناة أو هذا الفيديو. تم أيضًا تعديل بنود الخدمة وسياسات المطوّرين الخاصة بخدمات YouTube API
في 10 كانون الثاني (يناير) 2020. لمزيد من المعلومات، يُرجى الاطّلاع على سجلّات المراجعات الخاصة بخدمة YouTube Data API وبنود خدمة YouTube API Services.
يحتوي مورد 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 وصف القناة الحد الأقصى لطول قيمة السمة هو 1,000 حرف. |
snippet.customUrl |
string عنوان URL المخصّص للقناة. يوضّح مركز مساعدة YouTube متطلبات الأهلية للحصول على عنوان URL مخصّص، بالإضافة إلى كيفية إعداد عنوان 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 عدد مرّات مشاهدة القناة |
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 وصف القناة الذي يظهر في مربّع معلومات القناة على صفحتها الحد الأقصى لطول قيمة السمة هو 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 وصف القناة المترجَم |