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

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