Package google.ads.drx.video.v1

الفهرس

VideoContentIngestionService

خدمة واجهة برمجة تطبيقات لاستيعاب المحتوى تتيح إنشاء محتوى فيديو وتعديله وبياناته الوصفية المرتبطة به في "مدير إعلانات Google"

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

واجهة برمجة التطبيقات لإنشاء محتوى جديد أو تعديل بياناته الوصفية إذا كان المحتوى متوفّرًا في "مدير إعلانات Google". تعرض هذه السمة المحتوى عند النجاح أو google.rpc.Code عند حدوث خطأ.

يبدو الطلب النموذجي على النحو التالي:

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}
نطاقات التفويض

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.

ClosedCaptionFormat

تنسيقات ملفات الترجمة والشرح

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

ClosedCaptionUrlInfo

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

الحقول
language_code

string

رمز اللغة IETF BCP-47 الذي يمثّل اللغة التي يتضمّنها ملف الترجمة والشرح
closed_caption_format

ClosedCaptionFormat

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

string

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

DynamicAdInsertionInfo

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

الحقول
video_ingest_url_info

VideoIngestUrlInfo

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

Timestamp

الوقت الذي تم فيه تعديل ملف الفيديو المشار إليه في video_ingest_url_info آخر مرة.
closed_caption_url_info[]

ClosedCaptionUrlInfo

عنوان URL لملف الترجمة والشرح/الترجمة المصاحبة.
fw_caid

string

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

GracenoteMetadata

تمثّل هذه السمة البيانات الوصفية للمحتوى في Gracenote.

الحقول
gracenote_id

string

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

string

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

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

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

الحقول
key_values

map<string, Value>

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

SyndicatedVideoContentNames

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

الحقول
syndicated_video_content[]

string

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

UpdateVideoContentRequest

طلب [VideoContentIngestionService.UpdateVideoContentRequest][]

الحقول
video_content

VideoContent

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

VideoContent

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

الحقول
name

string

النتائج فقط. اسم المورد الخاص بمحتوى الفيديو يكون هذا الحقل بالتنسيق التالي: ‎'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'‎

‫network_code هو معرِّف الشبكة في "إدارة إعلانات Google" الذي ينتمي إليه هذا المحتوى.

‫content_source_id هو رقم تعريف مصدر المحتوى في "مدير إعلانات Google" الذي يجب أن ينتمي إليه هذا المحتوى.

‫cms_content_id هو رقم تعريف المحتوى في نظام إدارة المحتوى (CMS) ضمن "إدارة إعلانات Google"، ويتم إنشاؤه كجزء من طلب عرض الإعلان لتحديد الإعلانات التي يمكن أن يعرضها "إدارة الإعلانات" مقابل الفيديو ذي الصلة. يمكن أن تكون هذه القيمة رقمية أو رقمية أبجدية.
status

VideoContentStatus

تمثّل هذه السمة حالة المحتوى. في حال حذف هذه السمة، سيتم تفعيل القيمة التلقائية.
title

string

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

Timestamp

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

Timestamp

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

Duration

مدة المحتوى يمكن تحديد المدة بدقة تصل إلى مستوى الملّي ثانية.
cue_points[]

Duration

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

string

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

Metadata

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

GracenoteMetadata

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

VideoContentSyndicationInfo

البيانات الوصفية المرتبطة بتجميع المحتوى
dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

البيانات الوصفية المرتبطة بميزة "إدراج الإعلان الديناميكي" الخاصة بالمحتوى

VideoContentStatus

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

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

VideoContentSyndicationInfo

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

الحقول
حقل الربط syndication يمكن أن تحتوي VideoContentSyndiationMetadata على أحد العناصر التالية فقط. يمكن أن يكون التعليق syndication إحدى القيم التالية فقط:
canonical_video_content

string

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

SyndicatedVideoContentNames

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

VideoFormat

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

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

VideoIngestUrlInfo

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

الحقول
video_format

VideoFormat

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

VideoPreconditioned

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

string

تمثّل هذه السمة الرابط إلى ملف m3u8.

VideoPreconditioned

تمثّل هذه السمة حالة محتوى الفيديو.

عمليات التعداد
NO لم يتم ضبطها بعد.
YES تمت معالجة الفيديو/تقسيمه.