API Reference

تتيح لك YouTube Data API دمج الوظائف التي يتم تنفيذها عادةً على موقع YouTube الإلكتروني في موقعك الإلكتروني أو تطبيقك. تحدد القوائم أدناه الأنواع المختلفة من الموارد التي يمكنك استردادها باستخدام واجهة برمجة التطبيقات. وتتيح واجهة برمجة التطبيقات أيضًا طرقًا لإدراج العديد من هذه الموارد أو تحديثها أو حذفها.

يوضح هذا الدليل المرجعي كيفية استخدام واجهة برمجة التطبيقات لتنفيذ كل هذه العمليات. يتم تنظيم الدليل حسب نوع المورد. يمثل المورد نوعًا من العناصر التي يشكّل جزءًا من تجربة YouTube، مثل فيديو أو قائمة تشغيل أو اشتراك. بالنسبة إلى كل نوع من أنواع الموارد، يدرج الدليل تمثيلاً واحدًا أو أكثر للبيانات، ويتم تمثيل الموارد ككائنات JSON. يسرد هذا الدليل أيضًا طريقة واحدة أو أكثر متوافقة (LIST وPOST وDELETE وما إلى ذلك) لكل نوع من أنواع المراجع، كما يوضِّح كيفية استخدام هذه الطرق في تطبيقك.

طلب البيانات من واجهة برمجة التطبيقات

تنطبق المتطلبات التالية على طلبات YouTube Data API:

1. يجب أن يحدّد كل طلب مفتاح واجهة برمجة التطبيقات (مع المعلَمة key) أو يوفّر رمز OAuth 2.0 المميز. يتوفر مفتاح واجهة برمجة التطبيقات في جزء الوصول إلى واجهة برمجة التطبيقات على وحدة تحكم مطوّر البرامج لمشروعك.

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

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

3. تتوافق واجهة برمجة التطبيقات مع بروتوكول مصادقة OAuth 2.0. يمكنك توفير رمز OAuth 2.0 المميز بإحدى الطريقتين التاليتين:

   • استخدام معلَمة طلب البحث access_token على النحو التالي: ?access_token=oauth2-token
   • استخدام عنوان HTTP Authorization على النحو التالي: Authorization: Bearer oauth2-token

   يمكن العثور على التعليمات الكاملة لتنفيذ مصادقة OAuth 2.0 في تطبيقك في دليل المصادقة.

أنواع الموارد

الأنشطة

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

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /activities	عرض قائمة بأحداث أنشطة القناة التي تطابق معايير الطلب. على سبيل المثال، يمكنك استرداد الأحداث المرتبطة بقناة معيّنة أو بقناة المستخدم الخاصة.
insert	POST /activities	ملاحظة: تم إيقاف هذه الطريقة نهائيًا ولم تعُد متاحة.

الترجمة والشرح

يمثّل المرجع caption مسار ترجمة على YouTube. يرتبط مسار الترجمة بفيديو واحد فقط على YouTube.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
delete	DELETE /captions	لحذف مسار الترجمة والشرح المحدد
download	GET /captions/id	لتنزيل مسار تسمية توضيحية. يتمّ عرض مسار الترجمة بتنسيقه الأصلي ما لم يحدّد الطلب قيمة للمَعلمة tfmt وبلغتها الأصلية، إلّا إذا حدّد الطلب قيمة للمَعلمة tlang.
insert	POST /captions	لتحميل مسار تسمية توضيحية.
list	GET /captions	عرض قائمة بمسارات الترجمة المرتبطة بفيديو محدد. يُرجى العِلم أنّ استجابة واجهة برمجة التطبيقات لا تتضمّن الشرح الفعلي وأنّ طريقة captions.download تتيح إمكانية استرداد مسار الترجمة.
update	PUT /captions	لتعديل مسار الترجمة عند تحديث مسار ترجمة، يمكنك تغيير حالة مسودّة المسار أو تحميل ملف ترجمة جديد للمسار أو تنفيذ الإجراءين معًا.

ChannelBanners

يحتوي مورد channelBanner على عنوان URL الذي ستستخدمه لضبط صورة محمَّلة حديثًا كصورة بانر لقناة.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
insert	POST /channelBanners/insert	يحمِّل صورة بانر القناة إلى YouTube. تمثّل هذه الطريقة أول خطوتَين في عملية من ثلاث خطوات لتعديل صورة البانر لقناة. يمكنك استدعاء الطريقة channelBanners.insert لتحميل بيانات الصورة الثنائية إلى YouTube. يجب أن تكون نسبة العرض إلى الارتفاع للصورة 16:9 وألا تقلّ عن 2048x1152 بكسل. ننصحك بتحميل صورة بحجم 2560 × 1440 بكسل. استخرِج قيمة السمة url من الردّ الذي تعرضه واجهة برمجة التطبيقات في الخطوة 1. عليك استدعاء الإجراء "channels.update" لتعديل إعدادات العلامة التجارية للقناة. اضبط قيمة السمة brandingSettings.image.bannerExternalUrl على عنوان URL الذي حصلت عليه في الخطوة 2.

