Watermarks

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

الطُرق

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

set
تحميل صورة علامة مائية إلى YouTube وتعيينها لقناة
unset
يحذف صورة العلامة المائية الخاصة بالقناة. التجربة الآن

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

يعرض بنية 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 التي يرتبط بها شعار العلامة المائية