REST Resource: assets

المرجع: مادة العرض

يمثّل المورد asset جزءًا من حقوق الملكية الفكرية، مثل تسجيل صوتي أو حلقة تلفزيونية.

تمثيل JSON
{
  "kind": string,
  "type": string,
  "status": string,
  "metadata": {
    object (Metadata)
  },
  "ownership": {
    object (RightsOwnership)
  },
  "matchPolicy": {
    object (AssetMatchPolicy)
  },
  "timeCreated": string,
  "metadataMine": {
    object (Metadata)
  },
  "metadataEffective": {
    object (Metadata)
  },
  "ownershipMine": {
    object (RightsOwnership)
  },
  "ownershipEffective": {
    object (RightsOwnership)
  },
  "matchPolicyMine": {
    object (AssetMatchPolicy)
  },
  "matchPolicyEffective": {
    object (AssetMatchPolicy)
  },
  "ownershipConflicts": {
    object (OwnershipConflicts)
  },
  "id": string,
  "aliasId": [
    string
  ],
  "label": [
    string
  ],
  "licensability": {
    object (AssetLicensability)
  },
  "nWayRevenueSharing": {
    object (NWayRevenueSharing)
  }
}
الحقول
kind

string

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

type

string

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

في ما يلي القيم الصالحة لهذه السمة:

  • art_track_video

  • composition

  • episode

  • general

  • movie

  • music_video

  • season

  • show

  • sound_recording

  • video_game

  • web

status

string

حالة مادة العرض

metadata

object (Metadata)

يتضمن العنصر metadata معلومات تحدد مادة العرض وتقدّم وصفًا لها. ويمكن استخدام هذه المعلومات للبحث عن مادة العرض أو لإزالة التكرار ضمن قاعدة بيانات YouTube.

ownership

object (RightsOwnership)

يحدد الكائن ownership مالكي مادة العرض ويقدم تفاصيل إضافية حول ملكيتهم، مثل المناطق التي يملكون فيها مادة العرض.

matchPolicy

object (AssetMatchPolicy)

يحتوي العنصر matchPolicy على معلومات حول سياسة مطابقة مادة العرض التي يطبّقها YouTube على الفيديوهات التي يحمّلها المستخدمون والتي تتطابق مع مادة العرض.

timeCreated

string

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

metadataMine

object (Metadata)

metadataEffective

object (Metadata)

ownershipMine

object (RightsOwnership)

ownershipEffective

object (RightsOwnership)

matchPolicyMine

object (AssetMatchPolicy)

matchPolicyEffective

object (AssetMatchPolicy)

ownershipConflicts

object (OwnershipConflicts)

يحتوي العنصر ownershipConflicts على معلومات حول التعارضات بشأن ملكية مادة العرض.

id

string

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

aliasId[]

string

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

label[]

string

قائمة بتصنيفات مواد العرض

licensability

object (AssetLicensability)

معلومات حول ترخيص مواد العرض

nWayRevenueSharing

object (NWayRevenueSharing)

معلومات مشاركة الأرباح (Pangea)

OwnershipConflicts

يشير المورد ownershipConflicts إلى معلومات حول الملكية المتعارضة لمادة العرض.

تمثيل JSON
{
  "general": [
    {
      object (TerritoryConflicts)
    }
  ],
  "performance": [
    {
      object (TerritoryConflicts)
    }
  ],
  "synchronization": [
    {
      object (TerritoryConflicts)
    }
  ],
  "mechanical": [
    {
      object (TerritoryConflicts)
    }
  ],
  "kind": string
}
الحقول
general[]

object (TerritoryConflicts)

قائمة تحدد التعارضات بشأن حقوق ملكية مادة عرض والمناطق التي يتم فيها إدراج ملكية مادة عرض متضاربة.

performance[]

object (TerritoryConflicts)

قائمة تحدد التعارضات في حقوق ملكية مادة عرض مقطوعة موسيقية والمناطق التي يتم فيها إدراج الملكية المتعارضة.

synchronization[]

object (TerritoryConflicts)

قائمة تحدد التعارضات في حقوق ملكية مادة عرض المقطوعة الموسيقية والمناطق التي يتم فيها إدراج الملكية المتعارضة.

mechanical[]

object (TerritoryConflicts)

قائمة تحدد التعارضات في حقوق الملكية الميكانيكية لمادة عرض مقطوعة موسيقية والمناطق التي يتم فيها إدراج ملكية متعارضة

kind

string

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

TerritoryConflicts

طريقة للبحث عن إرهاب يتضمّن نزاعات على حقوق الملكية.

تمثيل JSON
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
الحقول
territory

string

المناطق التي تنشأ فيها التعارضات بشأن حقوق الملكية تكون المنطقة عبارة عن رمز بلد مكوّن من حرفَين وفقًا لمعيار ISO 3166.

conflictingOwnership[]

object (ConflictingOwnership)

قائمة بالملكية المتعارضة

ConflictingOwnership

يمثل هذا القسم معلومات حول إحدى الملكيات المتنازع عليها.

تمثيل JSON
{
  "ratio": number,
  "owner": string
}
الحقول
ratio

number

النسبة المئوية لمادة العرض التي يتحكّم بها المالك أو يديرها.

owner

string

رقم تعريف مالك مادة العرض المتنازع عليها

AssetLicensability

معلومات حول ترخيص مواد العرض

تمثيل JSON
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
الحقول
licensable

boolean

ما إذا كانت مادة العرض التي تمت تسويتها قابلة للترخيص

licensabilityState

string

تشير هذه السمة إلى حالة قابلية ترخيص مادة العرض.

unlicensableReason[]

string

تمثّل هذه السمة السبب الذي يجعل مادة العرض غير قابلة للترخيص.

NWayRevenueSharing

حصة الأرباح من مواد عرض المعلومات

تمثيل JSON
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
الحقول
status

string

حالة مشاركة الأرباح على مستوى قنوات متعددة

eligibleTerritories[]

string

يتم تمثيل كل بلد برمز البلد المكوّن من حرفين وفقًا لمعيار ISO (ISO 3166-1 alpha-2).

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

معلومات حول المناطق التي تكون فيها مادة العرض غير مؤهَّلة لمشاركة الأرباح مع مصادر متعددة

TerritoriesIneligibleForNWayRevenueSharing

معلومات حول المناطق التي تكون فيها مادة العرض غير مؤهّلة لمشاركة الأرباح من مصادر متعددة

تمثيل JSON
{
  "reason": string,
  "territories": [
    string
  ]
}
الحقول
reason

string

سبب عدم الأهلية للمواضيع المدرَجة أدناه:

territories[]

string

يتم تمثيل كل بلد برمز البلد المكوّن من حرفين وفقًا لمعيار ISO (ISO 3166-1 alpha-2).

الطُرق

get

لاسترداد البيانات الوصفية لمادة العرض المحددة.

insert

تدرج مادة عرض تضم البيانات الوصفية المحددة.

list

لاسترداد قائمة بمواد العرض استنادًا إلى البيانات الوصفية لمادة العرض.

patch

لتصحيح البيانات الوصفية لمادة العرض المحددة.

update

لتعديل البيانات الوصفية لمادة العرض المحددة.