تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

LiveBroadcasts

تتيح واجهة برمجة التطبيقات الآن إمكانية وضع علامة "محتوى مخصّص للأطفال" على أحداث البث المباشر، ويحتوي مورد liveBroadcast الآن على سمة تحدّد حالة "محتوى مخصّص للأطفال" لبث مباشر معيّن. تم أيضًا تعديل بنود الخدمة وسياسات المطوّرين الخاصة بخدمات واجهة برمجة تطبيقات YouTube في 10 كانون الثاني (يناير) 2020. للمزيد من المعلومات، يُرجى الاطّلاع على سجلّات المراجعات الخاصة بملف YouTube Live Streaming API Service وبنود الخدمة الخاصة بخدمات YouTube API.

يمثّل مرجع liveBroadcast حدثًا سيتم بثّه على YouTube باستخدام فيديو مباشر.

الطُرق

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

list: يعرض قائمة بأحداث البث على YouTube التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
إدراج: إنشاء بثّ التجربة الآن
تعديل: تعديل بث على سبيل المثال، يمكنك تعديل إعدادات البث المحدّدة في عنصر contentDetails لمصدر liveBroadcast. جرِّب ذلك الآن.
حذف: لحذف بث التجربة الآن
bind: يربط بثًا على YouTube ببث آخر أو يزيل ربطًا حاليًا بين بث وبث آخر. يمكن ربط البث بمجموعة بث فيديو واحدة فقط، ولكن يمكن ربط مجموعة بث فيديو بأكثر من بث واحد. التجربة الآن
transition: يؤدي هذا الإجراء إلى تغيير حالة بث مباشر على YouTube وبدء أي عمليات مرتبطة بالحالة الجديدة. على سبيل المثال، عند تغيير حالة البث إلى testing، تبدأ منصة YouTube في نقل الفيديو إلى مجموعة بث المراقبة الخاصة بهذا البث. قبل استدعاء هذه الطريقة، عليك التأكّد من أنّ قيمة السمة status.streamStatus للبث المرتبط بالبث هي active. جرِّب ذلك الآن.
نقطة البداية: تُستخدَم هذه الميزة لإدراج نقطة بداية في بث مباشر. قد يؤدي نقطة البدء إلى تشغيل فاصل إعلاني.

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

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

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
      "cuepointSchedule": {
        "enabled": boolean,
        "pauseAdsUntil": datetime,
        "scheduleStrategy": string,
        "repeatIntervalSecs": unsigned integer,
      }
    }
  }
}

الخصائص

يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:

