REST Resource: claims

منبع: ادعا

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

نمایش 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

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

مقادیر قابل قبول عبارتند از:

  • audio
  • audiovisual
  • video
ugcType

string

نوع ادعا از نوع UGC.

مقادیر قابل قبول عبارتند از:

  • premium
  • song
  • standard
isPartnerUploaded

boolean

نشان می‌دهد که آیا این ادعا، ادعای آپلود شده توسط شریک است یا خیر.

timeStatusLastModified

string

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

blockOutsideOwnership

boolean

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

status

string

وضعیت ادعا.

مقادیر قابل قبول عبارتند از:

  • active - ادعا فعال است و سیاست‌ها در حال اعمال هستند.
  • appealed - کاربر به اختلاف رد شده اعتراض کرده است.
  • disputed - کاربر این ادعا را مورد اختلاف قرار داده است.
  • inactive - ادعا غیرفعال است.
  • manual_review - ادعا توسط سیاست به بررسی دستی هدایت می‌شود.
  • pending - ادعا در انتظار بررسی یا پردازش است.
  • potential - ادعا یک تطابق بالقوه است که در انتظار تأیید است.
  • takedown - ویدیوی مورد ادعا حذف شده است.

هنگام به‌روزرسانی یک ادعا، می‌توانید وضعیت آن را از active به inactive به‌روزرسانی کنید تا ادعا به‌طور مؤثر منتشر شود. اگر صاحب محتوا مجوزهای لازم را داشته باشد، API همچنین از به‌روزرسانی وضعیت از inactive (هنگام بازگرداندن یک ادعا بدون مشکلات استودیو) یا potential (هنگام تأیید یک ادعای بالقوه) به active پشتیبانی می‌کند. ادعاهای مورد اختلاف را نمی‌توان از طریق API بازگرداند؛ آنها نیاز به بررسی در YouTube Studio دارند.

appliedPolicy

object ( Policy )

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

id

string

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

assetId

string

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

videoId

string

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

origin

object ( Origin )

matchInfo

object ( MatchInfo )

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

studioInfo

object ( StudioInfo )

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

مبدا

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

نمایش JSON 
{
  "source": string
}
فیلدها
source

string

منبع ادعا. مقادیر قابل قبول عبارتند از:

  • audioMatch - آهنگ صوتی ویدیوی ادعا شده با مرجع شناسه محتوا مطابقت داشت.
  • audioSwap - یک آهنگ در برنامه AudioSwap به ویدیوی مورد ادعا منتقل شده است.
  • batchTool - این ادعا از یک عملیات انبوه ایجاد شده است.
  • cmsUpload - این ادعا از طریق SFTP یا آپلود استودیو ایجاد شده است.
  • contentIdApi - این ادعا با استفاده از API شناسه محتوا ایجاد شده است.
  • cvpSearch - این ادعا از طریق صفحه جستجو در ابزار برنامه تأیید محتوا (Content Verification Program) مطرح شده است.
  • descriptiveSearch - محتوا از طریق صفحه ادعای دستی در YouTube Studio ادعا شده است.
  • external - ادعا توسط ابزارهای خارجی ایجاد شده است.
  • gameId - ویدیو با سیستم شناسه بازی مطابقت داشت.
  • googleDevId - این ادعا توسط یک توسعه‌دهنده گوگل ایجاد شده است.
  • hashcode - این ادعا از طریق تطبیق هش MD5 ایجاد شده است.
  • inProductShorts - شورت یا ادعای همگام‌سازی.
  • inProductStudio - ادعای مجوز به صورت دستی در YouTube Studio اعلام شد.
  • melodyMatch - این ادعا از یک تطبیق ملودی ایجاد شده است.
  • syntheticVocal - این ادعا از ادعای تطابق دارایی صوتی سرچشمه گرفته است.
  • videoMatch - آهنگ ویدیویی ادعایی با مرجع شناسه محتوا مطابقت داشت.
  • youTubeAdmin - این ادعا توسط یکی از مدیران یوتیوب ایجاد شده است.

اطلاعات تطبیق

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

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

object ( MatchSegment )

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

referenceId

string

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

longestMatch

object ( LongestMatch )

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

totalMatch

object ( TotalMatch )

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

بخش تطبیق

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

نمایش 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

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

مقادیر قابل قبول عبارتند از:

  • Audio
  • Melody
  • Video
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 است.

بخش ۲

این منبع، یک قطعه کد ساده دیگر را نشان می‌دهد که زمان شروع و پایان آن به صورت رشته‌ای با فرمت "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

انحراف (به ثانیه) نسبت به مرجعی که طولانی‌ترین مسابقه از آن شروع شده است.

توتال مچ

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

نمایش JSON 
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
فیلدها
userVideoDurationSecs

string

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

referenceDurationSecs

string

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

روش‌ها

get

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

insert

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

list

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

patch

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

update

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