API Reference

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

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

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

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

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

  1. استخدِم الطريقة channelBanners.insert لتحميل بيانات الصورة الثنائية إلى YouTube. يجب أن تكون الصورة بنسبة عرض إلى ارتفاع 16:9 وألا يقلّ حجمها عن 2048 × 1152 بكسل. ننصحك بتحميل صورة بحجم 2560 بكسل × 1440 بكسل.
  2. استخرِج قيمة السمة url من الاستجابة التي تعرضها واجهة برمجة التطبيقات في الخطوة 1.
  3. استخدِم الطريقة 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. قائمة التشغيل هي مجموعة من الفيديوهات التي يمكن مشاهدتها بالتسلسل ومشاركتها مع مستخدمين آخرين. تكون قوائم التشغيل علنية تلقائيًا للمستخدمين الآخرين، ولكن يمكن أن تكون علنية أو خاصة.

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