API Reference

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

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

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

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

  1. يجب أن يحدّد كل طلب مفتاح واجهة برمجة التطبيقات (مع المعلَمة key) أو يقدم رمزًا مميزًا لـ OAuth 2.0. مفتاح واجهة برمجة التطبيقات متاح في جزء الوصول إلى واجهة برمجة التطبيقات في Play 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 يحدّث مسار الترجمة والشرح. عند تحديث مسار ترجمة وشرح، يمكنك تغيير حالة مسودّة المسار أو تحميل ملف ترجمة جديد للمقطع الصوتي أو تحميل كلّ منهما.

إعلانات البانر للقناة

يتضمن مورد 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.

أقسام القناة

يتضمن مورد 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 وخصائصهما الفرعية.

سلاسل التعليقات

يحتوي مورد 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 لتعديل تعليق

فئات الأدلة

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

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

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

لغات I18nLanguage

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

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

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

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

مناطق I18n

يحدد مورد 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 يسرد أعضاء القناة (المعروف سابقًا باسم "الجهات الراعية") ويجب أن يكون مالك القناة قد وافق على طلب البيانات من واجهة برمجة التطبيقات.

مستويات الاشتراكات

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

لمزيد من المعلومات حول هذا المورد، يُرجى الاطّلاع على تمثيل المورد وقائمة السمات.

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

عناصر قائمة التشغيل

يحدّد مورد 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 x 90 بكسل، بينما يبلغ حجم الصورة المصغّرة default لمورد channel عادةً 88 x 88 بكسل.
  • قد تظل الموارد من النوع نفسه تحتوي على أحجام مختلفة للصور المصغّرة لبعض الصور، وذلك استنادًا إلى درجة دقة الصورة الأصلية أو المحتوى الذي يتم تحميله على YouTube. على سبيل المثال، قد يتيح الفيديو بدقة عالية استخدام صور مصغّرة ذات دقة أعلى من الصور المصغَّرة غير العالية الدقة.
  • كل عنصر يحتوي على معلومات حول حجم صورة مصغّرة يتضمّن السمة width والسمة height. ومع ذلك، قد لا يتم عرض خصائص العرض والارتفاع لهذه الصورة.
  • إذا لم تتطابق صورة مصغّرة تم تحميلها مع الأبعاد المطلوبة، سيتم تغيير حجم الصورة لتتطابق مع الحجم الصحيح بدون تغيير نسبة العرض إلى الارتفاع لها. لم يتم اقتصاص الصورة، لكن قد تحتوي على أشرطة سوداء بحيث يكون حجمها صحيحًا.

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

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

سبب الإبلاغ عن إساءة استخدام الفيديو

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

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

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

فئات الفيديو

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