ChannelSections

يتضمن مورد channelSection معلومات حول مجموعة الفيديوهات التي اختارت القناة إبرازها. على سبيل المثال، يمكن أن يعرض القسم أحدث الفيديوهات التي حمّلتها إلى قناة، أو الفيديوهات الأكثر رواجًا، أو الفيديوهات من قائمة تشغيل واحدة أو أكثر.

يُرجى العلم أنّ أقسام القناة لا تكون مرئية إلا إذا كانت القناة تعرض المحتوى في إحدى طرق عرض التصفّح (وليس في طريقة عرض الخلاصة). للسماح للقناة بعرض المحتوى في طريقة عرض التصفّح، اضبط السمة brandingSettings.channel.showBrowseView على true للقناة المحدّدة.

يمكن للقناة إنشاء 10 أرفف كحد أقصى.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
delete	DELETE /channelSections	حذف قسم في القناة
insert	POST /channelSections	لإضافة قسم قناة إلى قناة المستخدم الذي تمت المصادقة عليه يمكن للقناة إنشاء 10 رفوف كحد أقصى.
list	GET /channelSections	تعرض قائمة تضم channelSection من الموارد التي تطابق معايير طلب واجهة برمجة التطبيقات.
update	PUT /channelSections	تعديل قسم في القناة

القنوات

يحتوي مورد channel على معلومات حول قناة على YouTube.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /channels	عرض مجموعة من موارد channel بقيمة صفر أو أكثر تتطابق مع معايير الطلب.
update	PUT /channels	تعديل البيانات الوصفية لقناة يُرجى العلم أنّ هذه الطريقة تتيح حاليًا التعديلات على العنصرَين brandingSettings وinvideoPromotion لمورد channel وخصائصهما الفرعية.

CommentThreads

يحتوي مورد commentThread على معلومات حول سلسلة التعليقات في YouTube التي تتألف من تعليق وردود من المستوى الأعلى، إن توفّرت، على ذلك التعليق. يمكن أن يمثّل مورد commentThread التعليقات حول فيديو أو قناة.

يكون كل من التعليق ذي المستوى الأعلى والردود عبارة عن موارد comment مضمّنة في مورد commentThread. لا يحتوي المورد commentThread بالضرورة على جميع الردود على تعليق معيّن، ويجب استخدام الإجراء comments.list إذا أردت استرداد كل الردود على تعليق معيّن. يُرجى العِلم أيضًا أنّه لا يمكن الردّ على بعض التعليقات.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /commentThreads	تعرض قائمة بسلاسل التعليقات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات.
insert	POST /commentThreads	لإنشاء تعليق جديد ذي مستوى أعلى. لإضافة رد على تعليق حالي، استخدِم طريقة comments.insert بدلاً من ذلك.

التعليقات

يحتوي مورد comment على معلومات حول تعليق واحد على YouTube. يمكن أن يمثّل مورد comment تعليقًا حول فيديو أو قناة. بالإضافة إلى ذلك، يمكن أن يكون التعليق تعليقًا من مستوى أعلى أو ردًا على تعليق من المستوى الأعلى.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /comments	تعرض قائمة بالتعليقات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات.
setModerationStatus	POST /comments/setModerationStatus	لضبط حالة الإشراف على تعليق واحد أو أكثر. يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات مصرّحًا به من مالك القناة أو الفيديو المرتبط بالتعليقات.
insert	POST /comments	لإنشاء رد على تعليق حالي ملاحظة: لإنشاء تعليق من المستوى الأعلى، يمكنك استخدام الإجراء commentThreads.insert.
markAsSpam	POST /comments/markAsSpam	ملاحظة: تم إيقاف هذه الطريقة نهائيًا ولم تعُد متاحة.
delete	DELETE /comments	حذف تعليق
update	PUT /comments	لتعديل التعليق

GuideCategories

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

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /guideCategories	عرض قائمة بالفئات التي يمكن ربطها بقنوات YouTube.

I18nLanguages

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

يحدّد كل مورد من "i18nLanguage" رمزًا للغة واسمًا. يمكن استخدام رمز اللغة كقيمة للمَعلمة hl عند طلب بيانات من واجهة برمجة تطبيقات، مثل videoCategories.list وguideCategories.list.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /i18nLanguages	عرض قائمة بلغات التطبيقات المتوافقة مع موقع YouTube الإلكتروني

I18nRegions

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

