API Reference

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

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

استدعاء واجهة برمجة التطبيقات

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

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

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	تعرض هذه الطريقة قائمة بأحداث نشاط القناة التي تطابق معايير الطلب. على سبيل المثال، يمكنك استرداد الأحداث المرتبطة بقناة معيّنة أو بقناة المستخدم نفسه.

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

يمثّل المورد 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.
delete	DELETE /comments	يحذف هذا الإجراء تعليقًا.
update	PUT /comments	تعديل تعليق

I18nLanguages

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

يحدّد كل مورد i18nLanguage رمز لغة واسمًا. يمكن استخدام رمز اللغة كقيمة للمَعلمة hl عند طلب طرق واجهة برمجة التطبيقات، مثل videoCategories.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. قائمة التشغيل هي مجموعة من الفيديوهات التي يمكن مشاهدتها بالتسلسل ومشاركتها مع مستخدمين آخرين. تكون قوائم التشغيل مرئية بشكل علني للمستخدمين الآخرين تلقائيًا، ولكن يمكن أن تكون علنية أو خاصة.

يستخدم 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	يحذف هذا الإجراء صورة العلامة المائية الخاصة بالقناة.