REST Resource: videoContent.networks.sources.content

المرجع: VideoContent

البيانات الوصفية للمحتوى.

تمثيل JSON
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
الحقول
name

string

النتائج فقط. اسم المورد لمحتوى الفيديو ويكون هذا الحقل بالتنسيق التالي: "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

enum (VideoContentStatus)

حالة المحتوى في حال عدم إضافة هذه السمة، ستكون القيمة التلقائية نشطة.

title

string

مطلوب. تمثّل هذه السمة عنوان المحتوى.

updateTime

string (Timestamp format)

مطلوب. وقت آخر تعديل للمحتوى.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

publishTime

string (Timestamp format)

وقت نشر المحتوى هذا الحقل مطلوب إذا تم تصميم الفيديو لتضمينه في قواعد الإعلان التي تحدد وقت بدء ووقت انتهاء.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

مدة المحتوى يتم ضبط المدة على مستوى المللي ثانية.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

cuePoints[]

string (Duration format)

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

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

thumbnailUrl

string

عنوان URL للصورة المصغّرة للمحتوى

metadata

object (Metadata)

يحدد البيانات الوصفية المخصّصة للمحتوى.

gracenoteMetadata

object (GracenoteMetadata)

البيانات الوصفية للمحتوى ذات الصلة بـ Gracenote

syndicationMetadata

object (VideoContentSyndicationInfo)

البيانات الوصفية للمحتوى المرتبطة بالمشاركة

dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

البيانات الوصفية ذات الصلة بـ "إدراج إعلان ديناميكي"

VideoContentStatus

خيارات الحالة لعرض الإعلانات المستهدَفة في محتوى معيّن أو عدم عرضها

عمليات التعداد
ACTIVE وسيتم عرض الإعلانات التي تستهدف المحتوى.
BLOCKED لن يتم عرض أي إعلانات على هذا المحتوى إذا كانت الحالة "محظور".
DELETED ستتم أرشفة المحتوى في "مدير إعلانات Google". إذا تلقى "مدير الإعلانات" طلب إعلان لمحتوى تم وضع علامة "محذوف" عليه، يمكن عندئذ عرض إعلانات للشركة نفسها أو إعلانات تستهدف وحدات المخزون أو معايير استهداف أخرى. لحظر الإعلانات، اضبط الحالة على "محظور".

البيانات الوصفية

البيانات الوصفية المخصّصة للمحتوى

تمثيل JSON
{
  "keyValues": {
    string: value,
    ...
  }
}
الحقول
keyValues

map (key: string, value: value (Value format))

يحدّد البيانات الوصفية المخصّصة للمحتوى كزوج من المفتاح/القيمة. يتم قبول السلاسل أو قائمة السلاسل فقط للقيم.

GracenoteMetadata

البيانات الوصفية للمحتوى في Gracenote

تمثيل JSON
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
الحقول
gracenoteId

string

مطلوب. يشير إلى معرّف Gracenote للمحتوى. يجب أن يحتوي على إحدى هذه البادئات الصالحة: 1. "EP" - حلقة من المسلسل 2. 'MV' - الفيلم 3. "SP" - حدث رياضي

gracenoteSeriesId

string

اختياريّ. يشير هذا الحقل إلى رقم تعريف سلسلة Gracenote. ويجب أن تسبقه البادئة SH.

VideoContentSyndicationInfo

البيانات الوصفية لتحديد العلاقات بين المحتوى الأساسي والمحتوى المقتبَس.

تمثيل JSON
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
الحقول
حقل الاتحاد syndication. يمكن أن تحتوي VideoContentSyndiationMetadata على أحد العناصر التالية فقط. يمكن أن يكون syndication واحدًا فقط مما يلي:
canonicalVideoContent

string

اسم المحتوى الأساسي ويجب أن يكون بالتنسيق التالي: "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" ويجب أن ينتمي إلى الشبكة نفسها التي ينتمي إليها المحتوى الذي يحتوي على هذا الحقل.

syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

مجموعة من المحتوى المقتبَس

SyndicatedVideoContentNames

قائمة بأسماء كل المحتوى المقتبس.

تمثيل JSON
{
  "syndicatedVideoContent": [
    string
  ]
}
الحقول
syndicatedVideoContent[]

string

حقل متكرّر لاسم المحتوى المقتبَس. ويجب أن يكون بالتنسيق التالي: "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" ويجب أن ينتمي إلى الشبكة نفسها التي ينتمي إليها المحتوى الذي يحتوي على هذا الحقل.

DynamicAdInsertionInfo

معلومات ذات صلة بميزة "إدراج إعلان ديناميكي"

تمثيل JSON
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
الحقول
videoIngestUrlInfo

object (VideoIngestUrlInfo)

رابط إلى ملف m3u8 الرئيسي المستخدم للتكييف وإنشاء قوائم التشغيل.

mediaUpdateTime

string (Timestamp format)

الوقت الذي تم فيه إجراء آخر تعديل على ملف الفيديو المشار إليه في videoIngestUrlInfo.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

عنوان URL لملف الترجمة والشرح.

fwCaid

string

رقم تعريف مادة العرض المخصّصة من Freewheel والذي يُستخدَم في استهداف الإعلانات.

VideoIngestUrlInfo

البيانات الوصفية التي تحدّد الرابط إلى ملف m3u8 المستخدَم في عملية التصفية وإنشاء قوائم التشغيل

تمثيل JSON
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
الحقول
videoFormat

enum (VideoFormat)

تمثّل هذه السمة تنسيق الفيديو.

videoPreconditioned

enum (VideoPreconditioned)

لتحديد ما إذا كان المحتوى مقيَّدًا بشروط خاصة بالإعلانات أثناء التشغيل أم لا، ما يعني أنّه سبق أن تم تقسيم الشرائح في وقت الفواصل الإعلانية.

url

string

الرابط إلى ملف m3u8.

VideoFormat

هي التنسيقات التي قد يتم ترميز محتوى الفيديو بها.

عمليات التعداد
VIDEO_FORMAT_UNSPECIFIED لم يتم تحديد تنسيق الفيديو.
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

الحالة المشروطة لمحتوى الفيديو

عمليات التعداد
NO لم يتم فرض شروط على المنتج بعد.
YES تم تكييف أو تكييف الفيديو.

ClosedCaptionUrlInfo

البيانات الوصفية لملف ترجمة وشرح واحد.

تمثيل JSON
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
الحقول
languageCode

string

رمز اللغة IETF BCP-47 الذي يمثّل اللغة التي يتم استخدامها في ملف الترجمة والشرح.

closedCaptionFormat

enum (ClosedCaptionFormat)

تمثّل هذه السمة تنسيق ملف الترجمة والشرح.

url

string

تمثّل هذه السمة عنوان URL لملف الترجمة والشرح.

ClosedCaptionFormat

تمثّل هذه السمة التنسيقات التي قد تكون ملفات الترجمة والشرح بها.

عمليات التعداد
CLOSED_CAPTION_FORMAT_UNSPECIFIED لم يتم تحديد تنسيق الترجمة والشرح.
TTML application/ttaf+xml
WEB_VTT text/vtt

الطُرق

update

واجهة برمجة التطبيقات لإنشاء محتوى جديد أو تعديل بياناته الوصفية إذا كان المحتوى متوفرًا في "مدير إعلانات Google".