وثائق مطوري البرامج في YouTube

يوفّر YouTube عددًا من واجهات برمجة التطبيقات والأدوات التي تتيح لك تضمين وظائف YouTube في موقعك الإلكتروني وتطبيقاتك.

مشغّل YouTube والتطبيقات المصغّرة

مرجع IFrame Player API

استخدام مشغّل مضمَّن لتشغيل الفيديوهات مباشرةً في تطبيقك

مكتبة أدوات iOS المساعدة

تضمين مشغّل YouTube IFrame في تطبيق iOS

مَعلمات مشغّل YouTube

تخصيص تجربة التشغيل باستخدام مجموعة متنوعة من إعدادات المشغّل

زر الاشتراك في YouTube

يمكن للمستخدمين الاشتراك في قناتك على YouTube بنقرة واحدة.

بيانات YouTube ومراجعه

استخدِم الجدول التالي للعثور على YouTube API الذي يناسب احتياجاتك على أفضل وجه:

واجهة برمجة التطبيقات	النوع	الوصف	المستخدمون الأساسيون	المصادقة
ميزات تطبيق YouTube
YouTube Data API	علني	إضافة ميزات تطبيق YouTube إلى تطبيقك، بما في ذلك إمكانية تحميل الفيديوهات وإنشاء قوائم تشغيل وإدارتها وتعديل البيانات الوصفية للفيديوهات وغير ذلك	المطوّرون	مفتاح واجهة برمجة التطبيقات / OAuth 2.0
‫YouTube Live Streaming API	علني	جدولة أحداث البث المباشر على YouTube وإدارة أحداث بث الفيديو من الناحية الفنية، تشكّل هذه الواجهة جزءًا من YouTube Data API.	المطوّرون	مفتاح واجهة برمجة التطبيقات / OAuth 2.0
"إحصاءات YouTube" وإعداد التقارير
YouTube Analytics API	علني	لوحات البيانات في الوقت الفعلي طلبات البحث المستهدَفة حسب الديموغرافيات ومصادر الزيارات والتفاعل	الشبكات المتعدّدة القنوات وشركات الإنتاج	OAuth 2.0
YouTube Reporting API	علني	البيانات الضخمة تنزيل مجمّع لمجموعات البيانات الكبيرة لإعداد التقارير المالية وتحليل الأداء	محلّلو البيانات	OAuth 2.0
ملكية المحتوى وإدارته على YouTube
YouTube Content ID API	مقتصر على شركاء YouTube (التفاصيل)	إدارة الحقوق إنشاء مواد عرض مجمّعة وتعديل السياسات وإدارة المطالبات	مالكو المحتوى	OAuth 2.0

البيانات المتعددة الأبعاد في واجهات برمجة تطبيقات YouTube

النوع	واجهة برمجة تطبيقات Content ID	Data API	Analytics API	Reporting API
بيانات الإيرادات	✘	✘	✔	دقيق
بيانات مواد العرض/الملكية	✔	✘	✔	✔
بيانات ISRC UPC	✔	✘	✘	✔
بيانات قائمة التشغيل	✘	دقيق	✔	✔
البيانات الديمغرافية	✘	✘	✔	✔
بيانات السياسة	دقيق	✘	✘	✘
بيانات الترجمة والشرح والصورة المصغّرة	✘	✔	✘	✘

تفاصيل السمات

يقدّم هذا الجدول تفصيلاً دقيقًا للبيانات المتاحة في كل واجهة برمجة تطبيقات.

ملاحظة: تتيح Reporting API إمكانية التمييز بين نوعَي المحتوى "محتوى من إنشاء المستخدمين" و"الفيديوهات الموسيقية المميّزة"، وهو أمر بالغ الأهمية لاحتساب العائدات.

النوع	السمة	واجهة برمجة تطبيقات Content ID	Data API	Analytics API	Reporting API
DateTime	الفترات الزمنية	✔	✔	✔	✔
معرّفات الكيانات	معرّف الفيديو	✔	✔	✔	✔
	معرّف القناة	✔	✔	✔	✔
	رقم تعريف مادة العرض	✔	✘	✘	✔
	ISRC	✘	✘	✘	✔
	رقم تعريف الشريك المخصّص	✘	✘	✘	✔
	معرّف مالك المحتوى	✔	✔	✘	✔
	الرمز العالمي للمنتج (UPC)	✔	✘	✘	✔
شرائح التشغيل	مصدر الزيارات	✘	✘	✔	دقيق
	نوع المحتوى (محتوى من إنشاء المستخدمين / فيديو ترويجي للموسيقى)	✘	✘	✘	✔
	النظام الأساسي	✘	✘	✔	✔
	نظام التشغيل	✘	✘	✔	✔
	قوائم التشغيل	✘	دقيق	✔	✔
	موقع التشغيل	✘	✘	✔	✔
شرائح المستخدمين	الفئة العمرية	✘	✘	✔	✔
	الجنس	✘	✘	✔	✔
	البلد	✘	✘	✔	✔
	المنطقة	✘	✔	✘	✘
المقاييس	المشاهدات	✘	✔	✔	✔
	العروض المطوّلة للإعلانات	✘	✘	✔	✔
	المطالبات	✔	✘	✘	دقيق
	وقت المشاهدة	✘	✘	✔	دقيق
	المثير للإعجاب / غير المثير للإعجاب	✘	دقيق	✔	✔
	الاحتفاظ بالجمهور	✘	✘	✔	✘
	البطاقات المعروضة/التي تم النقر عليها	✘	✘	✔	✔
	عدد مرّات عرض/النقر على شاشات النهاية	✘	✘	✔	✔
	المشتركون	✘	دقيق	✔	✔
	تمّت مشاركة الإذن	✘	✘	✔	✔
	مرات الظهور	✘	✘	✔	✔
	الإيرادات	✘	✘	✔	دقيق
	التقارير المالية الخاصة بالخدمات التي تعرض إعلانات	✘	✘	✔	دقيق
	التقارير المالية للاشتراكات	✘	✘	✔	دقيق
	التعليقات التوضيحية	✘	✘	✔	✔
	مقاييس Shorts	✘	✘	✔	✔
وظائف المنصة	الأنشطة	✘	دقيق	✘	✘
	الترجمة والشرح	✘	✔	✘	✔
	القنوات	✔	دقيق	✘	✔
	السياسات	دقيق	✔	✘	✘
	التعليقات	✘	دقيق	✔	✔
	i18nRegions	✘	✔	✘	✘
	i18nLanguages	✘	✔	✘	✘
	الأعضاء	✘	✔	✘	✘
	قوائم التشغيل	✘	دقيق	✔	✔
	بحث	✘	✔	✘	✘
	الاشتراكات	✘	✔	✔	✔
	الصور المصغّرة	✘	✔	✘	✘
	الفيديوهات	✔	دقيق	✔	✔
	الملكية	دقيق	✘	✘	✘
	المراجع	دقيق	✘	✘	✔
	العلامات المائية	✘	دقيق	✘	✘
MetaData	الفنّان	✔	✔	✘	✔
	الوصف	✔	✔	✘	✘
	وقت النشر	✘	✔	✘	✔
	العنوان	✘	✔	✘	✔
	اللغة	✘	دقيق	✔	✔
	تقييم المحتوى	✘	دقيق	✘	✘
	تفاصيل المحتوى	✘	دقيق	✘	✘