Package google.ads.drx.video.v1

فهرست

سرویس دریافت محتوای ویدیویی

یک سرویس API برای دریافت محتوا که امکان ایجاد یا به‌روزرسانی محتوای ویدیویی و فراداده‌های مرتبط با آن را در Google Ad Manager فراهم می‌کند.

محتوای ویدیویی را به‌روزرسانی کنید

rpc UpdateVideoContent( UpdateVideoContentRequest ) returns ( VideoContent )

API برای ایجاد محتوای جدید یا به‌روزرسانی فراداده‌های آن، در صورتی که محتوا از قبل در Ad Manager وجود داشته باشد. در صورت موفقیت، محتوا و در صورت عدم موفقیت، کد 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 مراجعه کنید.

قالب زیرنویس بسته

فرمت‌هایی که فایل‌های زیرنویس می‌توانند داشته باشند.

انوم‌ها
CLOSED_CAPTION_FORMAT_UNSPECIFIED قالب زیرنویس مشخص نشده بود.
TTML برنامه/ttaf+xml
WEB_VTT متن/vtt

اطلاعات عنوان بسته

فراداده برای یک فایل زیرنویس.

فیلدها
language_code

string

کد زبان IETF BCP-47 که زبانی را که فایل زیرنویس به آن زبان است نشان می‌دهد.

closed_caption_format

ClosedCaptionFormat

قالب فایل زیرنویس.

url

string

آدرس اینترنتی (url) فایل زیرنویس.

اطلاعات درج پویا

اطلاعات مربوط به درج تبلیغات پویا.

فیلدها
video_ingest_url_info

VideoIngestUrlInfo

پیوندی به فایل اصلی m3u8 که برای آماده‌سازی و تولید لیست پخش استفاده می‌شود.

media_update_time

Timestamp

آخرین باری که فایل ویدیویی که در video_ingest_url_info به آن ارجاع داده شده، تغییر داده شده است.

closed_caption_url_info[]

ClosedCaptionUrlInfo

آدرس اینترنتی (URL) فایل زیرنویس/زیرنویس.

fw_caid

string

شناسه دارایی سفارشی Freewheel که برای هدف‌گیری تبلیغات استفاده می‌شود.

گریس‌نوتفراداده

فراداده‌ی گریس‌نوت برای محتوا.

فیلدها
gracenote_id

string

الزامی. به شناسه گریس‌نوت برای محتوا اشاره دارد. باید یکی از این پیشوندهای معتبر را داشته باشد: ۱. «EP» - قسمت یک سریال ۲. «MV» - فیلم ۳. «SP» - رویداد ورزشی

gracenote_series_id

string

اختیاری. این فیلد به شناسه سری Gracenote اشاره دارد. باید با پیشوند 'SH' شروع شود.

فراداده

فراداده‌های سفارشی محتوا.

فیلدها
key_values

map<string, Value >

متادیتای سفارشی محتوا را به عنوان یک جفت کلید-مقدار شناسایی می‌کند. فقط رشته‌ها یا لیستی از رشته‌ها برای مقادیر پذیرفته می‌شوند.

نام‌های محتوای ویدیویی سندیکایی

فهرست اسامی تمام محتوای سندیکایی.

فیلدها
syndicated_video_content[]

string

فیلد تکراری نام محتوای سندیکایی. فرمت آنها باید "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" باشد و باید متعلق به همان شبکه‌ای باشند که محتوای حاوی این فیلد در آن قرار دارد.

درخواست محتوای ویدیویی به‌روزرسانی

درخواست برای [VideoContentIngestionService.UpdateVideoContentRequest][].

فیلدها
video_content

VideoContent

الزامی. فراداده‌ی محتوا.

محتوای ویدیویی

فراداده (metadata) محتوا.

فیلدها
name

string

فقط خروجی. نام منبع محتوای ویدیو. این فیلد دارای قالب زیر است: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'

network_code کد شبکه‌ای در Google Ad Manager است که این محتوا به آن تعلق دارد.

content_source_id شناسه منبع محتوا در Google Ad Manager است که این محتوا باید به آن تعلق داشته باشد.

cms_content_id شناسه محتوای CMS در Google Ad Manager است که به عنوان بخشی از درخواست تبلیغ تشکیل می‌شود تا مشخص کند کدام تبلیغات Ad Manager می‌تواند در مقابل ویدیوی مربوطه نمایش داده شود. این مقدار می‌تواند عددی یا حرفی-عددی باشد.

