Watermarks: set

تحميل صورة علامة مائية إلى 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 في نص الطلب. يحتوي المرجع على السمات التالية:

  • ‫timing (object، مطلوبة): تتضمّن توقيت عرض العلامة المائية.
    • ‫timing.type (string، مطلوبة): اضبطها على offsetFromStart أو offsetFromEnd.
    • ‫timing.offsetMs (unsigned long، مطلوبة): إزاحة البدء بالملّي ثانية يجب أن تكون 1000 ملي ثانية على الأقل إذا كانت قيمة type هي offsetFromEnd.
    • ‫timing.durationMs (unsigned long، اختياري): المدة المرئية بالملّي ثانية (الحد الأدنى 1000 ملّي ثانية). إذا كانت قيمة type هي offsetFromEnd، يجب ألا تتجاوز offsetMs.
  • ‫targetChannelId (string، اختياري): معرّف القناة على YouTube التي ترتبط بها العلامة المائية. في حال حذفها، سيتم الربط بالقناة المحدّدة بواسطة channelId.
  • ‫position (object، متوقّف نهائيًا): يتجاهله YouTube. يتم دائمًا وضع العلامات المائية في أعلى يسار الشاشة.

الردّ

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

الأخطاء

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

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

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

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