Thumbnails: set

تحميل صورة مصغّرة مخصّصة للفيديو إلى YouTube وضبطها للفيديو

تتيح هذه الطريقة تحميل الوسائط. يجب أن تتوافق الملفات المحمَّلة مع القيود التالية:

  • الحد الأقصى لحجم الملف: 50 ميغابايت
  • أنواع MIME المقبولة للوسائط: image/jpeg وimage/png وapplication/octet-stream

تأثير الحصة: تبلغ تكلفة الحصة عند إجراء طلب إلى هذه الطريقة حوالي 50 وحدة.

حالات الاستخدام الشائعة

طلب

طلب HTTP

POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set

التفويض

يتطلّب هذا الطلب الحصول على إذن باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

المعلمات

يسرد الجدول التالي المَعلمات التي يتيحها طلب البحث هذا. جميع المَعلمات المدرَجة هي مَعلمات طلب البحث.

المعلمات
المَعلمات المطلوبة
videoId string
تحدّد المَعلمة videoId معرّف فيديو على YouTube يتم توفير صورة مصغّرة مخصّصة للفيديو له.
المَعلمات الاختيارية
onBehalfOfContentOwner string
ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.

تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض الخاصة بالطلب تحدّد مستخدمًا لنظام إدارة محتوى YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون ويديرون العديد من القنوات المختلفة على YouTube. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد للمصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الفعلي الذي يصادق عليه المستخدم بمالك المحتوى المحدّد على YouTube.

نص الطلب

يحتوي نص الطلب على الصورة المصغّرة التي يتم تحميلها. لا يحتوي نص الطلب على مورد thumbnail.

الردّ

في حال نجاح العملية، يعرض هذا الإجراء نص استجابة بالبنية التالية:

{
  "kind": "youtube#thumbnailSetResponse",
  "etag": etag,
  "items": [
    thumbnail resource
  ]
}

الخصائص

يحدّد الجدول التالي السمات التي تظهر في هذا المورد:

الخصائص
kind string
يحدّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#thumbnailSetResponse.
etag etag
تمثّل هذه السمة علامة Etag لهذا المورد.
items[] list
قائمة بالصور المصغّرة

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) invalidImage محتوى الصورة المقدَّم غير صالح.
badRequest (400) mediaBodyRequired لا يتضمّن الطلب محتوى الصورة.
forbidden (403) forbidden لا يمكن ضبط الصورة المصغّرة للفيديو المحدّد. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
forbidden (403) forbidden لا يملك المستخدم الذي تمت مصادقته أذونات لتحميل الصور المصغّرة المخصّصة للفيديوهات وضبطها.
notFound (404) videoNotFound يتعذّر العثور على الفيديو الذي تحاول إدراج صورة مصغّرة له. تحقَّق من قيمة مَعلمة videoId في الطلب للتأكّد من صحتها.
tooManyRequests (429) uploadRateLimitExceeded حمّلت القناة عددًا كبيرًا جدًا من الصور المصغّرة مؤخرًا. يُرجى إعادة المحاولة لاحقًا.

جرِّبها الآن.

استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة.