Watermarks

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

الطُرق

تتوافق واجهة برمجة التطبيقات مع الطرق التالية لموردَين (watermarks):

set (المجموعة)

يتم تحميل صورة علامة مائية إلى 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 المرتبط بالقناة التي تتضمّن صورة العلامة المائية