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

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

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

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

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

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

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

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

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

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

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

التشغيل التلقائي وعمليات التشغيل المبرمَجة

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

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

سمات مشغّل YouTube

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

العناصر المركّبة والإطارات

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

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

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

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

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

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

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

	الاسم	الوصف
سمات الموارد
	`snippet.title`	مَعلمة مطلوبة. عنوان الفيديو تعرِض YouTube خطأً إذا تجاوزت القيمة 100 حرف. تتيح منصة YouTube جميع أحرف UTF-8 الصالحة باستثناء `<` و`>`.
	`snippet.description`	مَعلمة مطلوبة. وصف الفيديو تعرِض YouTube خطأً إذا تجاوزت القيمة 5,000 بايت. تتيح منصة 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 المستخدَم لإضافة الحظر أو إزالته.