REST Resource: references

المرجع: مرجع

يمثّل المرجع المحتوى الفعلي لمادة عرض. يقارن YouTube الفيديوهات التي تم تحميلها مؤخرًا بمكتبة من المراجع بهدف إنشاء مطالبات تلقائيًا لمالكي مادة العرض.

تمثيل JSON
{
  "kind": string,
  "status": string,
  "statusReason": string,
  "length": number,
  "hashCode": string,
  "urgent": boolean,
  "fpDirect": boolean,
  "contentType": string,
  "audioswapEnabled": boolean,
  "ignoreFpMatch": boolean,
  "origination": {
    object (Origination)
  },
  "excludedIntervals": [
    {
      object (ExcludedInterval)
    }
  ],
  "id": string,
  "assetId": string,
  "duplicateLeader": string,
  "claimId": string,
  "videoId": string
}
الحقول
kind

string

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

status

string

حالة المرجع

statusReason

string

توضّح هذه السمة طريقة دخول المرجع إلى حالته الحالية. لا تتوفّر هذه القيمة إلا إذا كانت حالة المرجع هي inactive أو deleted.

length

number

مدّة المرجع بالثواني.

hashCode

string

رمز التجزئة MD5 لمحتوى المرجع. تم إيقاف العمل بها. لم تعُد تتم تعبئة هذا الحقل.

urgent

boolean

اضبط هذه القيمة على true للإشارة إلى أنّه يجب على YouTube منح YouTube الأولوية لمعالجة ملف الفيديو بواسطة Content ID. تجدر الإشارة إلى أن YouTube يعالج ملفات الفيديو الطارئة قبل الملفات الأخرى التي لم يتم وضع علامة عليها كطارئة. ويُستخدم هذا الإعداد بشكل أساسي لمقاطع الفيديو التي تعرض أحداثًا مباشرة أو غيرها من مقاطع الفيديو التي تتطلب معالجة حسب الوقت. كلما أكمل YouTube معالجة الفيديو في أسرع وقت ممكن عبر Content ID، تمكّن YouTube من مطابقة الفيديوهات التي يحمّلها المستخدم مع ذلك الفيديو في وقت أسرع.

يُرجى العِلم أنّ وضع علامة "عاجلة" على كل ملفاتك قد يؤدي إلى تأخير معالجة هذه الملفات.

fpDirect

boolean

عند تحميل مرجع، اضبط هذه القيمة على true للإشارة إلى أنّ المرجع تم إنشاؤه مسبقًا.

contentType

string

تمثّل هذه السمة نوع المحتوى الذي يمثّله المرجع.

audioswapEnabled

boolean

اضبط قيمة هذا الحقل على true للإشارة إلى ضرورة تضمين محتوى المرجع في برنامج تغيير الصوت على YouTube.

ignoreFpMatch

boolean

اضبط هذه القيمة على true للإشارة إلى أنّه يجب عدم استخدام المرجع لإنشاء مطالبات. يُستخدم هذا الحقل فقط في مراجع تغيير الصوت.

origination

object (Origination)

يحتوي العنصر origination على معلومات تصف مصدر المرجع.

excludedIntervals[]

object (ExcludedInterval)

قائمة الفواصل الزمنية من هذا المرجع والتي سيتم تجاهلها أثناء عملية المطابقة.

id

string

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

assetId

string

المعرّف الذي يعرّف بشكل فريد مادة العرض المرتبطة بالمرجع

duplicateLeader

string

المعرّف الذي يعرّف بشكلٍ فريد المرجع الذي تكراره هذا المرجع لا يتوفّر هذا الحقل إلا إذا كانت حالة المرجع هي inactive والسبب REASON_DUPLICATE_FOR_OWNERS.

claimId

string

يظهر هذا الحقل إذا تمّ إنشاء المرجع عبر ربط مادة عرض بفيديو YouTube حالي تمّ تحميله إلى قناة YouTube مرتبطة بحسابك في نظام إدارة المحتوى. في هذه الحالة، يحتوي هذا الحقل على معرّف المطالبة الذي يمثّل الارتباط الناتج بين مادة العرض والفيديو.

videoId

string

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

ExcludedInterval

تحدّد هذه السمة فترة زمنية داخل المرجع سيتم تجاهلها أثناء عملية المطابقة.

تمثيل JSON
{
  "low": number,
  "high": number,
  "origin": string,
  "timeCreated": string
}
الحقول
low

number

وقت البدء (شاملاً) بالثواني من الفترة الزمنية يمكن أن تكون القيمة أي قيمة بين 0 وhigh. يجب أن يحدد كل فاصل قيمة لهذا الحقل.

high

number

وقت الانتهاء (شامل) بالثواني من الفترة الزمنية. يمكن أن تكون القيمة أي قيمة أكبر من low. إذا كانت قيمة high أكبر من طول المرجع، سيتم استبعاد الفاصل الزمني بين low ونهايته. يجب أن يحدد كل فاصل قيمة لهذا الحقل.

origin

string

مصدر الطلب لاستبعاد الفاصل الزمني من مطابقة Content ID

timeCreated

string

تاريخ ووقت إنشاء الاستثناء. يتم تحديد القيمة بتنسيق RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).

الطُرق

get

لاسترداد معلومات عن المرجع المحدد.

insert

تنشئ مرجعًا بإحدى الطرق التالية:
  • إذا كان طلبك يحمّل ملفًا مرجعيًا، ينشئ YouTube المرجع من المحتوى المقدَّم.

list

لاسترداد قائمة المراجع حسب رقم التعريف أو قائمة المراجع لمادة العرض المحددة.

patch

تصحيح مرجع

update

لتعديل مرجع