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 Ad Manager است که این محتوا به آن تعلق دارد.

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

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

status

enum ( VideoContentStatus )

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

title

string

مورد نیاز. عنوان مطلب.

updateTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

publishTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "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

نشانی اینترنتی تصویر کوچک محتوا.

metadata

object ( Metadata )

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

gracenoteMetadata

object ( GracenoteMetadata )

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

syndicationMetadata

object ( VideoContentSyndicationInfo )

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

dynamicAdInsertionMetadata

object ( DynamicAdInsertionInfo )

فراداده مربوط به درج آگهی پویا از محتوا.

VideoContentStatus

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

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

فراداده

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

نمایندگی 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 )

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

mediaUpdateTime

string ( Timestamp format)

زمانی که فایل ویدیویی به آن اشاره شده در videoIngestUrlInfo آخرین بار اصلاح شد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

closedCaptionUrlInfo[]

object ( ClosedCaptionUrlInfo )

نشانی اینترنتی فایل زیرنویس/زیرنویس بسته.

fwCaid

string

شناسه دارایی سفارشی چرخ آزاد مورد استفاده برای هدف‌یابی تبلیغات.

VideoIngestUrlInfo

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

نمایندگی JSON 
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
فیلدها
videoFormat

enum ( VideoFormat )

فرمت ویدیو.

videoPreconditioned

enum ( VideoPreconditioned )

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

url

string

لینک فایل m3u8.

فرمت ویدئو

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

Enums
VIDEO_FORMAT_UNSPECIFIED فرمت ویدئو مشخص نشده است.
HLS application/x-mpegURL
DASH application/dash+xml

ویدیو پیش شرط شده

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

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

ClosedCaptionUrlInfo

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

نمایندگی JSON 
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
فیلدها
languageCode

string

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

closedCaptionFormat

enum ( ClosedCaptionFormat )

فرمت فایل زیرنویس بسته.

url

string

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

ClosedCaptionFormat

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

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

روش ها

update

 API برای ایجاد محتوای جدید یا به‌روزرسانی ابرداده آن در صورتی که محتوا از قبل در Ad Manager وجود داشته باشد.