الخصائص
`kind`	`string` لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة `youtube#liveBroadcast`.
`etag`	`etag` رقم تعريف Etag لهذا المرجع.
`id`	`string` المعرّف الذي تحدّده منصة YouTube لتحديد البث بشكل فريد
`snippet`	`object` يحتوي العنصر `snippet` على تفاصيل أساسية عن الحدث، بما في ذلك عنوانه ووصفه ووقت بدئه وانتهائه.
`snippet.publishedAt`	`datetime` التاريخ والوقت اللذان تمت فيهما إضافة البث إلى جدول البث المباشر على YouTube. يتم تحديد القيمة بتنسيق ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`).
`snippet.channelId`	`string` المعرّف الذي يستخدمه YouTube لتحديد القناة التي تنشر البث بشكلٍ فريد
`snippet.title`	`string` عنوان البث يُرجى العلم أنّ البث يمثّل فيديو واحدًا على YouTube بالضبط. يمكنك ضبط هذا الحقل من خلال تعديل مورد البث أو من خلال ضبط حقل `title` لمورد الفيديو المقابل.
`snippet.description`	`string` وصف البث كما هو الحال مع الحقل `title`، يمكنك ضبط هذا الحقل من خلال تعديل مورد البث أو من خلال ضبط الحقل `description` لمصدر الفيديو المقابل.
`snippet.thumbnails`	`object` خريطة للصور المصغّرة المرتبطة بالبث بالنسبة إلى كل عنصر مُدمَج في هذا العنصر، يكون المفتاح هو اسم الصورة المصغّرة، والقيمة هي عنصر يحتوي على معلومات أخرى عن الصورة المصغّرة.
`snippet.thumbnails.(key)`	`object` في ما يلي قيم المفاتيح الصالحة: `default`: الصورة المصغّرة التلقائية يبلغ عرض الصورة المصغّرة التلقائية للفيديو أو المرجع الذي يشير إلى فيديو، مثل عنصر قائمة تشغيل أو نتيجة بحث، 120 بكسل وارتفاعها 90 بكسل. يبلغ العرض التلقائي للصورة المصغّرة للقناة 88 بكسل والارتفاع 88 بكسل. ‫`medium`: نسخة بدرجة دقة أعلى من الصورة المصغّرة بالنسبة إلى الفيديو (أو المرجع الذي يشير إلى فيديو)، يكون عرض هذه الصورة 320 بكسل وارتفاعها 180 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 240 بكسل وارتفاعها 240 بكسل. ‫`high`: نسخة عالية الدقة من الصورة المصغّرة بالنسبة إلى الفيديو (أو المرجع الذي يشير إلى فيديو)، يكون عرض هذه الصورة 480 بكسل وارتفاعها 360 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 800 بكسل وارتفاعها 800 بكسل.
`snippet.thumbnails.(key).url`	`string` عنوان URL للصورة.
`snippet.thumbnails.(key).width`	`unsigned integer` عرض الصورة.
`snippet.thumbnails.(key).height`	`unsigned integer` ارتفاع الصورة.
`snippet.scheduledStartTime`	`datetime` التاريخ والوقت المُجدوَلان لبدء البث يتم تحديد القيمة بتنسيق ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`). يتيح "استوديو YouTube" إنشاء بث بدون تحديد وقت بدء. في هذه الحالة، يبدأ البث عندما يبدأ صاحب القناة البث. بالنسبة إلى هذه البثّات، تتطابق قيمة `datetime` مع وقت بداية حقبة نظام التشغيل Unix، ولا يمكن تغيير هذه القيمة باستخدام واجهة برمجة التطبيقات أو في "استوديو اليوتيوب".
`snippet.scheduledEndTime`	`datetime` التاريخ والوقت المحدَّد لانتهاء البث يتم تحديد القيمة بتنسيق ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`). إذا لم يحدِّد مورد `liveBroadcast` قيمة لهذه السمة، سيتم جدولة البث لمواصلته إلى أجل غير مسمى. وبالمثل، إذا لم تحدّد قيمة لهذا السمة، سيتعامل YouTube مع البث كما لو كان سيستمر إلى أجل غير مسمى.
`snippet.actualStartTime`	`datetime` التاريخ والوقت اللذان بدأ فيهما البث فعليًا. لا تتوفّر هذه المعلومات إلا بعد أن تصبح حالة البث `live`. يتم تحديد القيمة بتنسيق ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`).
`snippet.actualEndTime`	`datetime` التاريخ والوقت اللذان انتهى فيهما البث فعليًا. لا تتوفّر هذه المعلومات إلا بعد أن تصبح حالة البث `complete`. يتم تحديد القيمة بتنسيق ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`).
`snippet.isDefaultBroadcast`	`boolean` سيتم إيقاف هذه السمة نهائيًا في 1 أيلول (سبتمبر) 2020 أو بعد هذا التاريخ. وفي هذه الحالة، ستوقف منصة YouTube إنشاء بث وبث تلقائيَين عند تفعيل ميزة البث المباشر في القناة. يمكنك الاطّلاع على الإشعار عن الإيقاف نهائيًا للحصول على مزيد من التفاصيل. تشير هذه السمة إلى ما إذا كان هذا البث هو البث التلقائي. طريقة عمل البثّات التلقائية عندما يتم تفعيل ميزة البث المباشر في قناة على YouTube، تنشئ منصة YouTube بثًا تلقائيًا وبثًا تلقائيًا للقناة. يحدّد البث كيفية إرسال مالك القناة لفيديو مباشر إلى YouTube، ويشير البث إلى الطريقة التي يمكن للمستخدمين من خلالها مشاهدة البث التلقائي. يمكن لصاحب القناة استخدام الطريقتَين `liveStreams.list` و`liveBroadcasts.list` لتحديد هذه الموارد. عندما تبدأ قناة ببث فيديو إلى البث التلقائي، يظهر الفيديو في البث التلقائي للقناة. عند انتهاء البث المباشر، تحوّل منصة YouTube البث المكتمل إلى فيديو على YouTube وتمنحه رقم تعريف. بعد اكتمال عملية التحويل، يتم تضمين الفيديو في قائمة الفيديوهات المحمَّلة على القناة. لا يتوفّر الفيديو بعد انتهاء البث مباشرةً، ويرتبط طول فترة التأخير بمدة البث الفعلية.
`snippet.liveChatId`	`string` معرّف المحادثة المباشرة في البث على YouTube باستخدام هذا المعرّف، يمكنك استخدام طرق مورد `liveChatMessage` لاسترداد رسائل المحادثة أو إدراجها أو حذفها. يمكنك أيضًا إضافة مشرفين إلى المحادثة أو إزالتهم، وحظر المستخدمين من المشاركة في المحادثات المباشرة، أو إزالة الحظر الحالي.
`status`	`object` يحتوي العنصر `status` على معلومات عن حالة الحدث.
`status.lifeCycleStatus`	`string` حالة البث يمكن تعديل الحالة باستخدام طريقة `liveBroadcasts.transition` في واجهة برمجة التطبيقات. القيم الصالحة لهذه السمة هي: `complete` – انتهى البث. `created`: يتضمّن البث إعدادات غير مكتملة، لذا ليس جاهزًا للانتقال إلى الحالة `live` أو `testing`، ولكن تم إنشاؤه وهو صالح. `live` – البث نشط. `liveStarting`: البث قيد الانتقال إلى الحالة `live`. `ready`: اكتملت إعدادات البث ويمكن أن ينتقل البث إلى الحالة `live` أو `testing`. `revoked` – تمّت إزالة هذه البثّات من خلال إجراء أحد المشرفين. `testStarting`: البث قيد الانتقال إلى الحالة `testing`. `testing` – لا يظهر البث إلا للشريك.
`status.privacyStatus`	`string` حالة خصوصية البث يُرجى العلم أنّ البث يمثّل فيديو واحدًا على YouTube بالضبط، لذا تكون إعدادات الخصوصية متطابقة مع تلك المسموح بها للفيديوهات. بالإضافة إلى ذلك، يمكنك ضبط هذا الحقل من خلال تعديل مورد البث أو من خلال ضبط الحقل `privacyStatus` لمورد الفيديو المقابل. في ما يلي القيم الصالحة لهذه السمة: `private` `public` `unlisted`
`status.recordingStatus`	`string` حالة تسجيل البث. في ما يلي القيم الصالحة لهذه السمة: `notRecording` `recorded` `recording`
`status.madeForKids`	`boolean` تشير هذه القيمة إلى ما إذا كان البث موجهًا إلى الأطفال. قيمة هذه السمة للقراءة فقط.
`status.selfDeclaredMadeForKids`	`boolean` في طلب `liveBroadcasts.insert` ، تسمح هذه السمة لمالك القناة بتصنيف البث على أنّه موجّه للأطفال. في طلب `liveBroadcasts.list` ، لا يتم عرض قيمة السمة إلا إذا فوّض مالك القناة طلب واجهة برمجة التطبيقات.
`contentDetails`	`object` يحتوي العنصر `contentDetails` على معلومات عن محتوى الفيديو الخاص بالحدث، مثل ما إذا كان يمكن عرض المحتوى في مشغّل فيديو مضمّن أو ما إذا كان سيتم أرشفته وبالتالي سيكون متاحًا للعرض بعد انتهاء الحدث.
`contentDetails.boundStreamId`	`string` تُحدِّد هذه القيمة بشكلٍ فريد `live stream` المرتبط بالبث.
`contentDetails.boundStreamLastUpdateTimeMs`	`datetime` تاريخ ووقت آخر تعديل على البث المباشر المُشار إليه بالعنصر `boundStreamId`
`contentDetails.monitorStream`	`object` يحتوي عنصر `monitorStream` على معلومات عن بث المراقبة الذي يمكن للمذيع استخدامه لمراجعة محتوى الحدث قبل عرض بث البث علنًا.
`contentDetails.monitorStream.enableMonitorStream`	`boolean` تحدد هذه القيمة ما إذا كان بث المراقبة مفعّلاً للبث. إذا كان بث المراقبة مفعّلاً، ستبث منصة YouTube محتوى الحدث على بث خاص مخصّص للمذيع فقط. يمكن للمذيع استخدام البث لمراجعة محتوى الحدث وتحديد الأوقات المثالية لإدراج نقاط البدء. يجب ضبط هذه القيمة على `true` إذا كنت تريد استخدام مرحلة `testing` لبثك أو إذا كنت تريد تأخير البث لحدثك. بالإضافة إلى ذلك، إذا كانت قيمة هذا السمة هي `true`، عليك نقل البث إلى الحالة `testing` قبل أن تتمكّن من نقله إلى الحالة `live`. (إذا كانت قيمة السمة هي `false`، لا يمكن أن يتضمّن البث مرحلة `testing`، لذا يمكنك نقل البث مباشرةً إلى الحالة `live`). عند `update a broadcast`، يجب ضبط هذه السمة إذا كان طلب البيانات من واجهة برمجة التطبيقات يتضمّن الجزء `contentDetails` في قيمة المَعلمة `part`. ومع ذلك، عند `insert a broadcast`، تكون السمة اختيارية ولها قيمة تلقائية هي `true`. ملاحظة مهمة: لا يمكن تعديل هذا السمة بعد أن يصبح البث في الحالة `testing` أو `live`.
`contentDetails.monitorStream.broadcastStreamDelayMs`	`unsigned integer` إذا ضبطت السمة `enableMonitorStream` على `true`، تحدّد هذه السمة طول مدة تأخّر البث المباشر. عند `update a broadcast`، يجب ضبط هذه السمة إذا كان طلب البيانات من واجهة برمجة التطبيقات يتضمّن الجزء `contentDetails` في قيمة المَعلمة `part`. ومع ذلك، عند `insert a broadcast`، تكون السمة اختيارية ولها قيمة تلقائية هي `0`. تشير هذه القيمة إلى أنّ البث المباشر لا يتضمّن أي تأخير. ملاحظة: لا يمكن تعديل هذه السمة بعد أن يصبح البث في الحالة `testing` أو `live`.
`contentDetails.monitorStream.embedHtml`	`string` رمز HTML الذي يضمِّن مشغّلاً لتشغيل بث الشاشة
`contentDetails.enableEmbed`	`boolean` يشير هذا الإعداد إلى ما إذا كان يمكن تشغيل الفيديو البث في مشغّل مضمّن. إذا اخترت أرشفة الفيديو (باستخدام السمة `enableArchive`)، سيتم تطبيق هذا الإعداد أيضًا على الفيديو المؤرشف. عند `update a broadcast`، يجب ضبط هذه السمة إذا كان طلب البيانات من واجهة برمجة التطبيقات يتضمّن الجزء `contentDetails` في قيمة المَعلمة `part`. ومع ذلك، عند `insert a broadcast`، تكون السمة اختيارية ولها قيمة تلقائية هي `true`. ملاحظة: لا يمكن تعديل هذه السمة بعد أن يصبح البث في الحالة `testing` أو `live`.
`contentDetails.enableDvr`	`boolean` يحدِّد هذا الإعداد ما إذا كان بإمكان المشاهدين الوصول إلى عناصر التحكّم في جهاز التسجيل الرقمي أثناء مشاهدة الفيديو. تتيح عناصر التحكّم في ميزة "تسجيل الفيديوهات" للمشاهد التحكّم في تجربة تشغيل الفيديو من خلال إيقافه مؤقتًا أو إرجاعه أو تقديمه بسرعة. القيمة التلقائية لهذا السمة هي `true`. عند `update a broadcast`، يجب ضبط هذه السمة إذا كان طلب البيانات من واجهة برمجة التطبيقات يتضمّن الجزء `contentDetails` في قيمة المَعلمة `part`. ومع ذلك، عند `insert a broadcast`، تكون السمة اختيارية ولها قيمة تلقائية هي `true`. ملاحظة مهمة: يجب ضبط القيمة على `true` وضبط قيمة السمة `enableArchive` على `true` أيضًا إذا كنت تريد إتاحة التشغيل فور انتهاء البث. بالإضافة إلى ذلك، لا يمكن تعديل هذه السمة بعد أن يصبح البث في الحالة `testing` أو `live`.
`contentDetails.recordFromStart`	`boolean` يشير هذا الإعداد إلى ما إذا كانت YouTube ستبدأ تلقائيًا بتسجيل البث بعد أن تتغيّر حالة الحدث إلى "بث مباشر". القيمة التلقائية لهذه السمة هي `true`، ولا يمكن ضبطها على `false` إلا إذا كان مسموحًا للقناة المُشغّلة ببث المحتوى بإيقاف التسجيلات للبث المباشر. إذا لم تكن قناتك تملك الإذن بإيقاف التسجيلات، وحاولت إدراج بث مع ضبط السمة `recordFromStart` على `false`، ستعرض واجهة برمجة التطبيقات خطأ `Forbidden`. بالإضافة إلى ذلك، إذا لم تكن قناتك تملك هذا الإذن وحاولت تعديل بث لضبط السمة `recordFromStart` على `false`، ستعرض واجهة برمجة التطبيقات خطأ `modificationNotAllowed`. عند `update a broadcast`، يجب ضبط هذه السمة إذا كان طلب البيانات من واجهة برمجة التطبيقات يتضمّن الجزء `contentDetails` في قيمة المَعلمة `part`. ومع ذلك، عند `insert a broadcast`، تكون السمة اختيارية ولها قيمة تلقائية هي `true`. ملاحظة مهمة: يجب أيضًا ضبط قيمة السمة `enableDvr` على `true` إذا كنت تريد أن يكون التشغيل متاحًا فور انتهاء البث. إذا ضبطت قيمة هذه السمة على `true` ولكنّك لم تضبط أيضًا السمة `enableDvr` على `true`، قد يكون هناك تأخير لمدة يوم تقريبًا قبل أن يصبح الفيديو المؤرشف متاحًا للتشغيل. ملاحظة: لا يمكن تعديل هذه السمة بعد أن يصبح البث في الحالة `testing` أو `live`.
`contentDetails.enableClosedCaptions`	`boolean` تم إيقاف هذه السمة نهائيًا اعتبارًا من 17 كانون الأول (ديسمبر) 2015. استخدِم السمة `contentDetails.closedCaptionsType` بدلاً من ذلك. يشير هذا الإعداد إلى ما إذا كان خيار "الترجمة والشرح" عبر HTTP POST مفعّلاً لهذا البث. بالنسبة إلى عملاء واجهة برمجة التطبيقات الذين يستخدمون هذا الموقع حاليًا: إنّ ضبط قيمة السمة على `true` يعادل ضبط سمة `contentDetails.closedCaptionsType` على `closedCaptionsHttpPost`. إنّ ضبط قيمة السمة على `false` يعادل ضبط سمة `contentDetails.closedCaptionsType` على `closedCaptionsDisabled`.
`contentDetails.closedCaptionsType`	`string` *ملاحظة: تحلّ هذه السمة مكان* سمة `contentDetails.enableClosedCaptions`.** تشير هذه السمة إلى ما إذا كانت ميزة الترجمة والشرح مفعّلة في البث، وإذا كان الأمر كذلك، إلى نوع الترجمة والشرح الذي تقدّمه: `closedCaptionsDisabled`: ميزة الترجمة والشرح غير مفعَّلة في البث المباشر. `closedCaptionsHttpPost`: سترسل الترجمة باستخدام HTTP POST إلى عنوان URL لتحميل المحتوى المرتبط بالبث المباشر. `closedCaptionsEmbedded`: سيتم ترميز مقاطع الترجمة والشرح في بث الفيديو باستخدام تنسيقَي EIA-608 و/أو CEA-708.
`contentDetails.projection`	`string` يشير ذلك إلى تنسيق العرض لهذا البث. القيمة التلقائية للسمة هي `rectangular`. القيم الصالحة لهذه السمة هي: `360` `rectangular`
`contentDetails.enableLowLatency`	`boolean` يشير هذا الحقل إلى ما إذا كان يجب ترميز هذا البث لتوفير بث بوقت استجابة منخفض. يمكن أن تقلّل عملية البث ذات الاستجابة المنخفضة من الوقت الذي يستغرقه ظهور الفيديو للمستخدمين الذين يشاهدون البث، إلا أنّها يمكن أن تؤثّر أيضًا في درجة الدقة لدى مشاهدي البث.
`contentDetails.latencyPreference`	`string` يشير إلى إعداد وقت الاستجابة الذي سيتم استخدامه لهذا البث. يمكن استخدام هذه السمة بدلاً من `enableLowLatency` التي لا تتيح `ultraLow`. يمكن أن يقلل البث بوقت استجابة منخفض من الوقت الذي يستغرقه ظهور الفيديو للمستخدمين الذين يشاهدون البث، إلا أنّه يمكن أن يؤثر أيضًا في سلاسة التشغيل. يقلّل البث بوقت استجابة منخفض جدًا من الوقت الذي يستغرقه ظهور الفيديو للمشاهدين، ما يسهّل التفاعل معهم، ولكنّه لا يتيح استخدام الترجمة والشرح أو الدقة الأعلى من 1080p. في ما يلي القيم الصالحة لهذه السمة: `normal` `low` `ultraLow`
`contentDetails.enableAutoStart`	`boolean` يشير إلى ما إذا كان يجب بدء هذا البث تلقائيًا عند بدء بث الفيديو على `live stream` المرتبط.
`contentDetails.enableAutoStop`	`boolean` يشير هذا الحقل إلى ما إذا كان يجب إيقاف هذا البث تلقائيًا بعد دقيقة تقريبًا من إيقاف صاحب القناة لبث الفيديو في بث الفيديو المرتبط.
`statistics`	`object` يحتوي عنصر `statistics` على إحصاءات ذات صلة بالبث المباشر. يمكن أن تتغيّر قيم هذه الإحصاءات أثناء البث، ولا يمكن استردادها إلا عندما يكون البث مباشرًا.
`statistics.totalChatCount`	`unsigned long` إجمالي عدد رسائل المحادثة المباشرة المرتبطة بالبث تظهر السمة وقيمتها إذا كان البث مرئيًا للمستخدم وتم تفعيل ميزة المحادثة المباشرة فيه وكان يتضمّن رسالة واحدة على الأقل. يُرجى العِلم أنّ هذه السمة لن تحدّد قيمة بعد انتهاء البث. وبالتالي، لن يحدِّد هذا السمة عدد رسائل المحادثة في فيديو أرشيف لبث مباشر مكتمل.
`monetizationDetails`	`object` يحتوي العنصر `monetizationDetails` على معلومات حول تفاصيل تحقيق الربح من البث، مثل ما إذا كان قد تم تفعيل أداة التشغيل التلقائي للإعلانات أو تأخّر إدراج الإعلانات أثناء التشغيل. ملاحظة مهمة: لتفعيل الإعلانات المبرمَجة في فيديو معيّن، يجب أن تكون القناة مؤهّلة لتحقيق الربح من الفيديوهات. يمكن ضبط إعدادات تحقيق الربح من البث، مثل تفعيل تحقيق الربح أو أداة التشغيل الآلي للإعلانات (أي "السماح لـ YouTube بإدراج إعلانات أثناء التشغيل نيابةً عنك" أو "تحديد موعد لعرض الإعلانات أثناء التشغيل بمعدّل تكرار محدّد")، في "استوديو YouTube" عند إنشاء البث أو تعديله أثناء البث المباشر.
`monetizationDetails.cuepointSchedule`	`object` يحدِّد عنصر `cuepointSchedule` إعدادات التشغيل الآلي للإعلانات للبث.
`monetizationDetails.cuepointSchedule.enabled`	`boolean` تحدد هذه القيمة ما إذا كان سيتم إدراج الإعلانات تلقائيًا في البث. إذا كانت القيمة هي `true`، سيُدرج YouTube تلقائيًا "الإعلانات أثناء التشغيل" في البث. سيتم تحديد جدول عرض الإعلانات بالاستناد إلى قيمة الحقول الأخرى في كائن `monetizationDetails.cuepointSchedule`.
`monetizationDetails.cuepointSchedule.pauseAdsUntil`	`datetime` تشير هذه القيمة إلى أنّه لا يجوز لمنصة YouTube إدراج "الإعلانات أثناء التشغيل" في البث إلا بعد تحديد التاريخ والوقت المحدّدَين. يتم تحديد القيمة بالتنسيق ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) . يجب ضبط القيمة على تاريخ ووقت مستقبليَين لإيقاف الإعلانات مؤقتًا، ويمكن أيضًا ضبط قيمة الحقل على تاريخ ووقت مستقبليَين قريبَين لإلغاء إيقاف الإعلانات مؤقتًا بعد مرور الوقت.
`monetizationDetails.cuepointSchedule.scheduleStrategy`	`string` تحدِّد هذه القيمة الاستراتيجية التي يجب أن تتّبعها YouTube لجدولة نقاط البدء. في ما يلي القيم الصالحة : `CONCURRENT`: يتم تحديد وقت عرض نقاط البدء في الوقت نفسه لجميع المشاهدين. `NON_CONCURRENT`: يتم تحديد أوقات مختلفة لعرض نقاط البدء للمشاهدين المختلفين. يتيح هذا النهج عرض الإعلانات بمعدّل متزايد يسمح للمشاهدين بتلقّي نقاط بدء عند استيفاء الشروط.
`monetizationDetails.cuepointSchedule.repeatIntervalSecs`	`unsigned integer` تُحدِّد هذه القيمة الفاصل الزمني بين عمليات إدراج الإعلانات التلقائية أثناء البث، وذلك بالثواني. على سبيل المثال، إذا كانت القيمة هي `300`، يمكن لمنصة YouTube إدراج نقاط تشغيل "الإعلانات أثناء التشغيل" على فترات تبلغ خمس دقائق. يُرجى العِلم أنّ القيمة تحدّد الوقت بين بداية نقاط البدء المتعاقبة. وهذا يعني أنّ الفاصل الزمني لا يتم قياسه من نهاية نقطة بدء إلى بداية النقطة التالية.

LiveBroadcasts تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الطُرق

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

الخصائص

LiveBroadcasts