تحميل صورة علامة مائية إلى YouTube وضبطها للقناة
تتيح هذه الطريقة تحميل الوسائط. يجب أن تتوافق الملفات المحمَّلة مع القيود التالية:
- الحد الأقصى لحجم الملف: 10 ميغابايت
- أنواع MIME المقبولة للوسائط:
image/jpegوimage/pngوapplication/octet-stream
تأثير الحصة: تبلغ تكلفة الحصة لمكالمة هذه الطريقة 50 وحدة.
الطلب
طلب HTTP
POST https://www.googleapis.com/upload/youtube/v3/watermarks/set
التفويض
يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية. للاطّلاع على مزيد من المعلومات عن المصادقة والتفويض، يُرجى الاطّلاع على مقالة تنفيذ التفويض باستخدام بروتوكول OAuth 2.0.
| النطاق |
|---|
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 |
المعلمات
يعرض الجدول التالي المَعلمات التي يتيح طلب البحث استخدامها. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.
| المعلمات | ||
|---|---|---|
| المَعلمات المطلوبة | ||
channelId |
stringتحدد المَعلمة channelId معرّف قناة YouTube التي يتم توفير العلامة المائية لها. |
|
| المَعلمات الاختيارية | ||
onBehalfOfContentOwner |
stringملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube. تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض في الطلب تحدّد مستخدمًا في نظام إدارة المحتوى في YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون ويديرون العديد من القنوات المختلفة على YouTube. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب أن يكون حساب نظام إدارة المحتوى الذي يستخدمه المستخدم لمصادقته مرتبطًا بحساب مالك المحتوى المحدّد على YouTube. |
|
نص الطلب
قدِّم مورد watermark في نص الطلب.
الردّ
في حال نجاح هذه الطريقة، يتم عرض رمز حالة HTTP 204 No Content.
الأخطاء
يحدِّد الجدول التالي رسائل الخطأ التي يمكن أن تعرِضها واجهة برمجة التطبيقات استجابةً لطلب موجَّه إلى هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على YouTube Data API - Errors.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
badRequest (400) |
imageFormatUnsupported |
تنسيق الصورة التي قدّمتها غير متوافق. |
badRequest (400) |
imageTooTall |
الصورة التي قدّمتها طويلة جدًا. |
badRequest (400) |
imageTooWide |
الصورة التي قدّمتها عريضة جدًا. |
badRequest (400) |
mediaBodyRequired |
لا يتضمّن الطلب محتوى الصورة. |
forbidden (403) |
forbidden |
لا يمكن ضبط العلامة المائية للقناة المحدّدة. قد لا يكون الطلب مفوَّضًا بشكل صحيح، أو تم ضبط المَعلمة channelId على قيمة غير صالحة. |
جرّب الآن
استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات والاستجابة.