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. تمثّل هذه الطريقة أول خطوتَين في عملية من ثلاث خطوات لتعديل صورة البانر لقناة.

  1. يمكنك استدعاء الطريقة channelBanners.insert لتحميل بيانات الصورة الثنائية إلى YouTube. يجب أن تكون نسبة العرض إلى الارتفاع للصورة 16:9 وألا تقلّ عن 2048x1152 بكسل. ننصحك بتحميل صورة بحجم 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. قائمة التشغيل هي مجموعة من الفيديوهات التي يمكن مشاهدتها بشكل تسلسلي ومشاركتها مع مستخدمين آخرين. يمكن أن تحتوي قائمة التشغيل على ما يصل إلى 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 لحذف صورة العلامة المائية للقناة