تتيح لك واجهة برمجة التطبيقات للبيانات في YouTube دمج الوظائف التي يتم تنفيذها عادةً على موقع YouTube الإلكتروني في موقعك الإلكتروني أو تطبيقك. تحدّد القوائم أدناه الأنواع المختلفة من الموارد التي يمكنك استردادها باستخدام واجهة برمجة التطبيقات. توفّر واجهة برمجة التطبيقات أيضًا طرقًا لإدراج العديد من هذه الموارد أو تعديلها أو حذفها.
يشرح هذا الدليل المرجعي كيفية استخدام واجهة برمجة التطبيقات لتنفيذ كل هذه العمليات. يتم تنظيم الدليل حسب نوع المورد. يمثل المورد نوعًا من العناصر التي تشكّل جزءًا من تجربة YouTube، مثل فيديو أو قائمة تشغيل أو اشتراك. لكل نوع من أنواع الموارد، يسرد الدليل تمثيلاً واحدًا أو أكثر للبيانات، ويتم تمثيل الموارد ككائنات JSON. يسرد الدليل أيضًا طريقة واحدة متوافقة أو أكثر (LIST
وPOST
وDELETE
وما إلى ذلك) لكل نوع من أنواع الموارد، ويوضّح كيفية استخدام هذه الطرق في تطبيقك.
طلب بيانات من واجهة برمجة التطبيقات
تنطبق المتطلبات التالية على طلبات YouTube Data API:
-
يجب أن يحدّد كل طلب مفتاح واجهة برمجة التطبيقات (مع المعلَمة
key
) أو يقدم رمزًا مميزًا لـ OAuth 2.0. مفتاح واجهة برمجة التطبيقات متاح في جزء الوصول إلى واجهة برمجة التطبيقات في Play Console لمشروعك. -
يجب إرسال رمز تفويض مميز لكل طلب إدراج أو تعديل أو حذف. يجب أيضًا إرسال رمز تفويض مميز لأي طلب يسترد البيانات الخاصة للمستخدم الذي تمت مصادقته.
إضافةً إلى ذلك، قد تتيح بعض طرق واجهة برمجة التطبيقات لاسترداد الموارد استخدام المعلَمات التي تتطلب إذنًا أو قد تحتوي على بيانات وصفية إضافية عندما يتم السماح بالطلبات. على سبيل المثال، قد يشتمل أيضًا طلب استرداد مقاطع فيديو حمّلها أحد المستخدمين على مقاطع فيديو خاصة إذا كان الطلب مصرّحًا به من قِبل هذا المستخدم المحدد.
-
تتوافق واجهة برمجة التطبيقات مع بروتوكول مصادقة 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 تمثّل هذه الطريقة أوّل خطوتَين في عملية مكوّنة من ثلاث خطوات لتعديل صورة البانر للقناة:
|
أقسام القناة
يتضمن مورد 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 أيضًا قوائم التشغيل لتحديد مجموعات خاصة من الفيديوهات لإحدى القنوات، مثل:
- من الفيديوهات المحمّلة
- من الفيديوهات التي حصلت على تقييم إيجابي (تم إبداء الإعجاب بها)
- سجلّ المشاهدة
- المشاهدة لاحقًا
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 |
حذف صورة العلامة المائية للقناة |