تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

خدمات واجهة برمجة تطبيقات YouTube - الحد الأدنى المطلوب من الوظائف

ملاحظة: يقدّم دليل الامتثال لـ سياسات المطوّرين في YouTube الجديد إرشادات وأمثلة لمساعدتك في ضمان تقيّد عملاء API بأجزاء معيّنة من بنود خدمات YouTube API و سياساتها (بنود خدمة واجهة برمجة التطبيقات). وتقدّم هذه الإرشادات معلومات مفصّلة حول آلية تنفيذ YouTube لجوانب معيّنة من بنود الخدمة لواجهة برمجة التطبيقات، ولكنها لا تحل محل أي مستندات حالية.

يحدّد هذا المستند الحد الأدنى من المتطلبات الوظيفية لبرامج واجهة برمجة التطبيقات التي تنفّذ ميزات معينة في خدمات واجهة برمجة تطبيقات YouTube أو تتيح الوصول إليها (يُشار إليها بـ "عملاء واجهة برمجة التطبيقات").

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

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

بالإضافة إلى المتطلبات الواردة في هذا المستند، ننصحك بشدة باتّباع أفضل الممارسات الموضّحة في سياسات خدمات واجهة برمجة تطبيقات YouTube ومناقشتها في موضع آخر في مستندات خدمات واجهة برمجة تطبيقات YouTube. وتساعد هذه الممارسات، حتى وإن لم تكن مطلوبة بشدة، عملاء API على التعافي بسرعة أكبر من الأخطاء وتحسين استخدام حصصهم في حال استخدام خدمات YouTube API التي تخصّص الحصة. وفي الوقت نفسه، تساعد هذه الممارسات في ضمان سلامة منظومة YouTube المتكاملة، والأهم من ذلك كله، تقديم أفضل تجربة ممكنة لمستخدمي برامج واجهة برمجة التطبيقات وتطبيقات YouTube.

مشغّل YouTube المضمّن وتشغيل الفيديو

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

حجم مشغّل YouTube المضمّن

يجب أن تحتوي المشغّلات المضمّنة على إطار عرض 200 x 200 بكسل على الأقل. إذا كان المشغل يعرض عناصر تحكم، فيجب أن تكون كبيرة بما يكفي لعرض عناصر التحكم بالكامل بدون تصغير إطار العرض إلى أقل من الحد الأدنى للحجم. نوصي بأن يكون عرض المشغلات 16:9 480 بكسل على الأقل وطول 270 بكسل.

التشغيل التلقائي وعمليات التشغيل النصية

يتناول هذا القسم عمليات التشغيل التلقائية. وتنطبق أيضًا على مشغّلات YouTube المضمّنة التي تستخدم معلَمة مشغّل autoplay أو تبدأ التشغيل التلقائي آليًا باستخدام خدمة واجهة برمجة تطبيقات مشغّل YouTube IFrame Player أو خدمة واجهة برمجة تطبيقات مشغّل YouTube لنظام التشغيل Android أو خدمة أخرى لواجهة برمجة تطبيقات YouTube.

يجب أن تبدأ المشغلات المضمنة التي تشغل الفيديو تلقائيًا التشغيل فورًا عندما يتم تحميل الصفحة أو بعد أن يصبح المشغل المضمن مرئيًا بالكامل. ومع ذلك، يجب ألا يبدأ عميل واجهة برمجة التطبيقات التشغيل التلقائي حتى يكون المشغل مرئيًا ويكون أكثر من نصف المشغل مرئيًا على الصفحة أو الشاشة.
يجب ألا تحتوي الصفحة أو الشاشة على أكثر من مشغّل YouTube يشغّل المحتوى تلقائيًا في الوقت نفسه.
يجب ألا يقل عرض أي صورة مصغّرة على YouTube تبدأ عملية تشغيل عن 120 بكسل وألا يقل طولها عن 70 بكسل.

سمات مشغّل YouTube

