Watermarks: set

لتحميل صورة علامة مائية إلى YouTube وتعيينها لقناة.

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

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

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

طلب

طلب HTTP

POST https://www.googleapis.com/upload/youtube/v3/watermarks/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

المعلَمات

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

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

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

نص الطلب

قدم موردًا للعلامة المائية في نص الطلب.

الإجابة

إذا نجحت هذه الطريقة، فإنها تعرض رمز استجابة HTTP 204 (No Content).

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) imageFormatUnsupported تنسيق الصورة التي قدمتها غير مدعوم.
badRequest (400) imageTooTall الصورة التي قدمتها طويلة جدًا.
badRequest (400) imageTooWide الصورة التي قدمتها عريضة جدًا.
badRequest (400) mediaBodyRequired لا يتضمن الطلب محتوى الصورة.
forbidden (403) forbidden لا يمكن تعيين العلامة المائية للقناة المحددة. قد يكون الطلب غير مصرّح به بشكل صحيح أو تم ضبط المعلَمة channelId على قيمة غير صالحة.

جرِّب هذه الميزة الآن.

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