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