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

نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى claim مورد، تبلغ هذه القيمة youtubePartner#claim.

policy

object (Policy)

السياسة التي قدّمها المالك المشاهد في المطالبة.

timeCreated

string

وقت إنشاء المطالبة

contentType

string

تحدّد هذه القيمة ما إذا كانت المطالبة تشمل الجزء الصوتي أو الفيديو أو الجزء الصوتي المرئي من المحتوى الذي تمّت المطالبة بملكيته.

ugcType

string

نوع المطالبة الذي أنشأه المستخدم (عادية أو مدفوعة أو أغنية)

isPartnerUploaded

boolean

يشير العمود إلى ما إذا كانت المطالبة حمّلها الشريك أم لا.

timeStatusLastModified

string

الوقت الذي تم فيه إجراء آخر تعديل على حالة المطالبة و/أو تفاصيل الحالة

blockOutsideOwnership

boolean

تحدّد هذه العلامة ما إذا كان يجب حظر الفيديو الذي تمّت المطالبة بملكيته في أي مكان لا يملكه بشكل صريح.

status

string

حالة المطالبة عند تعديل مطالبة، يمكنك تعديل حالتها من active إلى inactive ليتم سحب المطالبة بشكل فعّال، ولكن لا تتيح واجهة برمجة التطبيقات إجراء تعديلات أخرى على حالة المطالبة.

appliedPolicy

object (Policy)

السياسة المطبَّقة على المالك الذي يشاهد المطالبة. قد تختلف هذه السياسات عن سياسة المطالبة النهائية المتعلّقة بالفيديو لأنّها لا تستند إلى سياسة الشركاء الآخرين التي تطبّق المطالبة نفسها.

id

string

هذا المستند، وهو المعرّف الذي يعيّنه YouTube ويستخدمه لتحديد المطالبة بشكل فريد.

assetId

string

رقم التعريف الفريد لمادة العرض على YouTube الذي يحدّد مادة العرض المرتبطة بالمطالبة.

videoId

string

معرّف الفيديو الفريد على YouTube الذي يحدّد الفيديو المرتبط بالمطالبة

origin

object (Origin)

matchInfo

object (MatchInfo)

إذا تم إنشاء هذه المطالبة تلقائيًا استنادًا إلى مرجع مقدّم، سيقدّم هذا القسم تفاصيل حول المطابقة التي أدت إلى إنشاء المطالبة.

studioInfo

object (StudioInfo)

يحتوي على عناوين URL تؤدي إلى صفحات ذات صلة بالمطالبات في "استوديو YouTube".

الأصل

يحتوي هذا الكائن على معلومات تصف مصدر البيانات الوصفية أو بيانات الملكية.

تمثيل 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

نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى موارد الشريحة، تكون القيمة هي youtubePartner#segment.

Segment2

يمثل هذا المورد مقطعًا بسيطًا آخر له وقت البدء والانتهاء منسق كسلسلة "hh:mm:ss.mmm".

تمثيل JSON
{
  "start": string,
  "kind": string,
  "finish": string
}
الحقول
start

string

وقت بدء المقطع، ويتم قياسه بالمللي ثانية من البداية.

kind

string

نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى موارد الشريحة، تكون القيمة هي youtubePartner#segment.

finish

string

وقت انتهاء المقطع، بالمللي ثانية من البداية.

LongestMatch

أطول تطابق مطالبة

تمثيل 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

لتعديل مطالبة حالية، إما من خلال تغيير سياستها أو حالتها