LiveCuepoints

تم إيقاف المورد liveCuepoint والطريقة liveCuepoints.insert واستبدالهما بالطريقة liveBroadcasts.cuepoint.

يدرج مورد liveCuepoint نقطة انطلاق في بث الفيديو الذي تم بثه، ما قد يؤدي إلى ظهور فاصل إعلاني.

ملاحظة: يُعدّ أمر واجهة برمجة التطبيقات هذا جزءًا من واجهة برمجة تطبيقات Content ID في YouTube وهو مختلف عن متطلبات إدارة موارد liveBroadcast وliveStream.

الطُرق

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

إدراج
إدراج نقطة تلميح في بث مباشر. في الوقت الحالي، يجب تفويض الطلبات المرتبطة بهذه الطريقة بواسطة حساب مرتبط بمالك محتوى على YouTube. التجربة الآن

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

تعرض بنية JSON التالية تنسيق مورد liveCuepoints:

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "cueType": string,
    "durationSecs": unsigned integer
  }
}

أماكن إقامة

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

أماكن إقامة
id string
قيمة تحدّدها منصة YouTube لتحديد نقطة العرض بشكل فريد
kind string
نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى موارد liveCuepoint، تكون القيمة هي youtubePartner#liveCuepoint.
broadcastId string
المعرّف الذي يعيّنه YouTube لتحديد البث الذي يتمّ فيه عرض المعرّف الفريد.
settings object
يعرّف الكائن settings إعدادات نقطة الوصول.
settings.offsetTimeMs long
تحدّد هذه القيمة نقطة زمنية في الفيديو يُفترض فيها أن يرى المشاهدون إعلانًا أو قائمة إعلانات ضمن البث المباشر. تحدد قيمة الخاصية معادلة زمنية بالمللي ثانية، من بداية ساحة مشاركات الشاشة. على الرغم من أنه يتم قياسها بالمللي ثانية، تكون القيمة في الواقع رقمًا تقريبيًا، وسيدرج YouTube النقطة الأساسية بأقرب وقت ممكن لذلك الوقت. يجب عدم تحديد قيمة لهذه المعلّمة إذا لم يتضمّن البث مجموعة بث.

القيمة التلقائية لهذا الموقع هي 0، ما يعني أنّه يجب إدراج رمز الاستجابة السريعة في أقرب وقت ممكن. وإذا لم يتأخر البث المباشر، ستكون 0 هي القيمة الصالحة الوحيدة. ومع ذلك، إذا تأخر بث البث، يمكن أن تحدد قيمة الخاصية الوقت الذي يجب إدراج نقطة العرض فيه. اطلع على دليل الخطوات الأولى للحصول على مزيد من التفاصيل.

ملاحظة: إذا كانت مرحلة البث المباشر في مرحلة البث، يتم قياس الإزاحة من وقت بدء مرحلة الاختبار.
settings.walltime datetime
تحدّد هذه القيمة وقت الساعة الذي يجب إدراج نقطة عرض الحائط فيه. يتم تحديد القيمة بتنسيق ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).

تعرض واجهة برمجة التطبيقات رسالة خطأ إذا حاول طلب إدراج تلميح يتم من خلاله تحديد قيمة لهذا الموقع وخاصية settings.offsetTimeMs.
settings.cueType string
هو نوع نقطة العرض. راجع دليل الخطوات الأولى للحصول على شرح عن الأنواع المختلفة من نقاط المشاهدة. يمكنك أيضًا الاطّلاع على مستند مدة البث لمعرفة أفضل الممارسات حول إدراج نقاط المشاهدة أثناء البث.

القيم الصالحة لهذا الموقع هي:
  • ad
settings.durationSecs unsigned integer
مدة عرض الإشعار بالثواني. يجب تحديد هذه القيمة إذا كان cueType هو ad ويتم تجاهلها بخلاف ذلك.