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 معلومات حول الوقت الذي ستظهر فيه صورة العلامة المائية للقناة أثناء تشغيل الفيديو. هذا العنصر مطلوب عند استدعاء watermarks.set.
timing.type string
طريقة التوقيت التي تحدّد وقت عرض صورة العلامة المائية أثناء تشغيل الفيديو. يجب استخدام هذه السمة عند استدعاء watermarks.set.

. القيم الصالحة هي:
  • ‫offsetFromStart: يمثّل الحقل offsetMs إزاحة من بداية الفيديو.
  • ‫offsetFromEnd: يمثّل الحقل offsetMs إزاحة من نهاية الفيديو.
timing.offsetMs unsigned long
إزاحة الوقت، محدّدة بالملي ثانية، تحدّد وقت ظهور المنتج المُروَّج له أثناء تشغيل الفيديوهات. يجب استخدام هذه السمة عند طلب watermarks.set. عندما تكون قيمة type هي offsetFromEnd، يجب أن تكون قيمة offsetMs 1000 ملي ثانية على الأقل.
timing.durationMs unsigned long
تمثّل هذه السمة المدة الزمنية بالملي ثانية التي يجب أن تظهر فيها صورة العلامة المائية. هذه السمة اختيارية. في حال تحديدها، يكون الحد الأدنى للمدة 1000 ملي ثانية. عندما تكون قيمة type هي offsetFromEnd، يجب ألا تتجاوز قيمة durationMs العدد offsetMs.
position object
تم إيقافها نهائيًا: تم إيقاف العنصر position نهائيًا ويتجاهله YouTube. تظهر العلامات المائية دائمًا في أعلى يسار مشغّل الفيديو.
imageUrl string
تمثّل هذه السمة عنوان URL لصورة العلامة المائية الخاصة بالقناة. سينشئ YouTube عنوان URL هذا وسيعرضه في الردّ من واجهة برمجة التطبيقات على طلب watermark.set.
imageBytes bytes
حجم صورة العلامة المائية بالبايت
targetChannelId string
معرّف قناة على YouTube التي ترتبط بها صورة العلامة المائية.