REST Resource: claims

منبع: ادعا

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

نمایندگی JSON
{
  "kind": string,
  "policy": {
    object (Policy)
  },
  "timeCreated": string,
  "contentType": string,
  "ugcType": string,
  "isPartnerUploaded": boolean,
  "timeStatusLastModified": string,
  "blockOutsideOwnership": boolean,
  "status": string,
  "appliedPolicy": {
    object (Policy)
  },
  "id": string,
  "assetId": string,
  "videoId": string,
  "origin": {
    object (Origin)
  },
  "matchInfo": {
    object (MatchInfo)
  },
  "studioInfo": {
    object (StudioInfo)
  }
}
زمینه های
kind

string

نوع منبع API. برای منابع claim ، این مقدار youtubePartner#claim است.

policy

object ( Policy )

خط مشی ارائه شده توسط مالک مشاهده کننده در مورد ادعا.

timeCreated

string

زمانی که ادعا ایجاد شد.

contentType

string

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

ugcType

string

نوع UGC ادعا (استاندارد، حق بیمه، آهنگ).

isPartnerUploaded

boolean

نشان می دهد که آیا ادعا، ادعای بارگذاری شده توسط شریک است یا خیر.

timeStatusLastModified

string

زمانی که وضعیت ادعا و/یا جزئیات وضعیت آخرین بار اصلاح شد.

blockOutsideOwnership

boolean

نشان می دهد که آیا ویدیوی ادعا شده باید در هر جایی که صراحتاً متعلق به آن نیست مسدود شود یا خیر.

status

string

وضعیت ادعا هنگام به‌روزرسانی یک ادعا، می‌توانید وضعیت آن را از active به inactive به‌روزرسانی کنید تا به طور مؤثر ادعا را آزاد کنید، اما API از سایر به‌روزرسانی‌های وضعیت ادعا پشتیبانی نمی‌کند.

appliedPolicy

object ( Policy )

خط مشی اعمال شده برای مالک مشاهده کننده در مورد ادعا. این ممکن است با خط‌مشی ادعای نهایی در مورد ویدیو یکسان نباشد، زیرا خط‌مشی سایر شرکا در مورد همان ادعا را در نظر نمی‌گیرد.

id

string

شناسه ای که YouTube اختصاص می دهد و برای شناسایی منحصر به فرد ادعا استفاده می کند.

assetId

string

شناسه دارایی منحصر به فرد YouTube که دارایی مرتبط با ادعا را مشخص می کند.

videoId

string

شناسه منحصربه‌فرد ویدیوی YouTube که ویدیوی مرتبط با ادعا را مشخص می‌کند.

origin

object ( Origin )

matchInfo

object ( MatchInfo )

اگر این ادعا به صورت خودکار بر اساس یک مرجع ارائه شده ایجاد شده باشد، این بخش جزئیات مربوط به تطابقی را ارائه می دهد که ادعا را ایجاد کرده است.

studioInfo

object ( StudioInfo )

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

اصل و نسب

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

نمایندگی JSON
{
  "source": string
}
زمینه های
source

string

MatchInfo

اطلاعات مربوط به ادعا را مطابقت دهید.

نمایندگی JSON
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
زمینه های
matchSegments[]

object ( MatchSegment )

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

referenceId

string

شناسه مرجعی که این تطابق را ایجاد کرده است.

longestMatch

object ( LongestMatch )

جزئیات طولانی‌ترین تطابق بین مرجع و ویدیوی کاربر.

totalMatch

object ( TotalMatch )

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

MatchSegment

اطلاعات مربوط به یک بخش منطبق بر یک ادعا.

نمایندگی JSON
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
زمینه های
video_segment

object ( Segment )

شی videoSegment حاوی اطلاعاتی در مورد بخش منطبق از ویدیوی ادعا شده است.

reference_segment

object ( Segment )

شی referenceSegment حاوی اطلاعات مربوط به بخش منطبق از محتوای مرجع است.

channel

string

نحوه مطابقت ویدیوی ادعا شده با ویدیوی مرجع را مشخص می کند.

manual_segment

object ( Segment2 )

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

بخش

این منبع یک بخش ساده با زمان شروع و پایان را نشان می دهد که به صورت رشته "hh:mm:ss.mmm" قالب بندی شده است.

نمایندگی JSON
{
  "start": string,
  "duration": string,
  "kind": string
}
زمینه های
start

string

زمان شروع بخش، از ابتدا در میلی ثانیه اندازه گیری می شود.

duration

string

مدت زمان قطعه بر حسب میلی ثانیه.

kind

string

نوع منبع API. برای منابع بخش، مقدار youtubePartner#segment است.

بخش 2

این منبع یک بخش ساده دیگر را با زمان شروع و پایان به صورت رشته "hh:mm:ss.mmm" نشان می دهد.

نمایندگی JSON
{
  "start": string,
  "kind": string,
  "finish": string
}
زمینه های
start

string

زمان شروع بخش، از ابتدا در میلی ثانیه اندازه گیری می شود.

kind

string

نوع منبع API. برای منابع بخش، مقدار youtubePartner#segment است.

finish

string

زمان پایان بخش، از ابتدا در میلی ثانیه اندازه گیری می شود.

طولانی ترین مسابقه

طولانی ترین تطابق ادعا

نمایندگی JSON
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
زمینه های
durationSecs

string

مدت زمان طولانی‌ترین تطابق بین مرجع و ویدیوی کاربر.

userVideoOffset

string

تغییر در چند ثانیه به ویدیوی کاربر که طولانی‌ترین مسابقه در آن شروع شد.

referenceOffset

string

آفست در چند ثانیه به مرجعی که طولانی ترین مسابقه در آن شروع شد.

TotalMatch

تطابق کل ادعا.

نمایندگی JSON
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
زمینه های
userVideoDurationSecs

string

مقدار کل محتوای ویدیوی کاربر که با مرجع در چند ثانیه مطابقت دارد.

referenceDurationSecs

string

مقدار کل محتوای مرجع که با ویدیوی کاربر در چند ثانیه مطابقت دارد.

مواد و روش ها

get

یک ادعای خاص را با شناسه بازیابی می کند.

insert

ادعایی ایجاد می کند.

list

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

patch

یک ادعای موجود را با تغییر خط‌مشی یا وضعیت آن اصلاح می‌کند.

update

یک ادعای موجود را با تغییر خط‌مشی یا وضعیت آن به‌روزرسانی می‌کند.