status

VideoContentStatus

وضعیت محتوا. اگر این مورد حذف شود، مقدار پیش‌فرض فعال خواهد بود.

title

string

الزامی. عنوان محتوا.

update_time

Timestamp

الزامی. آخرین زمان تغییر محتوا.

publish_time

Timestamp

زمان انتشار محتوا. اگر ویدیو طوری طراحی شده باشد که در قوانین تبلیغاتی که زمان شروع و پایان را مشخص می‌کنند، گنجانده شود، این فیلد الزامی است.

duration

Duration

مدت زمان محتوا. مدت زمان تا سطح میلی ثانیه پشتیبانی می‌شود.

cue_points[]

Duration

نقاط راهنما را شناسایی می‌کند. نقاط راهنما مکان‌هایی در زمان هستند که می‌توان یک تبلیغ را در ویدیو قرار داد. نقاط راهنما تا سطح میلی‌ثانیه پشتیبانی می‌شوند. اگر ویدیو حاوی وقفه‌های تبلیغاتی در میانه‌ی پخش باشد، این فیلد الزامی است.

thumbnail_url

string

آدرس تصویر بندانگشتی محتوا.

metadata

Metadata

متادیتای سفارشی محتوا را شناسایی می‌کند.

gracenote_metadata

GracenoteMetadata

فراداده‌های مربوط به محتوا در Gracenote.

syndication_metadata

VideoContentSyndicationInfo

فراداده‌های مرتبط با سندیکاسیون محتوا.

dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

فراداده‌های مربوط به درج تبلیغات پویا در محتوا.

وضعیت محتوای ویدیو

گزینه‌های وضعیت برای نمایش یا عدم نمایش تبلیغات هدفمند برای یک محتوا.

انوم‌ها
ACTIVE تبلیغات هدفمند محتوا ارائه خواهد شد.
BLOCKED اگر وضعیت مسدود شده باشد، هیچ تبلیغی علیه این محتوا نمایش داده نخواهد شد.
DELETED محتوا در Ad Manager بایگانی خواهد شد. اگر Ad Manager درخواست تبلیغ برای محتوایی که به عنوان DELETED علامت‌گذاری شده است را دریافت کند، تبلیغات خانگی یا تبلیغاتی که برای واحدهای موجودی یا سایر معیارهای هدف‌گذاری هدف‌گذاری شده‌اند، همچنان می‌توانند علیه آن عمل کنند. برای مسدود کردن تبلیغات، وضعیت را روی BLOCKED تنظیم کنید.

اطلاعات پیوند محتوای ویدیویی

فراداده برای تعیین روابط بین محتوای متعارف و محتوای سندیکایی.

فیلدها
syndication فیلدهای یونیون. VideoContentSyndiationMetadata فقط می‌تواند شامل یکی از موارد زیر باشد. syndication می‌تواند فقط یکی از موارد زیر باشد:
canonical_video_content

string

نام محتوای استاندارد. باید فرمت آن "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" باشد و باید به همان شبکه‌ای تعلق داشته باشد که محتوای حاوی این فیلد در آن قرار دارد.

syndicated_video_content_names

SyndicatedVideoContentNames

مجموعه‌ای از محتوای سندیکایی

فرمت ویدئو

فرمت‌هایی که محتوای ویدیویی می‌تواند در آنها کدگذاری شود.

انوم‌ها
VIDEO_FORMAT_UNSPECIFIED فرمت ویدیو مشخص نشده بود.
HLS application/x-mpegURL
DASH برنامه/خط تیره+xml

اطلاعات ورودی ویدیو

فراداده‌ای که پیوند به فایل m3u8 مورد استفاده برای شرطی‌سازی و تولید لیست پخش را مشخص می‌کند.

فیلدها
video_format

VideoFormat

فرمت ویدیو.

video_preconditioned

VideoPreconditioned

برای نشان دادن اینکه آیا محتوا از قبل برای تبلیغات میان‌پرده آماده شده است یا خیر، به این معنی که بخش‌های شما در زمان وقفه‌های تبلیغاتی از قبل تقسیم شده‌اند.

url

string

لینک فایل m3u8.

پیش‌شرط‌بندی ویدیویی

وضعیت شرطی محتوای ویدیو.

انوم‌ها
NO هنوز مشروط نشده.
YES ویدیو شرطی/تقسیم شده است.