يحدّد كل مورد من "i18nRegion" رمز المنطقة واسمًا. يمكن استخدام رمز المنطقة كقيمة للمَعلمة regionCode عند استدعاء طُرق لواجهة برمجة التطبيقات، مثل search.list وvideos.list وactivities.list وvideoCategories.list.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /i18nRegions	عرض قائمة بمناطق المحتوى المتوافقة مع موقع YouTube الإلكتروني

الأعضاء

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

للحصول على مزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /members	يعرض هذا القسم الأعضاء (المعروفين سابقًا باسم "الجهات الراعية") لقناة. يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات معتمَدًا من قِبل مالك القناة.

MembershipsLevels

يحدّد مورد membershipsLevel مستوى السعر لصانع المحتوى الذي فوّض الإذن بطلب البيانات من واجهة برمجة التطبيقات.

للحصول على مزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /membershipsLevels	عرض مجموعة من موارد membershipsLevel أو أكثر من صفر أو أكثر تملكها القناة التي سمحت بإرسال طلب البيانات من واجهة برمجة التطبيقات. يتم عرض المستويات بترتيب العرض الضمني.

PlaylistItems

يحدّد مورد playlistItem موردًا آخر، مثل فيديو، في قائمة تشغيل. بالإضافة إلى ذلك، يحتوي مورد playlistItem على تفاصيل حول المورد المضمّن وترتبط بشكل خاص بكيفية استخدام هذا المورد في قائمة التشغيل تلك.

تستخدم منصة YouTube أيضًا قائمة تشغيل لتحديد قائمة الفيديوهات التي تم تحميلها في القناة، ويمثّل كل playlistItem في تلك القائمة فيديو واحدًا تم تحميله. يمكنك استرداد رقم تعريف قائمة التشغيل لهذه القائمة من channel resource لقناة معيّنة. يمكنك بعد ذلك استخدام الإجراء playlistItems.list من أجل القائمة.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
delete	DELETE /playlistItems	لحذف عنصر قائمة تشغيل.
insert	POST /playlistItems	لإضافة مورد إلى قائمة تشغيل.
list	GET /playlistItems	تعرِض مجموعة من عناصر قائمة التشغيل التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. يمكنك استرداد كل عناصر قائمة التشغيل في قائمة تشغيل محدّدة أو استرداد عنصر واحد أو أكثر من عناصر قائمة التشغيل باستخدام المعرّفات الفريدة لكلّ منها.
update	PUT /playlistItems	لتعديل عنصر قائمة تشغيل. على سبيل المثال، يمكنك تعديل موضع العنصر في قائمة التشغيل.

قوائم التشغيل

يمثّل المرجع playlist قائمة تشغيل على YouTube. قائمة التشغيل هي مجموعة من الفيديوهات التي يمكن مشاهدتها بشكل تسلسلي ومشاركتها مع مستخدمين آخرين. يمكن أن تحتوي قائمة التشغيل على ما يصل إلى 200 فيديو، ولا يحدّ YouTube من عدد قوائم التشغيل التي ينشئها كل مستخدم. وتكون قوائم التشغيل مرئية بشكل علني للمستخدمين الآخرين تلقائيًا، ولكن يمكن أن تكون قوائم التشغيل علنية أو خاصة.

تستخدم منصة YouTube أيضًا قوائم التشغيل لتحديد مجموعات خاصة من الفيديوهات لإحدى القنوات، مثل:

• الفيديوهات المحمّلة
• فيديوهات ذات تقييم إيجابي (إبداء الإعجاب)
• سجلّ المشاهدة
• المشاهدة لاحقًا

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

يمكنك بعد ذلك استخدام الإجراء playlistItems.list لاسترداد أي من هذه القوائم. يمكنك أيضًا إضافة عناصر أو إزالتها من تلك القوائم من خلال الاتصال بطريقتَي playlistItems.insert وplaylistItems.delete.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
delete	DELETE /playlists	لحذف قائمة تشغيل.
list	GET /playlists	يعرض مجموعة من قوائم التشغيل التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. على سبيل المثال، يمكنك استرداد جميع قوائم التشغيل التي يملكها المستخدم الذي تمت المصادقة عليه، أو يمكنك استرداد قائمة تشغيل واحدة أو أكثر حسب المعرّفات الفريدة لكل منها.
insert	POST /playlists	ينشئ قائمة تشغيل.
update	PUT /playlists	لتعديل قائمة التشغيل على سبيل المثال، يمكنك تغيير عنوان قائمة تشغيل أو وصفها أو حالة خصوصيتها.

بحث

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

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /search	عرض مجموعة من نتائج البحث التي تتطابق مع مَعلمات طلب البحث المحدّدة في طلب البيانات من واجهة برمجة التطبيقات. تحدِّد مجموعة نتائج البحث تلقائيًا موارد video وchannel وplaylist المطابقة، ولكن يمكنك أيضًا إعداد طلبات البحث لاسترداد نوع محدّد فقط من الموارد.