يتم تحديد سمات ومعلمات مشغّل YouTube، بما في ذلك مظهر علامة YouTube التجارية في المشغّل، في مستندات ومواصفات واجهة برمجة تطبيقات YouTube (https://developers.google.com/youtube). يجب عدم إجراء تغييرات على مشغّل YouTube لم يتم وصفها صراحةً في وثائق واجهة برمجة التطبيقات.

التراكبات والإطارات

يجب ألا تعرض تراكبات أو إطارات أو عناصر مرئية أخرى أمام أي جزء من مشغل YouTube المضمن، بما في ذلك عناصر التحكم في المشغل. وبالمثل، يجب عدم استخدام تراكبات أو إطارات أو عناصر مرئية أخرى لإخفاء أي جزء من المشغل المضمن، بما في ذلك عناصر التحكم في المشغل.

عدد تمريرات الماوس

يجب عدم استخدام تمرير الماوس أو أحداث اللمس على مشغل YouTube لبدء أي إجراء نيابةً عن المستخدم، مثل فتح نافذة أو الاشتراك في قناة.

تحميل الفيديوهات

إذا كان عملاء API يسمحون للمستخدمين بتحميل المحتوى إلى أنظمة أساسية متعددة، يجب أن يتمكن المستخدمون من تحديد وإلغاء تحديد الأنظمة الأساسية التي يريدون تحميل مقاطع الفيديو إليها.

متطلبات البيانات

يجب على برامج واجهة برمجة التطبيقات التي تمكّن المستخدمين من تحميل مقاطع الفيديو إلى YouTube تمكين المستخدمين من تعيين القيم في القائمة التالية. أية خصائص غير مدرجة اختيارية.

	الاسم	الوصف
خصائص الموارد
	`snippet.title`	Required. عنوان الفيديو. يعرض YouTube رسالة خطأ إذا كانت القيمة تتجاوز 100 حرف. يتيح YouTube استخدام جميع أحرف UTF-8 الصالحة باستثناء `<` و`>`.
	`snippet.description`	Required. وصف الفيديو. يعرض YouTube رسالة خطأ إذا كانت القيمة تتجاوز 5000 بايت. يتيح YouTube استخدام جميع أحرف UTF-8 الصالحة باستثناء `<` و`>`.
	`status.privacyStatus`	Required. إعداد خصوصية الفيديو. يجب أن يتمكن المستخدمون من اختيار ما إذا كان الفيديو الذي تم تحميله عامًا أو خاصًا أو غير مدرج.
معلَمات الطلبات
	`onBehalfOfContentOwnerChannel`	مطلوبة بشروط. إذا كانت بيانات اعتماد التفويض للطلب تحدد مالك محتوى وتم تعيين المعلمة `onBehalfOfContentOwner`، فيجب أن يتمكن مستخدم واجهة برمجة التطبيقات أيضًا من تحديد قناة YouTube التي يتم تحميل الفيديو إليها.

عرض التعليقات

	الاسم	الوصف
خصائص الموارد
	`snippet.textDisplay`	Required. نص التعليق. يجب على عميل واجهة برمجة التطبيقات (أ) إما عرض النص الكامل لتعليق أو رد على تعليق، أو (ب) اقتطاع النص وتوفير طريقة للمشاهد للوصول بسهولة إلى النص الكامل من النسخة المقتطعة. ينطبق هذا الشرط على جميع التعليقات والردود على التعليقات، بغض النظر عن نوع المورد الذي ترتبط به التعليقات (الفيديوهات والقنوات وما إلى ذلك). يُرجى ملاحظة أن قيمة السمة `snippet.topLevelComment` للمورد `commentThread` هي عبارة عن مورد `comment` وقائمة `replies.comments[]`. وبالتالي، ينطبق هذا الشرط أيضًا على الخاصيتين `snippet.topLevelComment.snippet.textDisplay` و`replies.comments[].snippet.textDisplay`.
	`snippet.title` (`channel`)	مطلوبة (اقتراح). عنوان القناة. إذا كان التعليق متعلقًا بقناة، يجب أن يعرض عميل واجهة برمجة التطبيقات اسم القناة. إذا كان التعليق يتعلق بفيديو، يجب أن يعرض عميل واجهة برمجة التطبيقات اسم القناة التي حمّلت الفيديو.
	`snippet.title` (`video`)	مطلوبة بشروط (اقتراح). عنوان الفيديو. يجب عرض هذه القيمة إذا كان التعليق مرتبطًا بفيديو.
	`snippet.moderationStatus`	مطلوبة بشروط. إذا كانت قيمة المعلَمة `moderationStatus` في طلب البيانات من واجهة برمجة التطبيقات هي `heldForReview` أو `likelySpam`، يجب أن تحدّد الشاشة تلك الحالة بوضوح باستخدام قيمة الخاصية، أو لغة مشابهة (مثل "هذا التعليق في انتظار المراجعة")، أو عنوان (مثلاً، "في انتظار المراجعة")، أو لغة أخرى لا لبس فيها. تتيح طريقة `commentThreads.list` إمكانية استرداد التعليقات استنادًا إلى حالة الإشراف.

إضافة تعليقات

	الاسم	الوصف
خصائص الموارد
	`snippet.title` (`channel`)	Required. عنوان القناة. إذا كان المستخدم يضيف تعليقًا حول قناة، يجب أن يعرض عميل واجهة برمجة التطبيقات اسم القناة. إذا كان المستخدم يضيف تعليقًا عن فيديو، يجب أن يعرض عميل واجهة برمجة التطبيقات اسم القناة التي حمّلت الفيديو.
	`snippet.title` (`video`)	Required. إذا كان المستخدم يضيف تعليقًا عن فيديو، يجب أن يعرض عميل واجهة برمجة التطبيقات عنوان الفيديو.
متطلبات أخرى
	`Comment author's channel name`	Required. يجب أن يحدد عميل واجهة برمجة التطبيقات بوضوح حساب مستخدم YouTube الذي سيتم إسناد التعليق إليه. إذا حددت بيانات اعتماد التفويض الخاصة بالطلب مالك محتوى وتم تعيين المعلمة `onBehalfOfContentOwner`، فيجب أن يتمكن مستخدم واجهة برمجة التطبيقات أيضًا من تحديد قناة YouTube التي سيتم إسناد التعليق إليها.

إضافة ردود على التعليقات

	الاسم	الوصف
خصائص الموارد
	`snippet.textDisplay`	Required. نص التعليق. يجب أن يعرض عميل واجهة برمجة التطبيقات نص التعليق الذي يردّ عليه المستخدم وفقًا للقواعد المحدّدة في قسم عرض التعليقات في هذا المستند.
	`snippet.title` (`channel`)	Required. عنوان القناة. إذا كان المستخدم يرد على تعليق بشأن قناة، يجب أن يعرض عميل واجهة برمجة التطبيقات اسم القناة. إذا كان المستخدم يرد على تعليق بشأن مقطع فيديو، يجب أن يعرض عميل واجهة برمجة التطبيقات اسم القناة التي حمّلت الفيديو.
	`snippet.title` (`video`)	Required. إذا كان المستخدم يرد على تعليق بشأن مقطع فيديو، يجب أن يعرض عميل واجهة برمجة التطبيقات عنوان الفيديو.
متطلبات أخرى
	`Comment author's channel name`	Required. يجب أن يحدد عميل واجهة برمجة التطبيقات بوضوح حساب مستخدم YouTube الذي سيُنسب إليه الرد على التعليق. إذا حددت بيانات اعتماد التفويض الخاصة بالطلب مالك محتوى وتم تعيين المعلمة `onBehalfOfContentOwner`، فيجب أن يتمكن مستخدم واجهة برمجة التطبيقات أيضًا من تحديد قناة YouTube التي سيُنسب إليها الرد على التعليق.

تعديل الردود على التعليقات أو حذفها

	الاسم	الوصف
خصائص الموارد
	`snippet.textDisplay`	Required. نص التعليق. يجب أن يعرض عميل واجهة برمجة التطبيقات نص التعليق الذي يجري المستخدم تعديله أو يحذفه وفقًا للقواعد المحدّدة في قسم عرض التعليقات في هذا المستند.
	`snippet.title` (`channel`)	Required. عنوان القناة. إذا كان المستخدم يعدّل أو يحذف تعليقًا بشأن قناة، يجب أن يعرض عميل واجهة برمجة التطبيقات اسم القناة. إذا كان المستخدم يعدّل أو يحذف تعليقًا بشأن فيديو، يجب أن يعرض عميل واجهة برمجة التطبيقات اسم القناة التي حمّلت الفيديو.
	`snippet.title` (`video`)	Required. إذا كان المستخدم يجري تعديلاً أو حذفًا لتعليق على فيديو، يجب أن يعرض عميل واجهة برمجة التطبيقات عنوان الفيديو.
متطلبات أخرى
	`Comment author's channel name`	Required. يجب أن يحدد عميل واجهة برمجة التطبيقات بوضوح حساب مستخدم YouTube الذي يُنسب التعليق إليه.

حظر مستخدم من المحادثة المباشرة (أو إزالة حظره)

	الاسم	الوصف
خصائص الموارد
	`snippet.title` (`channel`)	Required. اسم قناة YouTube المحظورة أو غير المحظورة. بالإضافة إلى ذلك، يجب أن يرتبط الاسم بالقناة أو يجب أيضًا عرض عنوان URL للقناة.
متطلبات أخرى
	اسم قناة كاتب التعليق	Required. يجب أن يحدد عميل واجهة برمجة التطبيقات بوضوح حساب مستخدم YouTube المستخدم لإضافة الحظر أو إزالته.