المرجع: مطالبة
تربط السمة 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 |
إجمالي مقدار المحتوى في المرجع والذي تطابق فيديو المستخدم بالثواني. |
الطُرق |
|
---|---|
|
لاسترداد مطالبة محددة باستخدام المعرّف |
|
ينشئ مطالبة. |
|
لاسترداد قائمة بالمطالبات التي يديرها مالك المحتوى والمرتبط بالمستخدم الذي تمت مصادقته حاليًا. |
|
يمكنك تصحيح مطالبة حالية من خلال تغيير سياستها أو حالتها. |
|
تعديل مطالبة حالية إما من خلال تغيير سياستها أو حالتها |