يحمّل صورة علامة مائية إلى 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 الذي يتصرّف نيابةً عن مالك المحتوى المحدَّد في قيمة المَعلمة. هذه المعلمة مخصصة لشركاء المحتوى في 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.