الاشتراكات

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

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
delete	DELETE /subscriptions	يؤدي هذا الإجراء إلى حذف اشتراك.
insert	POST /subscriptions	لإضافة اشتراك لقناة المستخدم الذي تمت المصادقة عليه
list	GET /subscriptions	عرض موارد الاشتراك التي تطابق معايير طلب واجهة برمجة التطبيقات

الصور المصغّرة

يحدّد مورد thumbnail الأحجام المختلفة للصور المصغّرة المرتبطة بمورّد. يرجى مراعاة الخصائص التالية للصور المصغرة:

• السمة snippet.thumbnails في المورد هي كائن يحدِّد الصور المصغّرة المتاحة لهذا المورد.
• يحتوي مورد thumbnail على سلسلة من العناصر. يشير اسم كل عنصر (default أو medium أو high أو ما إلى ذلك) إلى حجم الصورة المصغّرة.
• قد تتيح الأنواع المختلفة من الموارد استخدام أحجام مختلفة للصور المصغّرة.
• قد تحدد أنواع الموارد المختلفة أحجامًا مختلفة للصور المصغّرة التي تحمل الاسم نفسه. على سبيل المثال، يبلغ حجم الصورة المصغّرة default لمورد video عادةً 120 × 90 بكسل، بينما يكون حجم الصورة المصغّرة default لمورد channel بحجم 88 × 88 بكسل.
• قد يكون للموارد من النوع نفسه أحجام مختلفة للصور المصغّرة لبعض الصور، وذلك استنادًا إلى درجة دقة الصورة الأصلية أو المحتوى الذي يتم تحميله على YouTube. على سبيل المثال، قد يتيح الفيديو بدقة عالية عرض صور مصغّرة بدرجة دقة أعلى من الفيديوهات التي ليست عالية الدقة.
• كل عنصر يحتوي على معلومات حول حجم صورة مصغّرة له السمة width والسمة height. ومع ذلك، قد لا يتم عرض خصائص العرض والارتفاع لتلك الصورة.
• إذا لم تتطابق صورة مصغّرة تم تحميلها مع الأبعاد المطلوبة، سيتم تغيير حجم الصورة لتتطابق مع الحجم الصحيح بدون تغيير نسبة العرض إلى الارتفاع. لم يتم اقتصاص الصورة، ولكنها قد تحتوي على أشرطة سوداء بحيث يكون حجمها صحيحًا.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
set	POST /thumbnails/set	يحمِّل صورة مصغّرة مخصّصة للفيديو إلى YouTube ويضبطها كفيديو.

VideoAbuseReportReasons

يحتوي مرجع videoAbuseReportReason على معلومات عن سبب الإبلاغ عن فيديو لأنّه يتضمّن محتوى مسيئًا. عندما يستدعي تطبيقك طريقة videos.reportAbuse للإبلاغ عن فيديو مسيء، يستخدم الطلب المعلومات الواردة من أحد موارد videoAbuseReportReason لتحديد سبب الإبلاغ عن الفيديو.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /videoAbuseReportReasons	يمكنك استرداد قائمة بالأسباب التي يمكن استخدامها للإبلاغ عن فيديوهات مسيئة.

VideoCategories

يحدّد مورد videoCategory فئة كان أو يمكن ربطها بفيديوهات تم تحميلها.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /videoCategories	عرض قائمة بالفئات التي يمكن ربطها بفيديوهات YouTube.

الفيديوهات

يمثّل المرجع video فيديو على YouTube.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
insert	POST /videos	يحمِّل فيديو إلى YouTube ويحدّد البيانات الوصفية للفيديو اختياريًا.
list	GET /videos	عرض قائمة بالفيديوهات التي تطابق مَعلمات طلب البيانات من واجهة برمجة التطبيقات.
delete	DELETE /videos	حذف فيديو على YouTube
update	PUT /videos	لتعديل البيانات الوصفية لفيديو معيّن.
rate	POST /videos/rate	إضافة تقييم "أعجبني" أو "لم يعجبني" إلى فيديو أو إزالة تقييم منه
getRating	GET /videos/getRating	لاسترداد التقييمات التي منحها المستخدم المصرح له لقائمة من مقاطع الفيديو المحددة.
reportAbuse	POST /videos/reportAbuse	الإبلاغ عن فيديو يتضمّن محتوًى مسيئًا

العلامات المائية

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

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
set	POST /watermarks/set	يحمّل صورة علامة مائية إلى YouTube ويضبطها للقناة.
unset	POST /watermarks/unset	لحذف صورة العلامة المائية للقناة