- المرجع: VideoContent
- VideoContentStatus
- البيانات الوصفية
- GracenoteMetadata
- VideoContentSyndicationInfo
- SyndicatedVideoContentNames
- DynamicAdInsertionInfo
- VideoIngestUrlInfo
- VideoFormat
- VideoPreconditioned
- ClosedCaptionUrlInfo
- ClosedCaptionFormat
- الطُرق
المرجع: VideoContent
البيانات الوصفية للمحتوى.
تمثيل JSON |
---|
{ "name": string, "status": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد لمحتوى الفيديو ويكون هذا الحقل بالتنسيق التالي: "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'" Network_code هو رمز الشبكة في "مدير إعلانات Google" الذي ينتمي إليه هذا المحتوى. content_source_id هو معرّف مصدر المحتوى في "مدير إعلانات Google" الذي يجب أن ينتمي إليه هذا المحتوى. cms_content_id هو Content ID لنظام إدارة المحتوى (CMS) في "مدير إعلانات Google"، وقد تمّ تكوينه كجزء من طلب الإعلان لتحديد الإعلانات التي يمكن أن يعرضها "مدير الإعلانات" على الفيديو المقابل لها. يمكن أن تكون هذه القيمة رقمية أو أبجدية رقمية. |
status |
حالة المحتوى في حال عدم إضافة هذه السمة، ستكون القيمة التلقائية نشطة. |
title |
مطلوب. تمثّل هذه السمة عنوان المحتوى. |
updateTime |
مطلوب. وقت آخر تعديل للمحتوى. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
publishTime |
وقت نشر المحتوى هذا الحقل مطلوب إذا تم تصميم الفيديو لتضمينه في قواعد الإعلان التي تحدد وقت بدء ووقت انتهاء. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
duration |
مدة المحتوى يتم ضبط المدة على مستوى المللي ثانية. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
cuePoints[] |
يحدد نقاط عرض الإعلانات. أما نقاط عرض الإعلانات، فهي مواضع زمنية يمكن فيها إدراج إعلان في الفيديو. ويتم توفير نقاط عرض الإعلانات حتى مستوى المللي ثانية. يجب ملء هذا الحقل إذا كان الفيديو يحتوي على فواصل إعلانية أثناء التشغيل. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
thumbnailUrl |
عنوان URL للصورة المصغّرة للمحتوى |
metadata |
يحدد البيانات الوصفية المخصّصة للمحتوى. |
gracenoteMetadata |
البيانات الوصفية للمحتوى ذات الصلة بـ Gracenote |
syndicationMetadata |
البيانات الوصفية للمحتوى المرتبطة بالمشاركة |
dynamicAdInsertionMetadata |
البيانات الوصفية ذات الصلة بـ "إدراج إعلان ديناميكي" |
VideoContentStatus
خيارات الحالة لعرض الإعلانات المستهدَفة في محتوى معيّن أو عدم عرضها
عمليات التعداد | |
---|---|
ACTIVE |
وسيتم عرض الإعلانات التي تستهدف المحتوى. |
BLOCKED |
لن يتم عرض أي إعلانات على هذا المحتوى إذا كانت الحالة "محظور". |
DELETED |
ستتم أرشفة المحتوى في "مدير إعلانات Google". إذا تلقى "مدير الإعلانات" طلب إعلان لمحتوى تم وضع علامة "محذوف" عليه، يمكن عندئذ عرض إعلانات للشركة نفسها أو إعلانات تستهدف وحدات المخزون أو معايير استهداف أخرى. لحظر الإعلانات، اضبط الحالة على "محظور". |
البيانات الوصفية
البيانات الوصفية المخصّصة للمحتوى
تمثيل JSON |
---|
{ "keyValues": { string: value, ... } } |
الحقول | |
---|---|
keyValues |
يحدّد البيانات الوصفية المخصّصة للمحتوى كزوج من المفتاح/القيمة. يتم قبول السلاسل أو قائمة السلاسل فقط للقيم. |
GracenoteMetadata
البيانات الوصفية للمحتوى في Gracenote
تمثيل JSON |
---|
{ "gracenoteId": string, "gracenoteSeriesId": string } |
الحقول | |
---|---|
gracenoteId |
مطلوب. يشير إلى معرّف Gracenote للمحتوى. يجب أن يحتوي على إحدى هذه البادئات الصالحة: 1. "EP" - حلقة من المسلسل 2. 'MV' - الفيلم 3. "SP" - حدث رياضي |
gracenoteSeriesId |
اختياريّ. يشير هذا الحقل إلى رقم تعريف سلسلة Gracenote. ويجب أن تسبقه البادئة SH. |
VideoContentSyndicationInfo
البيانات الوصفية لتحديد العلاقات بين المحتوى الأساسي والمحتوى المقتبَس.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد syndication . يمكن أن تحتوي VideoContentSyndiationMetadata على أحد العناصر التالية فقط. يمكن أن يكون syndication واحدًا فقط مما يلي: |
|
canonicalVideoContent |
اسم المحتوى الأساسي ويجب أن يكون بالتنسيق التالي: "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" ويجب أن ينتمي إلى الشبكة نفسها التي ينتمي إليها المحتوى الذي يحتوي على هذا الحقل. |
syndicatedVideoContentNames |
مجموعة من المحتوى المقتبَس |
SyndicatedVideoContentNames
قائمة بأسماء كل المحتوى المقتبس.
تمثيل JSON |
---|
{ "syndicatedVideoContent": [ string ] } |
الحقول | |
---|---|
syndicatedVideoContent[] |
حقل متكرّر لاسم المحتوى المقتبَس. ويجب أن يكون بالتنسيق التالي: "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" ويجب أن ينتمي إلى الشبكة نفسها التي ينتمي إليها المحتوى الذي يحتوي على هذا الحقل. |
DynamicAdInsertionInfo
معلومات ذات صلة بميزة "إدراج إعلان ديناميكي"
تمثيل JSON |
---|
{ "videoIngestUrlInfo": { object ( |
الحقول | |
---|---|
videoIngestUrlInfo |
رابط إلى ملف m3u8 الرئيسي المستخدم للتكييف وإنشاء قوائم التشغيل. |
mediaUpdateTime |
الوقت الذي تم فيه إجراء آخر تعديل على ملف الفيديو المشار إليه في videoIngestUrlInfo. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
closedCaptionUrlInfo[] |
عنوان URL لملف الترجمة والشرح. |
fwCaid |
رقم تعريف مادة العرض المخصّصة من Freewheel والذي يُستخدَم في استهداف الإعلانات. |
VideoIngestUrlInfo
البيانات الوصفية التي تحدّد الرابط إلى ملف m3u8 المستخدَم في عملية التصفية وإنشاء قوائم التشغيل
تمثيل JSON |
---|
{ "videoFormat": enum ( |
الحقول | |
---|---|
videoFormat |
تمثّل هذه السمة تنسيق الفيديو. |
videoPreconditioned |
لتحديد ما إذا كان المحتوى مقيَّدًا بشروط خاصة بالإعلانات أثناء التشغيل أم لا، ما يعني أنّه سبق أن تم تقسيم الشرائح في وقت الفواصل الإعلانية. |
url |
الرابط إلى ملف m3u8. |
VideoFormat
هي التنسيقات التي قد يتم ترميز محتوى الفيديو بها.
عمليات التعداد | |
---|---|
VIDEO_FORMAT_UNSPECIFIED |
لم يتم تحديد تنسيق الفيديو. |
HLS |
application/x-mpegURL |
DASH |
application/dash+xml |
VideoPreconditioned
الحالة المشروطة لمحتوى الفيديو
عمليات التعداد | |
---|---|
NO |
لم يتم فرض شروط على المنتج بعد. |
YES |
تم تكييف أو تكييف الفيديو. |
ClosedCaptionUrlInfo
البيانات الوصفية لملف ترجمة وشرح واحد.
تمثيل JSON |
---|
{
"languageCode": string,
"closedCaptionFormat": enum ( |
الحقول | |
---|---|
languageCode |
رمز اللغة IETF BCP-47 الذي يمثّل اللغة التي يتم استخدامها في ملف الترجمة والشرح. |
closedCaptionFormat |
تمثّل هذه السمة تنسيق ملف الترجمة والشرح. |
url |
تمثّل هذه السمة عنوان URL لملف الترجمة والشرح. |
ClosedCaptionFormat
تمثّل هذه السمة التنسيقات التي قد تكون ملفات الترجمة والشرح بها.
عمليات التعداد | |
---|---|
CLOSED_CAPTION_FORMAT_UNSPECIFIED |
لم يتم تحديد تنسيق الترجمة والشرح. |
TTML |
application/ttaf+xml |
WEB_VTT |
text/vtt |
الطُرق |
|
---|---|
|
واجهة برمجة التطبيقات لإنشاء محتوى جديد أو تعديل بياناته الوصفية إذا كان المحتوى متوفرًا في "مدير إعلانات Google". |