Thumbnails: set

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

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

  • الحد الأقصى لحجم الملف: 2 ميغابايت
  • أنواع 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
علامة هذا المرجع.
items[] list
قائمة بالصور المصغّرة

الأخطاء

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

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

تجربة

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