Watermarks

ويحدد مورد watermark صورة يتم عرضها أثناء تشغيل فيديوهات قناة محددة. ويمكنك أيضًا تحديد القناة التي سيتم ربط الصورة بها، بالإضافة إلى تفاصيل التوقيت التي تحدد وقت ظهور العلامة المائية أثناء تشغيل الفيديو ومدتها.

الطُرق

تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد watermarks:

ضبط
يحمّل صورة علامة مائية إلى YouTube ويضبطها للقناة.
غير محدَّد
لحذف صورة العلامة المائية لقناة معيّنة التجربة الآن

تمثيل الموارد

تعرض بنية JSON أدناه تنسيق مورد watermarks:

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": string
}

أماكن إقامة

يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:

أماكن إقامة
timing object
يعرض العنصر timing معلومات حول الوقت الذي تظهر فيه العلامة المائية للقناة خلال تشغيل الفيديو.
timing.type string
طريقة التوقيت التي تحدّد وقت عرض صورة العلامة المائية أثناء تشغيل الفيديو. إذا كانت القيمة offsetFromStart، سيمثّل الحقل offsetMs إزاحة من بداية الفيديو. إذا كانت القيمة offsetFromEnd، سيمثّل الحقل offsetMs إزاحة من نهاية الفيديو.
timing.offsetMs unsigned long
معادلة الوقت المحدّدة بالمللي ثانية والتي تحدِّد وقت ظهور العنصر الذي يتم الترويج له أثناء عمليات تشغيل الفيديو. تحدّد قيمة السمة type ما إذا كان يتم قياس الإزاحة من بداية الفيديو أو نهايته.
timing.durationMs unsigned long
المدة الزمنية بالملي ثانية التي يجب أن تعرضها صورة العلامة المائية.
position object
يتم تضمين معلومات حول الموضع المكاني في الفيديو حيث يتم عرض صورة العلامة المائية في العنصر position.
position.type string
الطريقة التي يتم بها وضع العنصر الذي يتم الترويج له في مشغّل الفيديو.

القيم الصالحة لهذه السمة هي:
  • زاوية
position.cornerPosition string
زاوية المشغّل التي سيظهر فيها العنصر الذي يتم الترويج له. يظهر العنصر دائمًا في أعلى يسار المشغّل.

القيم الصالحة لهذه السمة هي:
  • topRight
imageUrl string
عنوان URL لصورة العلامة المائية للقناة. ستنشئ منصة YouTube عنوان URL هذا وتعيده في استجابة واجهة برمجة التطبيقات لطلب watermark.set.
imageBytes bytes
حجم صورة العلامة المائية بالبايت.
targetChannelId string
معرّف قناة YouTube للقناة التي ترتبط بها صورة العلامة المائية.