المرجع: مطالبة
تربط السمة claim
فيديو حمّله شريك أو مستخدم بمادة عرض مطابقة له. تحدد المطالبة ما إذا كان الفيديو يتطابق مع المحتوى الصوتي أو المرئي أو المكونات الصوتية المرئية (الصوتية والفيديو) لمادة العرض. وتحدّد المطالبة أيضًا السياسة التي يريد مالك الحقوق تطبيقها من قِبل YouTube على الفيديو الذي تمّت المطالبة بملكيته.
تمثيل JSON |
---|
{ "kind": string, "policy": { object ( |
الحقول | |
---|---|
kind |
نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى |
policy |
السياسة التي قدّمها المالك المشاهد في المطالبة. |
timeCreated |
وقت إنشاء المطالبة |
contentType |
تحدّد هذه القيمة ما إذا كانت المطالبة تشمل الجزء الصوتي أو الفيديو أو الجزء الصوتي المرئي من المحتوى الذي تمّت المطالبة بملكيته. |
ugcType |
نوع المطالبة الذي أنشأه المستخدم (عادية أو مدفوعة أو أغنية) |
isPartnerUploaded |
يشير العمود إلى ما إذا كانت المطالبة حمّلها الشريك أم لا. |
timeStatusLastModified |
الوقت الذي تم فيه إجراء آخر تعديل على حالة المطالبة و/أو تفاصيل الحالة |
blockOutsideOwnership |
تحدّد هذه العلامة ما إذا كان يجب حظر الفيديو الذي تمّت المطالبة بملكيته في أي مكان لا يملكه بشكل صريح. |
status |
حالة المطالبة عند تعديل مطالبة، يمكنك تعديل حالتها من |
appliedPolicy |
السياسة المطبَّقة على المالك الذي يشاهد المطالبة. قد تختلف هذه السياسات عن سياسة المطالبة النهائية المتعلّقة بالفيديو لأنّها لا تستند إلى سياسة الشركاء الآخرين التي تطبّق المطالبة نفسها. |
id |
هذا المستند، وهو المعرّف الذي يعيّنه YouTube ويستخدمه لتحديد المطالبة بشكل فريد. |
assetId |
رقم التعريف الفريد لمادة العرض على YouTube الذي يحدّد مادة العرض المرتبطة بالمطالبة. |
videoId |
معرّف الفيديو الفريد على YouTube الذي يحدّد الفيديو المرتبط بالمطالبة |
origin |
|
matchInfo |
إذا تم إنشاء هذه المطالبة تلقائيًا استنادًا إلى مرجع مقدّم، سيقدّم هذا القسم تفاصيل حول المطابقة التي أدت إلى إنشاء المطالبة. |
studioInfo |
يحتوي على عناوين URL تؤدي إلى صفحات ذات صلة بالمطالبات في "استوديو YouTube". |
الأصل
يحتوي هذا الكائن على معلومات تصف مصدر البيانات الوصفية أو بيانات الملكية.
تمثيل JSON |
---|
{ "source": string } |
الحقول | |
---|---|
source |
|
MatchInfo
مطابقة المعلومات حول المطالبة.
تمثيل JSON |
---|
{ "matchSegments": [ { object ( |
الحقول | |
---|---|
matchSegments[] |
تفاصيل حول كل شريحة مطابقة. يحتوي كل عنصر في القائمة على معلومات عن شريحة مطابقة واحدة مرتبطة بالمطالبة. من الممكن أن يكون لديك عدة شرائح جمهور مطابقة. على سبيل المثال، إذا تطابق محتوى الصوت والفيديو لفيديو مرجعي مع محتوى فيديو مرجعي، سيتم عرض شريحتين مطابقتين. قد يصف أحد الأقسام مطابقة الصوت وتصف شريحة أخرى مطابقة الفيديو. |
referenceId |
رقم تعريف المرجع الذي أنشأ هذه المطابقة |
longestMatch |
تفاصيل أطول تطابق بين المرجع وفيديو المستخدم |
totalMatch |
تفاصيل إجمالي قدر المرجع ومحتوى فيديو المستخدم المتطابق مع بعضهما البعض. لاحظ أن هاتين القيمتين قد تختلفان إذا احتوى المرجع أو فيديو المستخدم على تكرار. |
MatchSegment
معلومات حول شريحة مطابقة واحدة في مطالبة.
تمثيل JSON |
---|
{ "video_segment": { object ( |
الحقول | |
---|---|
video_segment |
يحتوي العنصر |
reference_segment |
يحتوي الكائن |
channel |
تحدّد هذه العلامة الطريقة التي يتطابق بها الفيديو المرجعي مع الفيديو المرجعي. |
manual_segment |
عند إدراج المطالبات يدويًا، يحتوي العنصر |
تقسيم
يمثل هذا المورد مقطعًا بسيطًا بوقت البدء والانتهاء بتنسيق سلسلة "hh:mm:ss.mmm".
تمثيل JSON |
---|
{ "start": string, "duration": string, "kind": string } |
الحقول | |
---|---|
start |
وقت بدء المقطع، ويتم قياسه بالمللي ثانية من البداية. |
duration |
مدة المقطع بالمللي ثانية. |
kind |
نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى موارد الشريحة، تكون القيمة هي |
Segment2
يمثل هذا المورد مقطعًا بسيطًا آخر له وقت البدء والانتهاء منسق كسلسلة "hh:mm:ss.mmm".
تمثيل JSON |
---|
{ "start": string, "kind": string, "finish": string } |
الحقول | |
---|---|
start |
وقت بدء المقطع، ويتم قياسه بالمللي ثانية من البداية. |
kind |
نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى موارد الشريحة، تكون القيمة هي |
finish |
وقت انتهاء المقطع، بالمللي ثانية من البداية. |
LongestMatch
أطول تطابق مطالبة
تمثيل JSON |
---|
{ "durationSecs": string, "userVideoOffset": string, "referenceOffset": string } |
الحقول | |
---|---|
durationSecs |
مدة أطول تطابق بين المرجع وفيديو المستخدم |
userVideoOffset |
الإزاحة بالثواني في فيديو المستخدم الذي بدأت عنده أطول تطابق |
referenceOffset |
الإزاحة بالثواني في المرجع الذي بدأت عنده أطول تطابق |
TotalMatch
إجمالي المطالبات المطابقة
تمثيل JSON |
---|
{ "userVideoDurationSecs": string, "referenceDurationSecs": string } |
الحقول | |
---|---|
userVideoDurationSecs |
إجمالي حجم المحتوى في فيديو المستخدم الذي تطابق مع المرجع بالثواني |
referenceDurationSecs |
إجمالي حجم المحتوى في المرجع الذي تطابق مع فيديو المستخدم بالثواني |
الطُرق |
|
---|---|
|
استرداد مطالبة معيّنة بواسطة رقم التعريف |
|
إنشاء مطالبة |
|
لاسترداد قائمة بالمطالبات التي يديرها مالك المحتوى والمرتبطة بالمستخدم الذي تمت مصادقته حاليًا. |
|
تصحيح مطالبة حالية إما بتغيير سياستها أو حالتها |
|
لتعديل مطالبة حالية، إما من خلال تغيير سياستها أو حالتها |