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

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

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

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

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

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

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

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

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

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

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

التشغيل التلقائي وعمليات التشغيل المستندة إلى نص برمجي

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

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

سمات مشغِّل YouTube

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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